# List and filter posts with the PostEverywhere API

**Source:** https://posteverywhere.ai/docs/api/list-posts

---

[🤖Connect ChatGPT, Claude or any AI agent to manage your social media end to endConnect your AI agent to manage your social media](https://posteverywhere.ai/agents)GET/posts

# List and filter posts with the PostEverywhere API

Post status is derived live from per-destination statuses (the raw
`posts.post_status` column is frozen at creation). Multi-value filters
(`status`, `platform`) accept comma-separated lists. Invalid filter
values are silently dropped, not rejected.

Guides: [Quick start: create your first post](https://posteverywhere.ai/docs/quick-start) · [Bulk operations guide](https://posteverywhere.ai/docs/bulk-operations)

Copy MarkdownCopy for LLM

## Parameters

statusstringoptionalComma-separated list of: draft, scheduled, publishing, published, partially_failed, failedplatformstringoptionalComma-separated list of: instagram, facebook, x, twitter, linkedin, youtube, tiktok, threads, pinterest, bluesky, telegram, discordaccount_idintegeroptionalFilter to posts targeting this social account (integer ID)campaign_idintegeroptionalFilter to posts in this campaign (integer ID)created_afterstringoptionalcreated_beforestringoptionalscheduled_afterstringoptionalscheduled_beforestringoptionalpublished_afterstringoptionalpublished_beforestringoptionalupdated_afterstringoptionalsearchstringoptionalCase-insensitive substring match on post contentsortstringoptionalorderstringoptionallimitintegeroptionaloffsetintegeroptionalapprovalstringoptionalFilter by approval workflow state. Separate axis from status: a pending post is also a draft.

## Responses

- 200Paginated posts
- 401
- 402
- 403
- 429
- 500

## More in Posts

- [Create a post](https://posteverywhere.ai/docs/api/create-post)
- [Get a post](https://posteverywhere.ai/docs/api/get-post)
- [Update a post](https://posteverywhere.ai/docs/api/update-post)
- [Delete a post](https://posteverywhere.ai/docs/api/delete-post)
- [Publish results](https://posteverywhere.ai/docs/api/get-post-results)
- [Retry a post](https://posteverywhere.ai/docs/api/retry-post)
- [Schedule or publish](https://posteverywhere.ai/docs/api/schedule-post)
- [Bulk create posts](https://posteverywhere.ai/docs/api/bulk-create-posts)
- [Bulk retry](https://posteverywhere.ai/docs/api/retry-failed-posts)
- [Get the queue](https://posteverywhere.ai/docs/api/get-queue)
- [Approve a post](https://posteverywhere.ai/docs/api/approve-post)
- [Request changes](https://posteverywhere.ai/docs/api/request-post-changes)
[Create a post →](https://posteverywhere.ai/docs/api/create-post)[← All endpoints](https://posteverywhere.ai/docs/api/reference)