TWTR Data API
TWTR Data API provides read-only access to public X (Twitter) data through stable, normalized JSON. ### Available data - User profiles, followers, and following - Batch user lookup by username or numeric ID - Batch tweet lookup by numeric ID - User posts, media posts, and the Tweets & Replies timeline - Tweet details and high-quality conversation replies - Tweet search by relevance or recency -…
TWTR Data API endpoints
| Method | Endpoint | Description |
|---|---|---|
| System | ||
| GET |
health /health |
|
| GET |
healthLive /health/live |
Confirms that the Node.js process is running and able to serve HTTP requests. |
| GET |
healthReady /health/ready |
Confirms that the process has the upstream authentication material required to serve requests. |
| Users | ||
| GET |
getFollowing /user/{id}/following |
Returns a normalized, cursor-paginated list of accounts a user follows. |
| GET |
getUsersByUsernames /users/by |
Looks up as many as 20 unique usernames in one request. Input order is preserved among returned users, duplicate usernames are removed case-insensitively, and unresolved… |
| GET |
getUser /user/{username} |
Returns a normalized user profile by screen name. A leading `@` is accepted. |
| GET |
getUsersByIds /users |
Looks up as many as 20 unique numeric user IDs in one request. Input order is preserved, duplicate IDs are removed, and unresolved IDs are listed in `not_found`. |
| GET |
getFollowers /user/{id}/followers |
Returns a normalized, cursor-paginated list of accounts following a user. |
| Tweets | ||
| GET |
getTweet /tweet/{id} |
Returns one normalized tweet and a cursor-paginated list of high-quality replies. |
| GET |
getUserTweets /user/{id}/tweets |
Returns a normalized, cursor-paginated tweet timeline for a numeric user ID. |
| GET |
getTweetsByIds /tweets |
Looks up as many as 20 unique tweet IDs in one request. Input order is preserved, duplicate IDs are removed, and unresolved IDs are listed in `not_found`. |
| GET |
getUserMedia /user/{id}/media |
Returns the user's cursor-paginated media timeline. Every normalized tweet contains at least one photo, video, or animated GIF in `media`. |
| GET |
getUserTweetsAndReplies /user/{id}/tweets-and-replies |
Returns the profile's Tweets & Replies timeline, including replies that are not present in the regular tweets timeline. |
| Search | ||
| GET |
searchTweets /search |
Returns normalized tweets ordered by relevance (`Top`) or recency (`Latest`). Identical searches may be served from a short-lived cache. During an upstream search-rate window, a… |
| GET |
searchUsers /search/users |
Returns normalized user accounts matching a name, username, or keyword. Identical searches use the same bounded cache and upstream search-rate protection as tweet search. |
TWTR Data API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 1 / second |
|
| PRO Recommended | $6 / month | 3 / second |
|
| ULTRA | $15 / month | 8 / second |
|