List posts

List posts for the active organization visible to the API key.

Request

GET /api/posts

Authorization: Bearer <api_key>

Parameters

platform (query)

Optional platform filter such as x, linkedin, instagram, or youtube.

q (query)

Search term for matching post content or metadata.

limit (query)

Maximum number of posts to return.

offset (query)

Result offset for pagination.

favoriteOnly (query)

When true, return only favorited posts.

groupId (query)

Optional social account group identifier.

accountType (query)

Optional social account type filter.

Examples

curl -X GET "https://api.creagency.ai/api/posts?platform=value&q=value" \
  -H "Authorization: Bearer <api_key>"

Responses

200

Posts listed

401

Missing, invalid, expired, or revoked API key

403

Missing posts:read scope or plan upgrade required