The X Bookmarks API for your saved posts
The Tweetsmash X bookmarks API is a REST API that fetches and manages the posts you bookmark on X (Twitter). It returns your bookmarks as clean JSON with unrolled threads, author details, and labels, authenticated with a personal Bearer token from your Tweetsmash account. AI agents can use the same data through the Tweetsmash MCP server.
One token, your whole bookmark archive
The official X API bookmarks endpoints require a developer account, pay-per-use billing, and an OAuth 2.0 user-context flow. Tweetsmash imports your bookmarks first, then serves them from your own library: one Bearer token, unrolled threads, label filters, and webhooks.
curl "https://api.tweetsmash.com/v1/bookmarks?limit=20" \
-H "Authorization: Bearer YOUR_API_TOKEN"Endpoints
How to get an API key for your X bookmarks
- Create a Tweetsmash account and import your X bookmarks with one click.
- Open Settings, then Integrations, then API in your dashboard.
- Generate your token and call api.tweetsmash.com/v1 with it as a Bearer header.
Full reference, parameters, and response examples live in the API documentation. Prefer no-code? Tweetsmash also syncs bookmarks straight to Notion and Google Sheets.
X bookmarks API: frequently asked questions
What is the Tweetsmash X bookmarks API?
A REST API at api.tweetsmash.com/v1 that returns the posts you bookmarked on X (Twitter) as JSON, with unrolled threads, author details, and your labels. It authenticates with a personal Bearer token that you generate in your Tweetsmash dashboard.
Can I access my X bookmarks without the official X API?
Yes. Tweetsmash imports your X bookmarks into your own library, and the API serves them from there. You do not need an X developer account, OAuth 2.0 setup, or pay-per-use API billing. One Bearer token is all it takes.
Which endpoints does the X bookmarks API include?
GET /v1/bookmarks fetches your saved posts with pagination and filters. GET /v1/labels lists your labels. POST /v1/labels/add and POST /v1/labels/remove manage labels on tweets. Webhooks can push new bookmarks to your own endpoint in real time.
What are the API rate limits?
100 requests per hour per API key. Responses include pagination cursors, so you can walk through your full bookmark archive within the limit.
Can AI agents like Claude use the API?
Yes. The same API token powers the Tweetsmash MCP server, which lets Claude, ChatGPT, Cursor, and other MCP clients search, count, and label your X bookmarks through natural language.
Build your information consumption workflow from Twitter Bookmarks
Import Bookmarks to TweetsmashSee our pricing
Built for curating & reading best of Twitter