POpostproxy
Posts

List posts

Retrieves a paginated list of all posts in the current profile group. Thread children are not returned as top-level items — only parent posts appear.

get/api/posts

Request

  • Base URL
    https://api.postproxy.dev
  • URL
    https://api.postproxy.dev/api/posts
  • Auth
    HTTP bearer

Query parameters

profile_group_idstring

Profile group context for the request. Optional when the API key is scoped to a profile group (that group is used automatically); with a full-access key, defaults to the first profile group in the account.

pageinteger

Page number (1-based). Passing 0 returns page 1.

per_pageinteger

Number of items per page.

status'draft' | 'scheduled' | 'published' | 'failed'

Filter by status

platformsstring[]

Array of platforms (e.g., platforms[]=instagram&platforms[]=tiktok)

source'postproxy' | 'imported'

Filter by source: postproxy (created via app or API) or imported (imported from a connected platform)

scheduled_afterstring date-time

ISO 8601 date to filter posts scheduled after that date

Response

Paginated list of posts

totalinteger

Total number of posts

pageinteger

Current page number

per_pageinteger

Items per page

Changes

No recorded changes to this operation across all 1 revision of this API.