Get quote tweets

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 · Accepts MPP

Get quote tweets returns tweet rows that quote one source tweet. It is also useful as a quote tweets API, tweet quotes API, X quote tweets API, Twitter quote tweets API, or quoted posts endpoint. The canonical endpoint remains GET /api/v1/x/tweets/{id}/quotes.

curl "https://xquik.com/api/v1/x/tweets/1893456789012345678/quotes" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

The Node.js and Python snippets write JSON Lines quote rows plus a separate checkpoint instead of raw response pages. Persist each mapped row and the latest next_cursor so a moderation queue, campaign report, research job, or agent handoff can resume from the last completed page without duplicate rows.

Direct quote tweet handoff

Use GET /api/v1/x/tweets/{id}/quotes when a support, campaign, moderation, research, or agent workflow needs quote tweets as JSON rows. It returns one row per quote tweet for a single source tweet. Store quoted_tweet_id, quote_id, text, author_id, author_username, author_name, author_followers, author_verified, author_profile_picture, created_at, engagement counts, media URLs, and a separate next_cursor checkpoint. Use sinceTime, untilTime, includeReplies, and tweet result filters to bound the quote set before exporting rows downstream.

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 preserve attached context.

Window filters

Use sinceTime, untilTime, includeReplies, and tweet result filters to narrow campaign, support, or audit windows.

Store has_next_page and next_cursor; 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. For MPP callers, this endpoint is billed as a session at USD 0.00015 per tweet returned.

Historical pages vs live quote alerts

Use this endpoint when you need existing quote tweets for one source tweet. Use monitors when future quote activity should arrive 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.

Path parameters

string

required

Tweet ID (numeric string).

Query parameters

cursor

string

Pagination cursor from next_cursor in a previous response. Omit for the first page. Pass a cursor only when has_next_page is true.

sinceTime

string

Unix timestamp in seconds. Only return quotes after this time.

untilTime

string

Unix timestamp in seconds. Only return quotes before this time.

includeReplies

boolean

Include reply tweets. Default: false.

Tweet result filters

These optional filters apply to tweets[] returned by this route. They keep the same quoted tweet and filter rows after each page is fetched, so selective filters can return fewer rows than an unfiltered page.

fromUser

string

Filter to tweets authored by this username. The @ prefix is optional.

toUser

string

Filter to replies directed to this username.

mentioning

string

Filter to tweets that mention this username.

language

string

Filter by tweet language code, such as en, tr, or es.

sinceDate

string

Filter to tweets created on or after this date or timestamp.

untilDate

string

Filter to tweets created before this date or timestamp. A YYYY-MM-DD value includes the whole day before the boundary.

mediaType

string

Filter by attached media or links. Values: images, videos, gifs, media, links, none.

minFaves

integer

Minimum like count.

minRetweets

integer

Minimum retweet count.

minReplies

integer

Minimum reply count.

minQuotes

integer

Minimum quote count.

verifiedOnly

boolean

When true, only return tweets from verified authors.

replies

string

Reply mode. Values: include, exclude, only.

retweets

string

Retweet mode. Values: include, exclude, only.

quotes

string

Quote mode. Values: include, exclude, only.

exactPhrase

string

Exact text that must appear in the tweet.

excludeWords

string

Words or quoted phrases to exclude from returned tweets. Separate with spaces, commas, or lines.

anyWords

string

Words or quoted phrases where at least 1 term must appear in the tweet. Separate with spaces, commas, or lines.

hashtags

string

Hashtags to match. Separate with spaces, commas, or lines. The # prefix is optional.

cashtags

string

Cashtags to match. Separate with spaces, commas, or lines. The $ prefix is optional.

url

string

URL substring or domain that must appear in tweet URL entities.

conversationId

string

Filter to tweets in this conversation thread.

inReplyToTweetId

string

Filter to replies to this tweet ID.

quotesOfTweetId

string

Filter to quote tweets of this tweet ID.

retweetsOfTweetId

string

Filter to retweets of this tweet ID.

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 when you need 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

x-api-key

string

required

Your API key. Session cookie authentication is also supported.

Response

tweets

object[]

Array of quote tweets.

Show Tweet object fields

string

Tweet ID.

text

string

Tweet text.

type

string

Tweet type. Omitted if unavailable.

createdAt

string

ISO 8601 creation timestamp.

isNoteTweet

boolean

Whether this is a Note Tweet. Omitted if unavailable.

isReply

boolean

Whether the tweet is a reply. Omitted if unavailable.

inReplyToId

string

Tweet ID being replied to. Omitted if not a reply.

inReplyToUserId

string

User ID being replied to. Omitted if unavailable.

inReplyToUsername

string

Username being replied to. Omitted if unavailable.

conversationId

string

Conversation thread ID. Omitted if unavailable.

likeCount

number

Like count. Omitted if unavailable.

retweetCount

number

Retweet count. Omitted if unavailable.

replyCount

number

Reply count. Omitted if unavailable.

quoteCount

number

Quote tweet count. Omitted if unavailable.

viewCount

number

View count. Omitted if unavailable.

bookmarkCount

number

Bookmark count. Omitted if unavailable.

url

string

Permalink URL on X. Omitted if unavailable.

lang

string

Tweet language code. Omitted if unavailable.

source

string

Client used to post the tweet. Omitted if unavailable.

displayTextRange

number[]

Start and end offsets for rendered tweet text. Omitted if unavailable.

isLimitedReply

boolean

Whether replies are limited. Omitted if unavailable.

isQuoteStatus

boolean

Whether this tweet quotes another tweet. Omitted if unavailable.

entities

object

Parsed entities. Omitted if unavailable.

author

object

Tweet author profile. Omitted if unavailable.

Show Author object fields

string

Author user ID.

username

string

Author handle without @.

name

string

Author display name.

followers

number

Follower count. Omitted if unavailable.

verified

boolean

Whether the author is verified. Omitted if unavailable.

profilePicture

string

Author profile image URL. Omitted if unavailable.

media

object[]

Media attachments. Omitted when the tweet has no media.

Show Media object fields

mediaUrl

string

Direct media URL.

type

string

Media type.

url

string

Shortened URL from the tweet text.

quoted_tweet

object

Embedded quoted tweet. Omitted if not a quote tweet.

retweeted_tweet

object

Original retweeted tweet. Omitted if not a retweet.

has_next_page

boolean

Whether more results are available.

next_cursor

string

Cursor for the next page.

{
  "tweets": [
    {
      "id": "1893456789012345679",
      "text": "Great point! RT @user: ...",
      "createdAt": "2026-03-27T11:00:00.000Z",
      "likeCount": 10,
      "author": {
        "id": "44196397",
        "username": "xquikcom",
        "name": "Xquik",
        "followers": 1200,
        "verified": true,
        "profilePicture": "https://pbs.twimg.com/profile_images/example.jpg"
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGE..."
}

{ "error": "invalid_tweet_id" }

{ "error": "unauthenticated" }

{ "error": "no_subscription" }

No active subscription or insufficient credits. Possible error values: no_subscription, subscription_inactive, no_credits, insufficient_credits.

{ "error": "x_api_unavailable" }

The read service returned an error. Retry after a short delay.

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

Your tier rate limit was exceeded. Wait for the Retry-After header before retrying.

{ "error": "x_api_unavailable" }

The normalized v1 response contract can return 424 when the read service is unavailable.

Related: Tweet replies · Tweet thread · Retweeters · Tweet favoriters

Documentation Index

​Direct quote tweet handoff

Quote rows

Stable upserts

Author joins

Engagement metrics

Media context

Window filters

Next page

Credit-limited pages

​Historical pages vs live quote alerts

Historical quote pull

Account quote monitor

Keyword quote monitor

Signed webhook delivery

​Path parameters

​Query parameters

​Tweet result filters

​Which tweet engagement endpoint?

Quote tweets

Tweet replies

Retweeters

Tweet likers

Saved exports

Search handoff

​Headers

​Response

Direct quote tweet handoff

Historical pages vs live quote alerts

Path parameters

Query parameters

Tweet result filters

Which tweet engagement endpoint?

Headers

Response