Social Fetch
Start for freeStart free
X (Twitter) hub

X (Twitter) tweet replies API

Pass a public tweet permalink (or numeric id) and get reply posts with text, authors, and metrics — cursor-paged in the shared Social Fetch envelope.

GET /v1/twitter/tweets/replies

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/twitter/tweets/replies takes a required url query param (an x.com / twitter.com /status/... permalink or a bare numeric tweet id) and an optional opaque cursor. On success, read data.replies and data.page, plus data.tweet for the post the replies belong to on the first page. Each reply is a normalized tweet item: id, url, text, language, timestamps, conversation and parent ids when present, author card, engagement metrics, media, and reply/quote/retweet flags. Paginate by passing data.page.nextCursor as cursor while hasMore is true. The cursor is opaque.

This route pages replies for one status. Parent post detail is GET /v1/twitter/tweets. A handle's timeline is GET /v1/twitter/profiles/{handle}/tweets. Spoken text from a video tweet is GET /v1/twitter/tweets/transcript. Bill from meta.creditsCharged.

X (Twitter) tweet replies API FAQ

How do I list replies to an X / Twitter tweet via API?

Call GET /v1/twitter/tweets/replies with your Social Fetch API key in the x-api-key header and a required url query param (tweet permalink or numeric id). Read data.replies and data.page. See the API docs for parameters and examples.

How many credits does the Twitter tweet replies endpoint cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.

How does pagination work on tweet replies?

Each response includes data.page.nextCursor and data.page.hasMore. When hasMore is true, pass nextCursor as the cursor query param on the next request. The cursor is opaque.

What fields are in each reply?

Each item can include id, public url, text, language, createdAt, conversationId, inReplyToStatusId and the parent author, author (handle, display name, avatar, verification flags, bio, location, website, follower and following counts, affiliation label), metrics (likes, retweets, replies, quotes, views, bookmarks), media with alt text and video duration, link preview card, poll, article, tagged place, Community Note, entities, and isReply / isQuote / isRetweet flags when present. Exact nullability lives in the OpenAPI schema for this route.

Tweet replies vs single tweet vs profile tweets?

Use this route for the reply thread under a status URL. Use GET /v1/twitter/tweets for one parent post by URL. Use GET /v1/twitter/profiles/{handle}/tweets to page a handle's timeline. They are separate marketplace operations with their own credit notes.

What URL formats does the tweet replies API accept?

Public tweet permalinks on x.com or twitter.com (/status/...) or a bare numeric tweet id. Pass one url per request. If the id cannot be parsed from url, the API returns a 400 validation error.

Do I need an X developer account for tweet replies?

No. Authenticate with your Social Fetch API key only. You do not create an X developer app or pass X Bearer tokens for this public replies list.

Other X (Twitter) endpoints