Tweets
Twitter API Get Replies to a Tweet & Author Fields
Use a Twitter API to get replies to a tweet with cursors, author profiles, engagement metrics, media, time filters, moderation rows, and every error response.
- 200
- 400
- 401
- 402
- 409
- 410
- 424
- 429
- 502
- 503
GET
Twitter API Get Replies to a Tweet & Author Fields
Requested result counts are upper bounds for paid authenticated calls. When remaining credits cannot cover the full page or ID list, Xquik returns fewer results. If zero paid results are affordable, it returns
402 insufficient_credits.1 credit per tweet returned · All plans from $0.00012/credit · Supports guest paid reads
Omit
mode for automatic maximum coverage. Xquik combines available views
within a short request window. It keeps the existing response shape.
Pass next_cursor back unchanged as cursor. Keep the same endpoint, target,
query, and filters.after, limit, and
pageSize aliases also keep working. Billing still counts only returned rows.
Use mode=standard only to force legacy single-view pagination.
A page can be empty or underfilled. Continue while has_next_page is true.
Stop only after the response reports has_next_page=false.
If automatic coverage is busy, an initial request returns a standard data page.
Live coverage cursors remain atomic. Concurrent use returns
409 coverage_cursor_unavailable with exact Retry-After seconds. Wait, then
retry the same cursor once.
Finished, expired, superseded, or identity-mismatched cursors return
410 coverage_cursor_gone. The response omits Retry-After. Restart without
a cursor. Deduplicate restarted results by id.
Malformed cursors return 400 invalid_coverage_cursor. Restart without them.
Get tweet replies returns reply tweets for one X post by numeric tweet ID. Use
it for conversation analysis, support queues, moderation review, giveaway
audits, and agent handoffs.
Twitter API Reply Questions
How Does the Twitter API Get Replies to a Tweet?
Start with the original tweet’s numeric ID. Send it through this endpoint’s path parameter. Automatic pages acceptpageSize from 1 through 300.
Standard pages accept 1 through 100.
The response contains reply tweets, author profiles, and engagement counts.
Store next_cursor after writing every page. Continue only while
has_next_page remains true.
How Complete Is a Tweet Reply Collection?
X controls which public replies each request exposes. Protected, deleted, hidden, or unavailable replies may not appear.mode=complete combines
timelines, rankings, cursors, hidden branches, parent windows, and search.
Direct replies match inReplyToId to the source tweet. Exclude
nested_replies from direct coverage. Trust diagnostic.complete.
How Can a Team Analyze or Moderate Replies?
Store each reply ID, text, author ID, username, creation time, likes, reposts, quotes, views, bookmarks, and media. Create one moderation row per reply. Apply sentiment or spam labels with your classifier. Send uncertain rows to human reviewers. Xquik does not infer sentiment.How Can Support Teams Receive New Reply Alerts?
Create an account monitor for the relevant profile. Selecttweet.reply events on the monitor and webhook. Verify every
webhook signature. Store each event ID before updating a support ticket. Replay
missed events through the events API. Poll this endpoint for conversation
backfills.
Which Reply Fields Should Applications Preserve?
Keep stable author IDs separately from mutable usernames. SaveconversationId
and inReplyToId for thread joins. Store media URLs, likes, reposts, quotes,
views, bookmarks, time filters, page size, and cursors for audits and retries.
How Can Applications Control Reply API Costs?
Each returned reply costs 1 credit. Select a page size that fits your storage process. Bound support periods withsinceTime and untilTime. Save each page
before requesting another cursor. Use reply_extractor for fixed
resultsLimit exports.
Direct Replies Handoff
UseGET /x/tweets/{id}/replies when a support, community, moderation,
giveaway, or agent workflow needs reply rows as JSON. The examples above write
JSON Lines rows with parent_tweet_id, reply_id, text, author IDs and
usernames, thread joins, media URLs, and cursor fields. Each output line ties
one reply to the requested tweet. Workers can restart after storing the latest
response page. The moderation table below adds follower, verification, timing,
and engagement projections.
A 424 replies_incomplete response still contains collected direct and nested
replies. Inspect its diagnostic before retrying. Keep only rows whose
inReplyToId matches the requested tweet for direct-reply workflows.
Use reply_extractor instead when a team needs
an estimate, durable extraction ID, stored result pages, or CSV, JSON, and XLSX
downloads after completion.
Live reply page
Call
GET /x/tweets/{id}/replies when queues, agents, or dashboards need
current JSON rows and can store next_cursor.Saved reply export
Run
reply_extractor for estimates, job status, stored pages, and
downloadable reply files.sinceTime and untilTime are Unix timestamps in seconds. Use them to bound moderation windows, campaign periods, or giveaway audit ranges. Direct replies calls use the default paid page size; use reply_extractor with resultsLimit when you need a predictable file export cap.
Direct replies cost 1 credit per tweet returned. Low balances can reduce standard pages. Zero affordable results return 402 insufficient_credits. Retry 429 with Retry-After. Retry 502 after a short backoff. Retry 503 after its stated delay. For 424 replies_incomplete, inspect diagnostic.recommendedFallback.
Build a Reply Moderation Table
Store one row per reply. Keep the parent Tweet ID and conversation ID beside the reply so support, moderation, campaign, and giveaway reviews can reconstruct each conversation branch.Which replies endpoint?
- Use
GET /api/v1/x/tweets/{id}/repliesfor one tweet’s replies as JSON rows. - Use
reply_extractorwhen you need saved CSV, JSON, or XLSX exports. - Use
GET /api/v1/x/tweets/searchwhen you need keyword, operator, structured-filter, orqueryTypesearch. - Use
GET /api/v1/x/tweets/{id}/threadwhen you need ordered thread context around a tweet.
Path parameters
string
required
Numeric X tweet ID. Pass the source tweet whose replies you want to retrieve.
Query parameters
string
Optional advanced override. Omit it for automatic maximum direct-reply
coverage. Use
standard for legacy pagination. Use complete for nested
replies and detailed diagnostics. Complete mode accepts only limit.number
Maximum combined replies in complete mode. Use
1 through 25000.
Complete mode defaults to 25000. Automatic pages accept 1 through 300.
Standard pages accept 1 through 100.number
default:"20"
Automatic pages accept
1 through 300. Standard pages accept 1 through
100. Omit this field in complete mode. Deprecated aliases remain.string
Pass
next_cursor back unchanged. New Xquik cursors resume automatic
coverage. Existing unprefixed cursors keep legacy behavior.string
Unix timestamp in seconds. Only return replies after this time when a poller,
moderation queue, or campaign report needs a bounded window.
string
Unix timestamp in seconds. Only return replies before this time. Pair with
sinceTime for closed campaign, support, or audit windows.string
In complete mode, select
all, direct, or nested replies.integer
In complete mode, set the maximum reply depth from the source post.
string
In complete mode, sort by
relevance, latest, oldest, or likes.boolean
In complete mode, exclude replies from the source-post author.
boolean
In complete mode, include the source post and count it toward
limit.boolean
In complete mode, only return replies containing media.
Tweet result filters
These filters apply to automatic and standard pagination. They keep the same parent tweet. Remove every filter before requesting complete mode.string
Filter to tweets authored by this username. The
@ prefix is optional.string
Filter to replies directed to this username.
string
Filter to tweets that mention this username.
string
Only include tweets with this language code, such as
en, tr, or es.string
Filter to tweets created on or after this date or timestamp.
string
Filter to tweets created before this date or timestamp. A
YYYY-MM-DD value includes the whole day before the boundary.string
Filter by attached media or links. Values:
images, videos, gifs, media, links, none.integer
Only include tweets meeting this minimum like count.
integer
Only include tweets meeting this minimum repost count.
integer
Minimum reply count.
integer
Minimum quote count.
integer
Minimum Tweet view count.
integer
Minimum Tweet bookmark count.
integer
Maximum Tweet like count. Tweets without a count pass this filter.
integer
Maximum Tweet repost count. Tweets without a count pass this filter.
integer
Maximum Tweet reply count. Tweets without a count pass this filter.
integer
Maximum Tweet quote count. Tweets without a count pass this filter.
boolean
When
true, only return Tweets from Blue-verified authors.boolean
When
true, only return tweets from verified authors.string
Set
include, exclude, or only for reply tweets.string
Set
include, exclude, or only for reposts.string
Set
include, exclude, or only for quote tweets.string
Exact text that must appear in the tweet.
string
Words or quoted phrases to exclude from returned tweets. Use commas or
whitespace between values.
string
Words or quoted phrases where at least 1 term must appear. Use commas or
whitespace between values.
string
Only include tweets matching these hashtags. Use commas or whitespace
between values. The
# prefix is optional.string
Only include tweets matching these cashtags. Use commas or whitespace
between values. The
$ prefix is optional.string
URL substring or domain that must appear in tweet URL entities.
string
Filter to tweets in this conversation thread.
string
Only include replies to this tweet ID.
string
Filter to quote tweets of this tweet ID.
string
Filter to retweets of this tweet ID.
string
Match the Tweet card name.
string
Match the source application.
string
Exclude Tweets from this source application.
string
Match latitude, longitude, and radius in X search syntax.
string
Return Tweets newer than this Tweet ID.
string
Return Tweets older than this Tweet ID.
string
Match this place name.
string
Set the radius for the
near filter.string
Match Tweets inside this recent time window.
boolean
When
true, only return native reposts.boolean
When
true, enable X safe-search filtering.boolean
When
true, only return news results.Headers
string
Full account key. Sessions and OAuth also work.
string
Bearer xq_your_guest_key_here for paid_reads.Response
200 OK
object[]
Array of reply tweets.
boolean
Whether more results are available.
string
Cursor for the next page.
object[]
Nested replies returned by complete mode. Exclude them from direct coverage.
object
Complete-mode coverage evidence. Omitted from standard responses.
400 Invalid Tweet ID
The response usesinvalid_tweet_id. Replace the path value with a numeric
Tweet ID before retrying.
401 Unauthenticated
Anonymous requests getWWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.
402 Payment Required
Account keys get account options; guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.502 X API Unavailable
The read service returned an error. Retry after a short delay.429 Rate Limit Exceeded
Your tier rate limit was exceeded. Wait for theRetry-After header before retrying.
424 Replies Incomplete
The response preserves collected rows and diagnostic evidence. Trustdiagnostic.complete. Follow recommendedFallback before retrying.
503 Complete Reply Extraction Busy
Wait for theRetry-After duration before repeating complete mode.
Related: Tweet Replies Export Workflow when you need saved CSV, JSON, or XLSX files, Tweet Quotes, Tweet Thread, Retweeters, and Favoriters.
- 200
- 400
- 401
- 402
- 409
- 410
- 424
- 429
- 502
- 503
Twitter API Get Replies to a Tweet & Author Fields