Posts

List posts

Returns posts the API key can access, newest first. A post's profiles are the profiles of its target accounts, and a key limited to selected profiles only sees posts whose accounts all sit in profiles it can access. Read-only and read-write API keys are accepted. Published posts include a platformPostId and platformPostUrl for each published platform target. Results are capped to the 1000 most recent matching posts.

get/v1/posts

Request

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

Query parameters

profileIdstring

Return posts that target at least one account in this profile. A post whose accounts span several profiles is listed under each of them.

accountIdstring

Filter posts to those targeting a specific connected account.

platform'twitter' | 'x' | 'instagram' | 'tiktok' | 'linkedin' | 'facebook' | 'youtube' | 'threads' | 'pinterest' | 'bluesky' | 'telegram'

Filter posts to those with a target on this platform. twitter is accepted as an alias for x.

status'draft' | 'scheduled' | 'queued' | 'publishing' | 'published' | 'partially_failed' | 'failed' | 'canceled'

Filter posts by status.

dateFromstring date-time

Only include posts scheduled on or after this ISO 8601 timestamp. Posts without a scheduled time are excluded when a date filter is supplied.

dateTostring date-time

Only include posts scheduled on or before this ISO 8601 timestamp. Posts without a scheduled time are excluded when a date filter is supplied.

sortBy'createdAt' | 'scheduledFor'

Sort order. createdAt sorts by creation time (newest first). scheduledFor sorts by scheduled time (newest first) and excludes posts without a scheduled time.

pageinteger

1-based page number. Defaults to 1.

limitinteger

Page size. Defaults to 20.

Response

Posts returned.

Changes

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