Filter und Paginierung

API-Referenz · Zuletzt aktualisiert am 16.08.2026

Auf dieser Seite

Parameter
Cursor-Seiten abrufen
since: Veröffentlichungszeit filtern
updated_since: neu bei Feedivo
Empfohlenes Abrufmuster

Die Parameter dieser Seite gelten für GET /api/v1/feeds/{uuid}/posts. Die im Feed hinterlegten Plattform-, Hashtag-, Datums- und Medienfilter werden immer zuerst serverseitig angewandt. Abfrageparameter können das Ergebnis nur weiter eingrenzen, nicht erweitern.

Parameter#

Parameter	Vorgabe	Bedeutung
`limit`	`25`	Einträge je Seite; erlaubt sind `1` bis `100`
`cursor`	–	Opaker Zeiger auf die nächste Seite
`since`	–	Posts mit `published_at` ab diesem ISO-8601-Zeitpunkt
`updated_since`	–	Posts, die Feedivo ab diesem ISO-8601-Zeitpunkt erstmals gesehen hat

since und updated_since dürfen gemeinsam verwendet werden. Dann müssen beide Bedingungen erfüllt sein. Ein unlesbarer Zeitwert oder ein limit außerhalb des erlaubten Bereichs antwortet mit 422 invalid_parameter.

Cursor-Seiten abrufen#

Eine erfolgreiche Liste enthält die Paginierung unter meta.pagination:

{
  "data": [{ "id": "…", "platform": "instagram" }],
  "meta": {
    "feed": { "id": "…", "name": "Social Wall" },
    "pagination": {
      "next_cursor": "eyJ…",
      "count": 25
    }
  },
  "errors": []
}

count bezeichnet nur die Anzahl auf der aktuellen Seite. Sende next_cursor unverändert als cursor an den nächsten Aufruf:

GET /api/v1/feeds/{uuid}/posts?limit=100&cursor=eyJ…

Der Cursor ist opak. Nicht dekodieren, verändern, dauerhaft als Beitragskennung speichern oder selbst erzeugen. next_cursor: null markiert das Ende des aktuellen Durchlaufs.

Wichtig

Entferne lokale Posts erst, nachdem alle Seiten bis zu next_cursor: null erfolgreich und vollständig verarbeitet wurden. Ein Verbindungsfehler oder eine fehlerhafte Antwort ist kein leerer Feed.

`since`: Veröffentlichungszeit filtern#

since bezieht sich auf den Zeitpunkt, zu dem der Beitrag auf Instagram, Facebook, Threads, Pinterest oder YouTube veröffentlicht wurde.

GET /api/v1/feeds/{uuid}/posts?since=2026-08-01T00:00:00Z

Dieser Filter eignet sich für fachliche Zeiträume wie „Beiträge dieses Monats“. Als alleiniger Synchronisationsmarker ist er ungeeignet: Ein älterer Post kann erst später von Feedivo erfasst worden sein.

`updated_since`: neu bei Feedivo#

updated_since filtert nach dem Zeitpunkt der ersten Erfassung durch Feedivo.

GET /api/v1/feeds/{uuid}/posts?updated_since=2026-08-16T08:00:00Z

Der Name bedeutet nicht „zuletzt bearbeitet“. Nachträgliche Änderungen an älteren Posts und entfernte Feed-Zuordnungen erfasst nur ein regelmäßiger Vollabgleich ohne diesen Parameter.

Empfohlenes Abrufmuster#

Nutze für schnelle inkrementelle Läufe updated_since.
Speichere das neue Wasserzeichen erst nach der letzten erfolgreichen Seite.
Führe mindestens einmal täglich einen vollständigen Durchlauf ohne Zeitfilter aus.
Ersetze lokale Feed-Zuordnungen erst nach einem erfolgreichen Vollabgleich.

Die vollständige Strategie mit Fehlerfällen beschreibt Einen zuverlässigen Feed-Abgleich entwickeln.

Frage nicht beantwortet? Schreib uns — wir ergänzen die Seite.

Hilfe-Themen