Twitter X Data
`Twitter X Data gives developers a cleaner way to work with X (Twitter) data through a normalized API layer designed for SaaS apps, automation tools, agencies, and internal developer teams. Instead of building your own quota tracking, usage logging, response normalization, and access controls on top of the raw X API, this API provides a simpler interface with production-ready safeguards built…
Twitter X Data endpoints
| Method | Endpoint | Description |
|---|---|---|
| Health | ||
| GET |
/health/ready /health/ready |
Returns 503 if database or critical dependencies are down. |
| GET |
/v1/health /v1/health |
Health check endpoint that confirms the API service is running and reachable. Returns API version and server timestamp. |
| Tweets | ||
| GET |
/tweets /tweets |
|
| GET |
/tweets/{id} /tweets/{id} |
|
| POST |
/tweets /tweets |
Requires user-context OAuth token for upstream auth. |
| DELETE |
/tweets/{id}/delete /tweets/{id}/delete |
Requires user-context OAuth token. |
| Users | ||
| GET |
/users /users |
|
| GET |
/users/{identifier} /users/{identifier} |
|
| Search | ||
| GET |
/search/recent /search/recent |
Search tweets from the last 7 days. |
| GET |
/search/count /search/count |
|
| Timelines | ||
| GET |
/timelines/{userId}/tweets /timelines/{userId}/tweets |
|
| GET |
/timelines/{userId}/mentions /timelines/{userId}/mentions |
|
| Likes | ||
| POST |
/likes /likes |
Requires user-context OAuth token. |
| GET |
/likes/{userId} /likes/{userId} |
|
| DELETE |
/likes/{userId}/{tweetId} /likes/{userId}/{tweetId} |
Requires user-context OAuth token. |
| Follows | ||
| DELETE |
/follows/{sourceUserId}/{targetUserId} /follows/{sourceUserId}/{targetUserId} |
Requires user-context OAuth token. |
| GET |
/follows/{userId}/followers /follows/{userId}/followers |
|
| POST |
/follows /follows |
Requires user-context OAuth token. |
| GET |
/follows/{userId}/following /follows/{userId}/following |
|
| DMs | ||
| GET |
/dms/events /dms/events |
Requires X API Pro/Enterprise access with dm.read scope. Will return UPSTREAM_AUTH_FAILURE if credentials lack DM access. |
| GET |
/dms/conversations/{participantId} /dms/conversations/{participantId} |
|
| POST |
/dms/send /dms/send |
Requires X API Pro/Enterprise access with dm.write scope. |
| Dashboard | ||
| GET |
/dashboard /dashboard |
Returns usage statistics, quota info, top endpoints, and cost savings estimate for the authenticated user. |
| Admin | ||
| POST |
/admin/users/{id}/keys /admin/users/{id}/keys |
|
| DELETE |
/admin/keys/{keyId} /admin/keys/{keyId} |
|
| PATCH |
/admin/users/{id}/tier /admin/users/{id}/tier |
|
| GET |
/admin/usage /admin/usage |
|
| POST |
/admin/users /admin/users |
|
| POST |
/admin/login /admin/login |
|
| PATCH |
/admin/keys/{keyId}/quota /admin/keys/{keyId}/quota |
|
| GET |
/admin/users /admin/users |
|
| GET |
/admin/users/{id} /admin/users/{id} |
|
Twitter X Data pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $15 / month | — |
|
| ULTRA Recommended | $79 / month | — |
|
| MEGA | $249 / month | — |
|