Push-Webhook

Mit dem Push-Webhook schickt Rankfender jeden Artikel im Moment der Veröffentlichung an eine Adresse Ihrer Website. Adresse, Authentifizierung und zusätzliche Header stellen Sie auf der Karte „Moderne Web-Integration“ im Tab „PUSH (Webhook)“ ein: siehe Moderne Web-Integration.

Wann Rankfender Ihren Endpunkt aufruft

• Bei jeder Veröffentlichung eines Artikels des Projekts: durch Sie unter Inhalt oder durch den Autopiloten, wenn automatisches Veröffentlichen aktiv ist.
• Nur wenn „Enable Webhook“ aktiv und eine Webhook URL gespeichert ist.
• Ist im Projekt zusätzlich WordPress verbunden, gehen die Artikel stattdessen an WordPress.
• Es gibt ein einziges Ereignis: article.published. Änderungen und Löschungen werden nicht gesendet.

Header

Authentifizierung

Die gesendeten Daten

Ein JSON-Body mit dem Artikel auf oberster Ebene und noch einmal unter article, dazu das Projekt unter domain. content ist HTML und wird vor dem Senden bereinigt; ein Artikel mit weniger als 100 Zeichen Inhalt wird nicht gesendet. author ist „Rankfender“, sofern der Artikel keinen Autor hat.

{
  "event": "article.published",
  "title": "…",
  "slug": "…",
  "content": "<h2>…</h2><p>…</p>",
  "excerpt": "…",
  "meta_description": "…",
  "meta_title": "…",
  "keywords": ["…"],
  "featured_image": "https://…",
  "author": "Rankfender",
  "published_at": "2026-10-14T09:12:00.000Z",
  "seo_data": { "title_tag": "…", "meta_keywords": "…", "canonical_url": "" },
  "custom_data": { "article_id": "…", "generated_by": "Rankfender", "word_count": 1850 },
  "article": {
    "id": "…", "title": "…", "slug": "…", "content": "…", "excerpt": "…",
    "meta_description": "…", "featured_image": "https://…", "cover_image_url": "https://…",
    "scheduled_date": null, "published_at": "…", "target_keyword": "…"
  },
  "domain": { "id": "…", "url": "https://your-site.com", "name": "…" }
}

Was Ihr Endpunkt antworten muss

• Jeder Status von 200 bis 299 gilt als zugestellt. Alles andere markiert die Veröffentlichung als fehlgeschlagen, mit „Webhook returned <Status>“ und dem Anfang Ihrer Antwort.
• Optional: antworten Sie mit JSON mit id (oder post_id) und url (oder permalink, external_url). Rankfender speichert die URL als Live-Adresse des Artikels. Ohne sie ist die Adresse Ihre Website-URL plus Slug.
• Speichern Sie den Artikel in Ihrem eigenen CMS oder Ihrer Datenbank: Rankfender speichert auf Ihrer Seite nichts.

HTTP/1.1 200 OK
Content-Type: application/json

{ "id": "123", "url": "https://your-site.com/blog/your-article" }

Testen

„Test Webhook“ sendet einen Beispielartikel mit dem Titel „Rankfender Webhook Test“, mit X-Rankfender-Test: true und custom_data.test auf true, damit Ihr Endpunkt ihn ignorieren kann. Bei Erfolg: „Webhook test successful! Endpoint responded with 2xx.“; nach echten Zustellungen zeigt „Last successful call:“ das Datum.