# Export post stats (CSV)

> Every post in a period with its numbers as CSV text (up to 5,000 rows). Filters match how_did_it_do.

`analytics.export_posts_csv` · read

- **MCP tool:** `analytics_export_posts_csv`. Catalog: reach it with `find_actions` and `run_read_action`, or turn on the full toolset.
- **REST:** `GET /v1/analytics/export-posts-csv`
- **CLI:** `xholic analytics export-posts-csv`
- **Scope:** `read`
- **Plan:** Every plan, including the trial
- **Cost:** Free.
- **Rate limit bucket:** `read`

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `range` | "today" \\| "7d" \\| "14d" \\| "30d" \\| "60d" \\| "90d" \\| "180d" \\| "all" | No |  |
| `timezone` | string ≤ 100 chars | No | IANA timezone such as America/New_York. Use the user's timezone. |
| `kind` | "ALL" \\| "POST" \\| "REPLY" \\| "REPOST" \\| "QUOTE" | No |  |
| `origin` | "NEURON" \\| "BRAIN" \\| "REMIX" \\| "SCHEDULER" \\| "EXTENSION" \\| "NATIVE_X" \\| "UNKNOWN" or "ALL" | No |  |
| `format` | "TEXT" \\| "IMAGE" \\| "VIDEO" \\| "LINK" \\| "THREAD" \\| "ARTICLE" or "ALL" | No |  |
| `search` | string ≤ 160 chars | No |  |
| `sort` | "publishedAt" \\| "impressions" \\| "engagements" \\| "engagementRate" \\| "likes" \\| "replies" \\| "reposts" \\| "quotes" \\| "bookmarks" \\| "profileClicks" \\| "urlClicks" \\| "followerGain" \\| "bookmarkRate" \\| "replyRate" \\| "shareRate" \\| "firstDayImpressions" \\| "baselineMultiple" | No |  |
| `direction` | "asc" \\| "desc" | No |  |
| `from` | string | No | First day, YYYY-MM-DD; overrides range. |
| `to` | string | No | Last day, YYYY-MM-DD. |
| `account` | string ≤ 64 chars | No | X account to act on, as @handle. Leave it out to use the connection's default account. |