Posts

List posts

List posts by creation time (default), or use state=scheduled and sort=scheduledAt to walk a scheduled calendar chronologically. The scheduled cursor remains valid if earlier posts are cancelled.

get/v1/posts

Request

  • Base URL: https://api.postlake.dev
  • URL: https://api.postlake.dev/v1/posts
  • Auth: bearerAuth (a scheme the document does not define)

Query parameters

sort'created' | 'scheduledAt'

scheduledAt requires state=scheduled. Return posts in ascending scheduled time with stable keyset pagination.

qstring

Case-insensitive literal caption search, applied before pagination.

campaignstring

Exact campaign slug.

targetCount'single' | 'shared'

Single-destination or shared multi-destination posts.

state'draft' | 'awaiting_approval' | 'rejected' | 'queued' | 'scheduled' | 'processing' | 'partial' | 'published' | 'failed'
accountstring

Filter to posts that targeted this connected account id (acc_…).

profilestring

Filter to posts that targeted a channel in this profile (username).

network'bluesky' | 'threads' | 'x' | 'linkedin' | 'instagram' | 'tiktok' | 'facebook' | 'youtube' | 'pinterest'

Filter to posts that targeted this social network.

agentstring

Filter by stable agent id (plc_… or key_…). Use any for all machine-created posts or manual for dashboard-created posts.

surface'dashboard' | 'api' | 'agent'

Filter by creation surface. This distinguishes dashboard work, direct API integrations, and agent tools.

approval'pending' | 'approved' | 'rejected'

Filter the human approval workflow.

fromstring date-time

Include posts on or after this date. Uses published time, scheduled time, then creation time.

tostring date-time

Include posts on or before this date. Uses published time, scheduled time, then creation time.

limitinteger
cursorstring

Response

Success

nextCursorstring nullable required

Changes

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