REST API

List Posts

Name: AdaptlyPost
Author: AdaptlyPost

Retrieve a paginated list of your posts

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

Returns a paginated list of social media posts ordered by creation date (newest first).

API Key (Bearer token)

Query Parameters

Parameter	Type	Description
`limit`	`number`	Number of posts to return (1-100, default: 20)
`offset`	`number`	Number of posts to skip (default: 0)
`sortOrder`	`string`	Sort order: NEWEST or OLDEST
`statuses`	`PostStatus[]`	Filter by post statuses (e.g. DRAFT, SCHEDULED, COMPLETED)
`platforms`	`PlatformType[]`	Filter by platforms (e.g. TWITTER, LINKEDIN)
`startDate`	`string`	Filter posts created after this date (ISO 8601)
`endDate`	`string`	Filter posts created before this date (ISO 8601)

Post Statuses

Status	Description
`DRAFT`	Saved but not yet published or scheduled
`PENDING`	Queued for immediate publishing
`SCHEDULED`	Scheduled for a future date
`PUBLISHING`	Currently being published to platforms
`COMPLETED`	Successfully published to at least one platform
`FAILED`	Publishing failed on all platforms
`PARTIAL_FAILURE`	Published to some platforms but failed on others

List social posts

curl --request GET \
  --url 'https://api.adaptlypost.com/api/v1/social-posts?limit=10&offset=0' \
  --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"
    }
  ],
  "total": 42,
  "hasMore": true
}

List Posts

Query Parameters

Post Statuses

Company

Legal