List Posts
List posts with optional filters (paginated).
GET /v1/posts
List posts with optional filters.
Auth: Bearer API key (required)
Query parameters
| Param | Type | Default | Description |
|---|---|---|---|
page | int | 1 | Page number |
limit | int | 20 | Results per page (max 100) |
status | string | — | Filter: draft, scheduled, published, failed, etc. |
platform | string | — | Filter by platform enum |
search | string | — | Search post content |
Response 200
{
"data": [
{
"id": "uuid",
"content": "Post text",
"status": "draft",
"scheduled_at": null,
"created_at": "2026-07-11T14:00:00.000Z",
"media_ids": []
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 42
}
}cURL
curl "https://api.social0.app/v1/posts?status=draft&limit=10" \
-H "Authorization: Bearer sk_live_YOUR_KEY"