Skip to main content

Cursor-based pagination

All list endpoints return paginated results. To page through them, use the cursor returned in the previous response.
# First page
GET /v1/inbox/comments?limit=25

# Next page (use cursor from previous response)
GET /v1/inbox/comments?limit=25&cursor=eyJpZCI6IjE3ODQx...
When there are no more results, the response will not include a cursor field. This pattern applies to all list endpoints: /v1/inbox/comments, /v1/inbox/conversations, /v1/inbox/reviews, /v1/posts, /v1/media, and others.

Filtering

Most list endpoints support filtering parameters. For example:
# Posts with comments, filtered by account and platform
GET /v1/inbox/comments?account_id=acc_01HZ...&platform=instagram&limit=25

# Published posts, sorted by date
GET /v1/posts?status=published&sort=created_at&order=desc&limit=25
See the API Reference for the full set of query parameters on each endpoint.

Parameters

ParameterTypeDefaultDescription
limitinteger25Results per page. Min 1, max 100.
cursorstring-Opaque pagination cursor from previous response.