Skip to content

List posts

Get a paginated list of posts for the current organization with optional filters

GET/v1/posts

Query Parameters

social_account_id?string

Filter by social account ID

created_after?string

Filter posts created after this timestamp

Formatdate-time

created_before?string

Filter posts created before this timestamp

Formatdate-time

scheduled_after?string

Filter posts scheduled after this timestamp

Formatdate-time

scheduled_before?string

Filter posts scheduled before this timestamp

Formatdate-time

limit?string

Number of posts per page (1-100)

Default"50"

offset?string

Pagination offset

Default"0"

Response Body

200application/json

400application/json

500application/json

JavaScript

Go

Java

C#

cURL

TypeScript

Python

Swift

fetch(" {
  method: "GET"
})

200400500

{
  "success": true,
  "posts": [\
    {\
      "id": "9dyJS",\
      "orgId": "abc123",\
      "publishedAt": "2019-08-24T14:15:22Z",\
      "scheduledAt": "2019-08-24T14:15:22Z",\
      "isDraft": true,\
      "createdAt": "2019-08-24T14:15:22Z",\
      "socialAccounts": [\
        {\
          "id": "9dyJS",\
          "nickname": "string",\
          "network": "string",\
          "username": "string",\
          "status": "published",\
          "error": null,\
          "platformPostId": "123456789",\
          "publishedAt": "2025-01-15T10:30:00Z"\
        }\
      ],\
      "containers": [\
        {\
          "id": "8xKmL",\
          "content": "string",\
          "media": [\
            {\
              "url": "string",\
              "filename": "string"\
            }\
          ]\
        }\
      ]\
    }\
  ],
  "data": [\
    {\
      "id": "9dyJS",\
      "orgId": "abc123",\
      "publishedAt": "2019-08-24T14:15:22Z",\
      "scheduledAt": "2019-08-24T14:15:22Z",\
      "isDraft": true,\
      "createdAt": "2019-08-24T14:15:22Z",\
      "socialAccounts": [\
        {\
          "id": "9dyJS",\
          "nickname": "string",\
          "network": "string",\
          "username": "string",\
          "status": "published",\
          "error": null,\
          "platformPostId": "123456789",\
          "publishedAt": "2025-01-15T10:30:00Z"\
        }\
      ],\
      "containers": [\
        {\
          "id": "8xKmL",\
          "content": "string",\
          "media": [\
            {\
              "url": "string",\
              "filename": "string"\
            }\
          ]\
        }\
      ]\
    }\
  ],
  "pagination": {
    "limit": 0,
    "offset": 0,
    "total": 0
  }
}
{
  "success": false,
  "error": "Invalid payload",
  "details": {
    "content": {
      "_errors": [\
        "Required"\
      ]
    }
  }
}
{
  "success": false,
  "error": "Internal server error",
  "message": "Database connection failed"
}

Create a post POST\ \ Previous Page Get post details GET\ \ Next Page