REST APIGET

List Posts

Retrieve a paginated list of your scheduled, published and draft posts, with filters for status, platform and date range.

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

Returns a paginated list of social media posts, newest first by default. Posts are ordered by their scheduled time, or by their creation time when they have none.

API Key (Bearer token)
Permission:posts.readRoles and permissions

Query Parameters

ParameterTypeDescription
limitnumberNumber of posts to return (1-100, default: 20)
offsetnumberNumber of posts to skip (default: 0)
sortOrderstringSort order: NEWEST or OLDEST
statusesPostStatus[]Filter by post statuses. Repeat the key per value: statuses=SCHEDULED&statuses=COMPLETED. Unknown query parameters return 400
platformsPlatformType[]Filter by platforms. Repeat the key per value: platforms=TWITTER&platforms=LINKEDIN
startDatestringOnly posts scheduled at or after this date (ISO 8601). A post without a scheduled time matches on its creation date
endDatestringOnly posts scheduled at or before this date (ISO 8601). A post without a scheduled time matches on its creation date

Post Statuses

StatusDescription
DRAFTSaved but not yet published or scheduled
PENDINGQueued for immediate publishing
SCHEDULEDScheduled for a future date
PUBLISHINGCurrently being published to platforms
COMPLETEDSuccessfully published to at least one platform
FAILEDPublishing failed on all platforms
PARTIAL_FAILUREPublished to some platforms but failed on others
List Social Posts
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
}