RSS-Feeds

Berechtigung: posts.read. Siehe Rollen und Berechtigungen.

Feeds und ihre Einträge auflisten und abrufen braucht posts.read. Erstellen, Vorschau, Aktualisieren, Pausieren, Fortsetzen, Prüfen und Löschen brauchen posts.draft und dazu die Berechtigung, die der Beitragsmodus des Feeds verlangt: posts.schedule für SCHEDULE, posts.publish für PUBLISH und ai.generate für KI-Texte. Ein Feed, den ein anderes Mitglied eingerichtet hat, braucht zum Aktualisieren, Pausieren, Fortsetzen, Prüfen oder Löschen außerdem posts.others.

Ein Feed wird nach Zeitplan geprüft, und jeder Eintrag, der nach dem Hinzufügen erscheint, wird zu einem Beitrag auf den Konten in targets. Jeder Beitrag durchläuft dieselben Prüfungen wie Beitrag erstellen. Ein Feed postet als das Mitglied, das ihn zuletzt gespeichert hat: Wer einen Feed erstellt, aktualisiert oder fortsetzt, wird mit dem Mitglied des Schlüssels zu seinem Besitzer.

POST /api/v1/rss-feeds

Ruft den Feed ab und merkt sich jeden Eintrag, der schon darin steht, damit nur später erscheinende Einträge gepostet werden. Ein Workspace kann bis zu 20 Feeds haben.

Ziele können FACEBOOK, INSTAGRAM, THREADS, TWITTER, BLUESKY, LINKEDIN, MASTODON, TELEGRAM und GOOGLE_BUSINESS sein.

Beispielanfrage:

{
  "url": "https://blog.example.com/feed.xml",
  "targets": [
    { "platform": "LINKEDIN", "connectionId": "conn_li_001" },
    { "platform": "FACEBOOK", "connectionId": "conn_fb_001", "pageId": "123456789012345" }
  ],
  "postMode": "SCHEDULE",
  "publishDelayMinutes": 30,
  "contentMode": "TEMPLATE",
  "template": "Neu im Blog: {title}\n\n{link}",
  "excludeKeywords": ["sponsored"]
}

Gibt 201 mit dem Feed zurück:

{
  "id": "rss_01j9x",
  "userId": "user_123",
  "accountGroupId": "ag_01j9x",
  "name": "Example Blog",
  "url": "https://blog.example.com/feed.xml",
  "siteUrl": "https://blog.example.com",
  "status": "ACTIVE",
  "postMode": "SCHEDULE",
  "publishDelayMinutes": 30,
  "contentMode": "TEMPLATE",
  "template": "Neu im Blog: {title}\n\n{link}",
  "includeImage": true,
  "twitterKeepLinks": false,
  "includeKeywords": [],
  "excludeKeywords": ["sponsored"],
  "maxPostsPerCheck": 3,
  "checkIntervalMinutes": 60,
  "targets": [
    { "platform": "LINKEDIN", "connectionId": "conn_li_001", "displayName": "Example Inc." },
    { "platform": "FACEBOOK", "connectionId": "conn_fb_001", "pageId": "123456789012345", "displayName": "Example" }
  ],
  "nextCheckAt": "2026-11-08T15:00:00.000Z",
  "createdAt": "2026-11-08T14:00:00.000Z",
  "updatedAt": "2026-11-08T14:00:00.000Z"
}

Eine URL, die kein RSS- oder Atom-Feed ist, ein bereits verbundener Feed, eine nicht unterstützte Zielplattform, ein fehlendes publishDelayMinutes oder die Grenze von 20 Feeds ergibt 400. Ein Feed, der nicht erreichbar ist, ergibt 503. Ein Schlüssel ohne die Berechtigung, die der Beitragsmodus oder die KI-Texte verlangen, ergibt 403.

Feed-Felder

Die übrigen Felder enthalten die Einstellungen von oben.

Beheben Sie die Ursache und setzen Sie den Feed dann fort.

POST /api/v1/rss-feeds/preview

Nimmt url und optional template, ruft den Feed ab, ohne etwas zu speichern, und gibt url, title, siteUrl und die 5 neuesten items zurück, jeweils mit title, link, summary, publishedAt, imageUrl und text, dem mit der Vorlage dargestellten Eintrag.

GET /api/v1/rss-feeds/:id/items

Listet die Einträge auf, die der Feed gesehen hat, neueste zuerst, ohne die, die beim Hinzufügen schon im Feed standen. limit nimmt 1 bis 100, Standard 20. Gibt { "items": [...] } zurück, jeweils mit id, title, link, publishedAt, createdAt, status, postId und error.

Aktualisieren, pausieren, fortsetzen, prüfen und löschen

PATCH nimmt dieselben Felder wie das Erstellen, außer url und postLatestItem, und ändert nur die gesendeten. Pausieren, Fortsetzen, Prüfen und Löschen nehmen keinen Body. Alle außer Löschen geben den Feed zurück; Löschen gibt { "deleted": true } zurück. Eine ID, die nicht existiert oder zu einem anderen Workspace gehört, ergibt 404.