Beiträge

Beiträge auflisten

Listet die Beiträge der für das Token erreichbaren Betriebe auf, neueste zuerst, filterbar nach Betrieb, Status, Zeitraum und Autor, seitenweise.

GEThttps://api.sofia-post.com/api/v1/posts

Beiträge auflisten

Listet die Beiträge der für das Token erreichbaren Betriebe auf, neueste zuerst, filterbar nach Betrieb, Status, Zeitraum und Autor, seitenweise.

Autorisierungen

Authorizationstringerforderlich

Ihr persönlicher Schlüssel oder OAuth-Access-Token, gesendet als Bearer <token>.

Nur in diesem Tab gespeichert und nur an api.sofia-post.com gesendet. API-Schlüssel erhalten

Abfrageparameter

establishmentIdstring

Nur die Beiträge dieses Betriebs.

cursorstring

Der nextCursor der vorherigen Seite.

statusstring

Live: mindestens ein Netzwerk in diesem Zustand. Der status des Beitrags fasst seine Netzwerke zusammen, ein Filter auf failed kann also partial liefern.

fromstring<date-time>

Live: mindestens ein Netzwerk ab diesem Zeitpunkt veröffentlicht (oder vor der Veröffentlichung geplant).

tostring<date-time>

Live: und vor diesem Zeitpunkt (ausgeschlossen).

createdBystring

Live: me für die Beiträge der Person, für die das Token handelt, app für die dieser Anwendung. Fehlt der Wert: alle.

limitnumber

Seitengröße von 1 bis 100 (Standard 20).

Beiträge auflisten

curl -X GET 'https://api.sofia-post.com/api/v1/posts' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "id": "string",
      "status": "published",
      "establishmentId": "string",
      "scheduledAt": "2026-11-02T10:00:00.000Z",
      "createdAt": "2026-11-02T10:00:00.000Z",
      "targets": [
        {
          "platform": "instagram",
          "accountId": "string",
          "state": "published",
          "permalink": "https://www.instagram.com/p/C1"
        }
      ]
    }
  ]
}

Beiträge auflisten

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/posts' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "id": "string",
      "status": "published",
      "establishmentId": "string",
      "scheduledAt": "2026-11-02T10:00:00.000Z",
      "createdAt": "2026-11-02T10:00:00.000Z",
      "targets": [
        {
          "platform": "instagram",
          "accountId": "string",
          "state": "published",
          "permalink": "https://www.instagram.com/p/C1"
        }
      ]
    }
  ]
}

GET /v1/posts listet alle für das Token zugänglichen Beiträge auf, die neuesten zuerst, gefiltert nach establishmentId, status, from, to und createdBy (me oder app). Ein Beitrag entspricht status, wenn mindestens eines seiner Netzwerke in diesem Zustand ist. Siehe die Paginierung.

Die möglichen Zustände eines Beitrags stehen auf der Seite Einen Beitrag lesen.

Autorisierungen

Authorizationstringheadererforderlich
Ihr persönlicher Schlüssel oder OAuth-Access-Token, gesendet als Bearer <token>.

Abfrageparameter

establishmentIdstring
Nur die Beiträge dieses Betriebs.
cursorstring
Der nextCursor der vorherigen Seite.
statusstring
Live: mindestens ein Netzwerk in diesem Zustand. Der status des Beitrags fasst seine Netzwerke zusammen, ein Filter auf failed kann also partial liefern.
Zulässige Werte: draftscheduledpublishingpublishedsent_to_inboxfailed
fromstring<date-time>
Live: mindestens ein Netzwerk ab diesem Zeitpunkt veröffentlicht (oder vor der Veröffentlichung geplant).
tostring<date-time>
Live: und vor diesem Zeitpunkt (ausgeschlossen).
createdBystring
Live: me für die Beiträge der Person, für die das Token handelt, app für die dieser Anwendung. Fehlt der Wert: alle.
Zulässige Werte: meapp
limitnumber
Seitengröße von 1 bis 100 (Standard 20).

Antwort

Eine Seite Beiträge, mit nextCursor, wenn weitere folgen.

dataobject[]erforderlich
Die Beiträge der Seite
Untergeordnete Attribute anzeigen
- idstringerforderlich
  Kennung des Beitrags
- statusstringerforderlich
  Über alle Netzwerke; partial: auf einem veröffentlicht, auf einem anderen fehlgeschlagen
  Zulässige Werte: draftscheduledpublishingpublishedsent_to_inboxfailedpartial
- establishmentIdstringerforderlich
  Betrieb des Beitrags
- createdAtstring<date-time>erforderlich
  Wann der Beitrag erstellt wurde
- targetsobject[]erforderlich
  Ein Eintrag pro Netzwerk und Konto: zwei Konten in einem Netzwerk, zwei Einträge
  Untergeordnete Attribute anzeigen
  - platformstringerforderlich
    Netzwerk des Ziels
  - accountIdstringerforderlich
    Das Konto, das veröffentlicht (GET /v1/establishments/:id/accounts)
  - statestringerforderlich
    Zustand des Ziels in seinem Netzwerk
    Zulässige Werte: draftscheduledpublishingpublishedsent_to_inboxfailed
  - publishedAtstring<date-time>
    Wann das Ziel veröffentlicht wurde
  - permalinkstring
    Link zum veröffentlichten Beitrag im Netzwerk
  - errorstring
    Warum das Netzwerk abgelehnt hat
- scheduledAtstring<date-time>
  Wann der Beitrag zur Veröffentlichung geplant ist
nextCursorstring
Als ?cursor= für die nächste Seite übergeben; am Ende fehlt er

War diese Seite hilfreich?