# Export Bookmarks (PDF / CSV / JSON)

`POST https://api.tweetsmash.com/v1/exports/pdf`

Start an export job. POST to /v1/exports/pdf, /v1/exports/csv, or /v1/exports/json with an explicit `tweet_ids` array, a filter (search_query/filter/value), or nothing (the whole library). Returns a job id; the file appears in the Export Center at the returned `page`.

### Header parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `Authorization` | string | Yes | Your secret API key. Should be provided as a Bearer token. |

### Body parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `tweet_ids` | array | No | Explicit bookmark ids to export. Omit to export everything matching the filter, or the whole library. |
| `search_query` | string | No | Keyword search to scope the export. |
| `filter` | string | No | A filter field (e.g. author). |
| `value` | string | No | The value for the filter field. |

### Response

```json
{
  "status": true,
  "data": {
    "job_id": "b3a...",
    "count": 42,
    "total": 42,
    "sampled": false,
    "page": "/integrations/export/pdf"
  },
  "meta": {
    "message": "PDF export started — check the Export Center for the file."
  }
}
```

---

Full reference: https://www.tweetsmash.com/api-docs/export-bookmarks