Skip to main content
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.
Requested result counts are upper bounds for paid authenticated calls. Remaining credits may not cover the full page or ID list. If so, 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
This route returns quote tweets for one original tweet. Each row includes the quoting tweet’s commentary, author, engagement counts, and media attachments. The route is 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.
The Node.js and Python snippets write JSON Lines quote rows plus a separate checkpoint. They do not write raw response pages. Store each mapped row and the latest 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

Use GET /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.
Direct quote tweet reads cost 1 credit per tweet returned. Low credit balances can return fewer tweets than a full page. Zero affordable results return 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 returned quote_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 to tweets[] 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 receive WWW-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.

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." }