REST APIGET

Lista postów

Pobierz stronicowaną listę zaplanowanych, opublikowanych i roboczych postów z filtrami według statusu, platformy i zakresu dat.

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

Zwraca listę postów z podziałem na strony, domyślnie od najnowszych. Posty są sortowane według zaplanowanego terminu, a gdy go nie mają, według daty utworzenia.

Klucz API (token Bearer)
Uprawnienie:posts.readRole i uprawnienia

Parametry zapytania

ParametrTypOpis
limitnumberLiczba zwracanych postów (1-100, domyślnie: 20)
offsetnumberLiczba pomijanych postów (domyślnie: 0)
sortOrderstringKolejność sortowania: NEWEST lub OLDEST
statusesPostStatus[]Filtr statusów postów. Klucz należy powtórzyć dla każdej wartości: statuses=SCHEDULED&statuses=COMPLETED. Nieznane parametry zapytania zwracają 400
platformsPlatformType[]Filtr platform, dowolny PlatformType, w tym GOOGLE_BUSINESS, TUMBLR, WORDPRESS i TELEGRAM. Klucz należy powtórzyć dla każdej wartości: platforms=TWITTER&platforms=LINKEDIN
startDatestringTylko posty zaplanowane na tę datę lub później (ISO 8601). Post bez zaplanowanego terminu jest dopasowywany po dacie utworzenia
endDatestringTylko posty zaplanowane na tę datę lub wcześniej (ISO 8601). Post bez zaplanowanego terminu jest dopasowywany po dacie utworzenia

Statusy postów

StatusOpis
DRAFTZapisany, ale jeszcze nieopublikowany ani niezaplanowany
PENDINGW kolejce do natychmiastowej publikacji
SCHEDULEDZaplanowany na przyszły termin
PUBLISHINGW trakcie publikacji na platformach
COMPLETEDOpublikowany na co najmniej jednej platformie
FAILEDPublikacja nie powiodła się na żadnej platformie
PARTIAL_FAILUREOpublikowany na części platform, na pozostałych wystąpił błąd
Lista postów
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
}