Social

List social posts

Returns the account's posts sorted by scheduledAt, newest first, optionally filtered by status, network and a scheduledAt range. Use it to see what went out (platformPostId) and why anything failed (error). Pedra Pro only. Free.

post/api/social/posts/list

Request

  • Base URL: https://app.pedra.ai
  • URL: https://app.pedra.ai/api/social/posts/list
  • Auth: none required

Request body

apiKeystring required

Account API key, sent in the request body. Get one at https://app.pedra.ai under Settings → API.

status'pending' | 'processing' | 'posted' | 'failed' | 'cancelled'

pending: waiting for its time (only pending posts can be cancelled). processing: being published. posted: live on the network. failed: not published, see error. cancelled: cancelled before it went out.

network'instagram' | 'facebook' | 'tiktok' | 'youtube'

A supported social network.

fromstring date-time

Only posts with scheduledAt at or after this time.

tostring date-time

Only posts with scheduledAt at or before this time.

limitinteger

Response

The posts.

Changes

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