> ## Documentation Index
> Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Posts

> GET /v1/social/posts — List social posts with optional filtering and pagination.

<ParamField query="status" type="string">
  Filter by post status. One of `draft`, `scheduled`, `publishing`, `posted`, `failed`.
</ParamField>

<ParamField query="limit" type="number">
  Number of posts to return (default 50, max 100).
</ParamField>

<ParamField query="offset" type="number">
  Number of posts to skip for pagination (default 0).
</ParamField>

<ParamField query="from" type="string">
  ISO 8601 datetime — only return posts created on or after this date.
</ParamField>

<ParamField query="to" type="string">
  ISO 8601 datetime — only return posts created on or before this date.
</ParamField>

<RequestExample>
  ```bash theme={"theme":"css-variables"}
  curl "https://api.usenaive.ai/v1/social/posts?status=posted&limit=10&offset=0" \
    -H "Authorization: Bearer nv_sk_live_..."
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":"css-variables"}
  {
    "posts": [
      {
        "id": "post-uuid",
        "title": "Announcing Naive v2",
        "content": "Excited to announce our new API...",
        "platforms": ["TWITTER", "LINKEDIN"],
        "platform_data": { "TWITTER": { "text": "Excited to announce our new API..." } },
        "upload_ids": null,
        "status": "posted",
        "post_id": "post-uuid",
        "scheduled_at": null,
        "posted_at": "2026-05-01T12:00:05Z",
        "error": null,
        "analytics": null,
        "created_at": "2026-05-01T12:00:00Z",
        "updated_at": "2026-05-01T12:00:05Z"
      }
    ],
    "count": 1,
    "limit": 10,
    "offset": 0
  }
  ```
</ResponseExample>