Endpoints
| Endpoint | Returns and price |
|---|---|
GET /v1/posts/{postId}Post details | Post · $0.001 per request |
GET /v1/posts/{postId}/repliesDirect replies | Page of posts · $0.10 per 1,000 records |
GET /v1/posts/{postId}/threadConversation thread | Page of posts · $0.10 per 1,000 records |
GET /v1/posts/{postId}/retweetersRetweeters | Page of accounts · $0.10 per 1,000 records |
All routes take Authorization: Bearer $TWITTERXAPI_KEY and level. Collections return one page; continue with the cursor.
Find the post ID
- Use the number after
/status/in the post URL, kept as a string. - Replies returns direct replies. Thread returns the wider conversation, including deeper replies and other authors.
GET/v1/posts/{postId}Post
Post details
One post with its author, metrics, media, and the quoted or reposted post when present.
| Parameter | In | Description |
|---|---|---|
postId requirednumeric string | path | Numeric post ID, the number after /status/ in a post URL. |
levelraw | moderate | contentful | query | Response level. Defaults to moderate. |
Returns: Post · Price: $0.001 per request
cURL
curl "https://twitterxapi.com/api/v1/posts/1897412345678901234" \
-H "Authorization: Bearer $TWITTERXAPI_KEY"GET/v1/posts/{postId}/repliesPage of posts
Direct replies
One page of posts that reply directly to the post.
| Parameter | In | Description |
|---|---|---|
postId requirednumeric string | path | Numeric post ID, the number after /status/ in a post URL. |
cursorstring | query | Value of pagination.next_cursor from the previous page. Omit for the first page. |
levelraw | moderate | contentful | query | Response level. Defaults to moderate. |
Returns: Page of posts · Price: $0.10 per 1,000 records
cURL
curl "https://twitterxapi.com/api/v1/posts/1897412345678901234/replies" \
-H "Authorization: Bearer $TWITTERXAPI_KEY"GET/v1/posts/{postId}/threadPage of posts
Conversation thread
One page of the conversation, including replies deeper than one level.
| Parameter | In | Description |
|---|---|---|
postId requirednumeric string | path | Numeric post ID, the number after /status/ in a post URL. |
cursorstring | query | Value of pagination.next_cursor from the previous page. Omit for the first page. |
levelraw | moderate | contentful | query | Response level. Defaults to moderate. |
Returns: Page of posts · Price: $0.10 per 1,000 records
cURL
curl "https://twitterxapi.com/api/v1/posts/1897412345678901234/thread" \
-H "Authorization: Bearer $TWITTERXAPI_KEY"GET/v1/posts/{postId}/retweetersPage of accounts
Retweeters
One page of accounts that reposted the post.
| Parameter | In | Description |
|---|---|---|
postId requirednumeric string | path | Numeric post ID, the number after /status/ in a post URL. |
cursorstring | query | Value of pagination.next_cursor from the previous page. Omit for the first page. |
levelraw | moderate | contentful | query | Response level. Defaults to moderate. |
Returns: Page of accounts · Price: $0.10 per 1,000 records
cURL
curl "https://twitterxapi.com/api/v1/posts/1897412345678901234/retweeters" \
-H "Authorization: Bearer $TWITTERXAPI_KEY"