Skip to main content
GET
/
x
/
tweets
/
{id}
/
thread
Get tweet thread
curl --request GET \
  --url https://xquik.com/api/v1/x/tweets/{id}/thread \
  --header 'x-api-key: <api-key>'

Documentation Index

Fetch the complete documentation index at: https://docs.xquik.com/llms.txt

Use this file to discover all available pages before exploring further.

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 tweet thread returns tweet rows in the conversation thread around one source tweet. It is also useful as a tweet thread API, X thread API, Twitter thread API, conversation thread API, or thread context endpoint. The canonical endpoint remains GET /api/v1/x/tweets/{id}/thread.
curl "https://xquik.com/api/v1/x/tweets/1893456789012345678/thread" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq
The Node.js and Python snippets write JSON Lines thread rows plus a separate checkpoint instead of raw response pages. Persist each mapped row and the latest next_cursor so a support timeline, research job, moderation queue, or agent handoff can resume from the last completed page without duplicate rows.

​
Direct tweet thread handoff

Use GET /api/v1/x/tweets/{id}/thread when a workflow needs ordered thread context as durable rows around one tweet. Store source_tweet_id, thread_tweet_id, text, author_id, author_username, author_name, author_followers, author_verified, author_profile_picture, created_at, conversation_id, in_reply_to_id, media URLs, and a separate next_cursor checkpoint for downstream jobs.

Thread rows

Store tweets[] as the thread context rows returned for one source tweet.

Stable upserts

Store tweets[].id as thread_tweet_id with source_tweet_id for idempotent imports.

Reply joins

Store conversationId, inReplyToId, inReplyToUserId, and inReplyToUsername to rebuild thread structure.

Author joins

Store tweets[].author.id, username, name, followers, verified, and profilePicture for review, CRM, or research tools.

Media context

Store media[].mediaUrl, entities, quoted_tweet, and retweeted_tweet when returned to preserve attached context.

Next page

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.

Saved exports

Use thread_extractor when you need a saved extraction job or CSV, JSON, or XLSX export.
Direct tweet thread 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.

​
Path parameters

​
id
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.

​
Which thread endpoint?

Tweet thread

Use GET /x/tweets/{id}/thread for conversation thread context around one tweet.

Tweet replies

Use GET /x/tweets/{id}/replies when you need reply tweet rows under one source tweet.

Quote tweets

Use GET /x/tweets/{id}/quotes for tweet rows that quote one source tweet.

Search tweets

Use GET /x/tweets/search when you need keyword, operator, or structured-filter discovery across many tweets.

Saved exports

Use Create extraction with toolType=thread_extractor when you need a saved job or CSV, JSON, or XLSX export.

Single tweet

Use Get tweet when you only need one tweet object by ID.

​
Headers

​
x-api-key
string
required
Your API key. Session cookie authentication is also supported.

​
Response

​
tweets
object[]
Array of tweets in the thread, ordered chronologically.
​
has_next_page
boolean
Whether more results are available.
​
next_cursor
string
Cursor for the next page.
{
  "tweets": [
    {
      "id": "1893456789012345678",
      "text": "Thread starts here...",
      "createdAt": "2026-03-27T10:00:00.000Z",
      "author": {
        "id": "9876543210",
        "username": "xquik",
        "name": "Xquik",
        "followers": 12000,
        "verified": true,
        "profilePicture": "https://pbs.twimg.com/profile_images/example.jpg"
      }
    }
  ],
  "has_next_page": false,
  "next_cursor": ""
}
Related: Tweet replies · Quote tweets · Retweeters · Create extraction
Last modified on May 24, 2026