Getting Started with TweetsMash API
The TweetsMash API is an X bookmarks API for your saved posts: authenticate with a Bearer token and fetch your X (Twitter) bookmarks, labels, and more as clean JSON.
Authentication
All API requests require authentication using your API key. Follow these steps to get your API key:
Visit the API Integration Page
Go to the TweetsMash API integration page to generate your API key.
Open API Integration PageGenerate Your API Key
Once on the integration page, you'll see a button to generate your API key. Click it to create a new key.
Note: Your API key is sensitive information. Keep it secure and never share it publicly.
Use Your API Key
Include your API key in the Authorization header of your requests:
Authorization: Bearer YOUR_API_KEY_HEREQuick Start Example
Here's a simple example of how to fetch your bookmarks using cURL:
curl -X GET "https://api.tweetsmash.com/v1/bookmarks" \ -H "Authorization: Bearer YOUR_API_KEY_HERE" \ -H "Content-Type: application/json"
Response Example:
{
"status": true,
"data": [
{
"post_id": "1938682607145034084",
"tweet_details": {
"text": "Your tweet content here...",
"link": "https://twitter.com/username/status/1938682607145034084",
"posted_at": "2025-06-27T19:35:27+00:00"
},
"author_details": {
"name": "Author Name",
"username": "username"
}
}
],
"meta": {
"next_cursor": "MTc1OTYxNw==",
"limit": 20,
"total_count": 396
}
}Rate Limits
To ensure fair usage, API requests are subject to rate limits:
- 100 requests per hour per API key
Error Handling
The API returns standard HTTP status codes and error messages:
Next Steps
Now that you have your API key, explore the available endpoints:
Bookmarks
Fetch and manage your saved tweets with filtering and pagination options.
View Documentation →