Skip to main content
GET
/
posts
List all posts
curl --request GET \
  --url https://api.social-api.ai/v1/posts \
  --header 'Authorization: <api-key>'
{
  "data": [
    {
      "created_at": "2026-03-14T09:00:00Z",
      "hidden": true,
      "id": "<string>",
      "media_ids": [
        "<string>"
      ],
      "published_at": "2026-04-01T10:00:05Z",
      "retry_count": 123,
      "scheduled_at": "2026-04-01T10:00:00Z",
      "status": "published",
      "targets": [
        {
          "account_id": "<string>",
          "error": {
            "category": "<string>",
            "caused_by": "<string>",
            "message": "<string>"
          },
          "first_comment": "<string>",
          "metrics": {
            "comments": 123,
            "extra": {},
            "likes": 123,
            "saves": 123,
            "shares": 123
          },
          "metrics_synced_at": "<string>",
          "permalink": "<string>",
          "platform": "<string>",
          "platform_post_id": "<string>",
          "published_at": "<string>",
          "scheduled_at": "<string>",
          "status": "<string>",
          "text": "<string>",
          "title": "<string>",
          "visibility": "<string>"
        }
      ],
      "text": "<string>",
      "title": "<string>",
      "updated_at": "2026-03-14T09:00:00Z",
      "visibility": "<string>"
    }
  ],
  "pagination": {
    "has_more": true,
    "limit": 25,
    "next_cursor": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...

Query Parameters

account_ids
string

Comma-separated connected account IDs

status
string

Filter by status (draft, scheduled, publishing, published, partial, failed, cancelled)

platform
string

Filter by platform (e.g. instagram, facebook)

from
string

Start of date range (RFC3339)

to
string

End of date range (RFC3339)

Text search (case-insensitive)

sort
string

Sort order: scheduled_asc (default), scheduled_desc, created_asc, created_desc

cursor
string

Pagination cursor from previous response

limit
integer

Max results (default 25, max 100)

hidden
string

Include hidden posts (true/false, default false)

Response

OK

data
object[]
pagination
object