GET https://xquik.com/api/v1/x/tweets/{id}/quotes
Repost records include
retweetedAt, the repost event’s UTC ISO 8601 timestamp. It is null when
that timestamp is unavailable. The API omits it for original posts. The nested original post keeps
its own creation date. This field does not report every account that reposted a post. Request
per-account timestamps with Get retweeters.402 insufficient_credits.
1 credit per tweet returned · All plans from $0.00012/credit · Supports guest paid reads
GET /api/v1/x/tweets/{id}/quotes.
A post X does not have returns 404 tweet_not_found, as
Get tweet does. Quotes X (Twitter) still lists for a
deleted post return as rows. A post without quotes returns an empty page. A 404
costs no credits.
Pass next_cursor back unchanged as cursor. A page can be empty while
has_next_page is true, so keep following next_cursor. A cursor in use
returns 409 coverage_cursor_unavailable. Wait for Retry-After, then retry it
once. A finished or expired cursor returns 410 coverage_cursor_gone. Restart
without a cursor and deduplicate by id. A busy read returns 503. Retry after
Retry-After.
next_cursor. A moderation queue, campaign report, research job, or agent
handoff can then resume. It can resume from the last completed page without duplicate rows.
Direct quote tweet handoff
UseGET /api/v1/x/tweets/{id}/quotes when a
workflow needs quote tweets as JSON rows. It can be a support, campaign,
moderation, research, or agent workflow. The endpoint returns one row
for every quote tweet in the response. Store quoted_tweet_id, quote_id,
text, author_id, author_username, author_name, author_followers,
author_verified, author_profile_picture, created_at, and engagement
counts. Also store media URLs and a separate next_cursor checkpoint. Use
sinceTime, untilTime, includeReplies, and tweet result filters to narrow
the quote set. Do this before you export rows.Quote rows
Store
tweets[] as quote tweet rows for one source tweet.Stable upserts
Store
tweets[].id as quote_id with quoted_tweet_id for idempotent
imports and moderation queues.Author joins
Store
tweets[].author.id, username, name, followers, verified, and
profilePicture for CRM, research, and review tools.Engagement metrics
Store
likeCount, replyCount, retweetCount, quoteCount, viewCount,
and bookmarkCount when returned.Media context
Store
media[].mediaUrl, entities, quoted_tweet, and retweeted_tweet
when returned to keep attached context.Window filters
Use
sinceTime, untilTime, includeReplies, and tweet result filters to
narrow a window. It can be a campaign, support, or audit window.Next page
Store
has_next_page and next_cursor. Then pass next_cursor back as cursor
only when has_next_page is true.Credit-limited pages
Use
tweets.length, not a requested page size, for row counts. Low balances
can return fewer rows.402 insufficient_credits.Historical pages vs live quote alerts
Use this endpoint when you need existing quote tweets for one source tweet. Use monitors for future quote activity as stored events or signed webhook deliveries.Historical quote pull
Call
GET /x/tweets/{id}/quotes, store quote_id, and resume with
next_cursor for one known source tweet.Account quote monitor
Use
POST /monitors with
eventTypes: ["tweet.quote"] when one tracked account’s future quote
tweets should produce events.Keyword quote monitor
Use
POST /monitors/keywords
with eventTypes: ["tweet.quote"] when matching future quote tweets should
produce events.Signed webhook delivery
Use
POST /webhooks with tweet.quote,
verify signatures, and replay stored rows with
GET /events.Quote tweet questions
What are quote tweets?
A quote tweet is a new tweet containing commentary about an original tweet. X calls this format a Quote Post. This endpoint returns the quoting tweet, its author, and visible engagement. It never changes the original tweet.How does an X (Twitter) API view quote tweets?
Pass the original tweet’s numeric ID through the path. Store every returnedquote_id before requesting next_cursor. Keep the original tweet ID beside
each row for attribution, deduplication, and campaign reporting.Why are some quote tweets not showing?
X controls which quote tweets each request exposes. Deleted, protected, withheld, blocked, or unavailable tweets may not appear. Filters can also remove otherwise visible rows. A missing row cannot confirm zero quote activity.How do quote tweets differ from replies and reposts?
A quote tweet adds its author’s commentary and references the original tweet. A repost shares the original without added commentary. The replies endpoint returns tweets from the original conversation. Use retweeters for reposting profiles.How can teams analyze quote tweets?
Store text, author, creation time, engagement counts, and media URLs. Keep the source relationship separate. Use both tweet IDs as the deduplication key. Use monitors and signed webhooks for future quote alerts.Path parameters
Query parameters
The default result holds replies that quote the tweet, as X’s Quotes
view does. Send
replies=exclude to drop such replies.Tweet result filters
These optional filters apply totweets[] returned by this route. They keep the
same quoted tweet. Xquik filters rows after it fetches each page. Selective
filters can return fewer rows than an unfiltered page.See tweet filters for every filter. Common ones are
fromUser, language, sinceDate, mediaType, minLikes, and hashtags.Choose fields
Which tweet engagement endpoint?
Quote tweets
Use
GET /x/tweets/{id}/quotes for tweet rows that quote one source tweet.Tweet replies
Use
GET /x/tweets/{id}/replies when you
need reply tweet rows under the source tweet.Retweeters
Use
GET /x/tweets/{id}/retweeters for user
profiles that reposted one source tweet.Tweet likers
Use
GET /x/tweets/{id}/favoriters for user
profiles that liked one source tweet.Saved exports
Use
Create extraction with
toolType=quote_extractor for a saved job or CSV, JSON, or XLSX
export.Search handoff
Use
Search tweets when you need keyword,
operator, or structured-filter discovery across many source tweets.Headers
Response
200 OK
401 Unauthenticated
Anonymous requests receiveWWW-Authenticate: Bearer. This is not a Payment challenge.402 Payment required
Account keys receive account options. A guest wallet receives a checkout option. Confirm any payment action.Related. Tweet replies · Tweet thread · Retweeters · Tweet favoriters
Response examples
200 example
- 400
{ "error": "invalid_input", "message": "Invalid input. Check the request body." } - 401
{ "error": "unauthenticated", "message": "Authentication required." } - 402
{ "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." } - 403
{ "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." } - 404
{ "error": "tweet_not_found", "message": "Tweet not found. Check the tweet ID." } - 409
{ "error": "coverage_cursor_unavailable", "message": "Cursor busy. Retry after the indicated delay." } - 410
{ "error": "coverage_cursor_gone", "message": "Cursor finished, expired, or superseded. Restart pagination without cursor." } - 424
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 429
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 } - 502
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 503
{ "error": "x_api_unavailable", "message": "Maximum coverage is busy. Retry shortly." }