REST APIGET

Beiträge auflisten

Rufen Sie eine paginierte Liste Ihrer geplanten, veröffentlichten und Entwurfsbeiträge ab, mit Filtern für Status und Plattform.

GEThttps://post.adaptlypost.com/post/api/v1/social-posts

Gibt eine paginierte Liste von Social-Media-Beiträgen zurück, standardmäßig die neuesten zuerst. Sortiert wird nach der geplanten Zeit, bei Beiträgen ohne Termin nach dem Erstellungszeitpunkt.

API-Schlüssel (Bearer-Token)
Berechtigung:posts.readRollen und Berechtigungen

Abfrageparameter

ParameterTypBeschreibung
limitnumberAnzahl der zurückzugebenden Beiträge (1-100, Standard: 20)
offsetnumberAnzahl der zu überspringenden Beiträge (Standard: 0)
sortOrderstringSortierreihenfolge: NEWEST oder OLDEST
statusesPostStatus[]Nach Beitragsstatus filtern. Schlüssel pro Wert wiederholen: statuses=SCHEDULED&statuses=COMPLETED. Unbekannte Query-Parameter liefern 400
platformsPlatformType[]Nach Plattformen filtern, jeder PlatformType einschließlich GOOGLE_BUSINESS, TUMBLR und TELEGRAM. Schlüssel pro Wert wiederholen: platforms=TWITTER&platforms=LINKEDIN
startDatestringNur Beiträge, die zu oder nach diesem Datum geplant sind (ISO 8601). Ein Beitrag ohne Termin wird nach seinem Erstellungsdatum gefiltert
endDatestringNur Beiträge, die zu oder vor diesem Datum geplant sind (ISO 8601). Ein Beitrag ohne Termin wird nach seinem Erstellungsdatum gefiltert

Beitragsstatus

StatusBeschreibung
DRAFTGespeichert, aber noch nicht veröffentlicht oder geplant
PENDINGZur sofortigen Veröffentlichung in der Warteschlange
SCHEDULEDFür ein zukünftiges Datum geplant
PUBLISHINGWird derzeit auf Plattformen veröffentlicht
COMPLETEDErfolgreich auf mindestens einer Plattform veröffentlicht
FAILEDVeröffentlichung auf allen Plattformen fehlgeschlagen
PARTIAL_FAILUREAuf einigen Plattformen veröffentlicht, auf anderen fehlgeschlagen
Social-Media-Beiträge auflisten
curl --request GET \
  --url 'https://post.adaptlypost.com/post/api/v1/social-posts?limit=10&offset=0&statuses=SCHEDULED&statuses=PUBLISHING&platforms=FACEBOOK&platforms=TIKTOK' \
  --header 'Authorization: Bearer <api-key>'
200
{
  "posts": [
    {
      "id": "post_xyz789",
      "contentType": "TEXT",
      "text": "Hello world!",
      "status": "COMPLETED",
      "scheduledAt": null,
      "timezone": "America/New_York",
      "platforms": [
        {
          "id": "pp_001",
          "platform": "TWITTER",
          "status": "PUBLISHED",
          "accountName": "@yourhandle",
          "publishedAt": "2026-03-14T12:00:00Z"
        }
      ],
      "createdAt": "2026-03-14T11:59:00Z",
      "updatedAt": "2026-03-14T12:00:05Z"
    },
    {
      "id": "post_rec456",
      "contentType": "TEXT",
      "text": "Hello everyone, the weekly product tip is live!",
      "status": "SCHEDULED",
      "scheduledAt": "2026-10-15T13:00:00Z",
      "timezone": "America/New_York",
      "recurringPostId": "rp_abc123",
      "occurrenceAt": "2026-10-15T13:00:00Z",
      "platforms": [
        {
          "id": "pp_002",
          "platform": "LINKEDIN",
          "status": "PENDING",
          "accountName": "Your Company"
        }
      ],
      "createdAt": "2026-10-14T13:00:00Z",
      "updatedAt": "2026-10-14T13:00:00Z"
    }
  ],
  "total": 42,
  "hasMore": true
}