# X (Twitter) API

Get public X profiles, posts, replies, media, followers, lists, search, and more through the same API as Instagram and TikTok.

Status: Profiles, timelines, replies, media, followers, following, search, posts, and conversations are available in Test and Live. Last reviewed August 17, 2026.
Example: GET https://api.openhandle.dev/v1/twitter/profiles/@{username}
Every call is one request at the same price. All endpoints accept the freshness parameter.

## Endpoints (17 operations)

| Operation | Endpoint |
|---|---|
| Get a profile | GET /v1/twitter/profiles/{identifier} |
| List user posts | GET /v1/twitter/profiles/{identifier}/posts |
| List user replies | GET /v1/twitter/profiles/{identifier}/replies |
| List user media | GET /v1/twitter/profiles/{identifier}/media |
| List followers | GET /v1/twitter/profiles/{identifier}/followers |
| List following | GET /v1/twitter/profiles/{identifier}/following |
| Get a post | GET /v1/twitter/posts/{identifier} |
| List post replies | GET /v1/twitter/posts/{identifier}/comments |
| List nested replies | GET /v1/twitter/posts/{identifier}/comments/{comment_id}/replies |
| List post reposters | GET /v1/twitter/posts/{identifier}/reposters |
| Get a list | GET /v1/twitter/lists/{identifier} |
| List list members | GET /v1/twitter/lists/{identifier}/members |
| List list posts | GET /v1/twitter/lists/{identifier}/posts |
| Search latest or top posts | GET /v1/twitter/search/posts?q={query}&sort=latest |
| Search users | GET /v1/twitter/search/users?q={query} |
| Search images or videos | GET /v1/twitter/search/media?q={query}&type=image |
| Search suggestions | GET /v1/twitter/search/suggestions?q={query} |

Field reference: https://openhandle.dev/docs/platforms/twitter.md (generated from the API, the source of truth for fields and types).

## Limitations

- X can change its public interfaces. Openhandle handles those changes behind the API.
- Write actions and account login are not part of the public-data API.

## FAQ

### Do I need official X API access or approval?

No. Your application uses an Openhandle API key. Openhandle handles the upstream integration behind redundant paths.

### Will I need to resolve a handle to an ID first?

No. Use @username or the stable platform ID directly in any profile path, including /posts and /replies. Either form is one billed request.

Docs: https://openhandle.dev/docs/platforms/twitter · Pricing: https://openhandle.dev/pricing.md