Skip to main content
GET
List posts

Authorizations

Authorization
string
header
required

API key authentication. Generate an API key from your workspace settings.

Query Parameters

limit
integer
default:20

Maximum number of posts to return (1-100)

Required range: 1 <= x <= 100
cursor
string<uuid>

Cursor for pagination (post ID from the last item of previous page)

ids

Fetch specific posts by IDs. Can be a single UUID or comma-separated list.

status
enum<string>

Filter by post status

Available options:
Tentative,
ToDo,
InProgress,
ForReview,
Blocked,
Finalized,
Scheduled,
Posted
channel
enum<string>

Filter by channel

Available options:
LinkedIn,
Twitter,
Instagram,
TikTok,
YouTubeShorts
linkedInProfileId
string<uuid>

Filter by LinkedIn profile ID

xProfileId
string<uuid>

Filter by X/Twitter profile ID

instagramProfileId
string<uuid>

Filter by Instagram profile ID

tikTokProfileId
string<uuid>

Filter by TikTok profile ID

youTubeProfileId
string<uuid>

Filter by YouTube channel profile ID

labelIds

Filter by label IDs (posts with any of these labels). Can be a single UUID or comma-separated list.

publishDateMin
string<date-time>

Filter posts scheduled on or after this date (ISO 8601 format)

publishDateMax
string<date-time>

Filter posts scheduled on or before this date (ISO 8601 format)

createdAtMin
string<date-time>

Filter posts created on or after this date (ISO 8601 format)

createdAtMax
string<date-time>

Filter posts created on or before this date (ISO 8601 format)

sortBy
enum<string>
default:createdAt

Field to sort by

Available options:
createdAt,
publishAt
sortOrder
enum<string>
default:desc

Sort order

Available options:
asc,
desc

Response

List of posts

posts
object[]
nextCursor
string | null

Cursor for the next page of results

hasMore
boolean

Whether there are more results