Skip to main content
GET
/
x
/
tweets
/
{id}
Get tweet
curl --request GET \
  --url https://xquik.com/api/v1/x/tweets/{id} \
  --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.

1 credit per call · All plans from $0.00012/credit · Accepts MPP
Get tweet returns one tweet by numeric ID. It is also useful as a tweet lookup API, single tweet API, tweet info API, X tweet API, or tweet details endpoint. The canonical endpoint remains GET /api/v1/x/tweets/{id}.
curl https://xquik.com/api/v1/x/tweets/1893456789012345678 \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq
The examples shape durable tweet lookup rows instead of raw response dumps. Use GET /api/v1/x/tweets/{id} when a workflow needs one tweet plus author context. Store tweet_id, text, author_id, author_username, author_followers, author_verified, author_profile_picture, created_at, conversation_id, is_reply, is_quote_status, is_note_tweet, tweet_source, quote_tweet_id, metrics, and media_urls with the downstream record.

​
Direct tweet handoff

Pass a 15 to 20 digit numeric tweet ID in the path. If a user gives a tweet URL, extract the final status ID first. URLs, usernames, and short IDs return 400 invalid_tweet_id. Use the response when you need normalized tweet text, optional author data, engagement counts, quote metadata, conversation context, Note Tweet text, source, and media URLs for 1 record.

Single row

Store one durable row per ID with tweet_id, text, timestamps, flags, metrics, and media URLs.

Author context

Use embedded author fields when returned instead of making a second user lookup for the same row.

Quote context

Store isQuoteStatus and quoted_tweet.id when you need quote joins or attribution.

Conversation joins

Store conversationId and isReply when the row feeds a thread, reply, or moderation workflow.

Long-form tweets

Use isNoteTweet and tweet.text for complete Note Tweet text returned by this endpoint.

Media assets

Store each media[].mediaUrl for review queues, warehouses, and downstream enrichment.
Direct tweet reads cost 1 credit per successful call. For MPP callers, this endpoint is billed as a fixed charge at USD 0.00015 per call.

​
Path parameters

​
id
string
required
Numeric tweet ID, 15-20 digits. If you have a tweet URL, use the final status ID.

​
Which tweet endpoint?

One tweet by ID

Use GET /x/tweets/{id} for one tweet’s text, author, media, quote or reply flags, metrics, and Note Tweet text.

Many tweet IDs

Use Get tweets (batch) when you already have multiple numeric IDs.

Keyword or advanced search

Use Search tweets when you need keyword, operator, author, date, media, engagement, or verification filters.

Thread context

Use Get tweet thread when the next action needs surrounding conversation rows.

Engagement lists

Use replies, quote tweets, retweeters, or favoriters pages when you need users or tweets connected to this tweet.

Saved exports

Use Create extraction with reply_extractor, quote_extractor, repost_extractor, thread_extractor, or tweet_search_extractor when you need CSV, JSON, or XLSX output.

​
Headers

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

​
Response

​
tweet
object
The tweet data.
​
author
object
The tweet author. Omitted if author data is unavailable.
{
  "tweet": {
    "id": "1893456789012345678",
    "text": "Introducing our new extraction API. Ship faster.",
    "createdAt": "2026-02-24T14:30:00.000Z",
    "isNoteTweet": false,
    "isReply": false,
    "isQuoteStatus": true,
    "conversationId": "1893456789012345678",
    "source": "Twitter Web App",
    "entities": {
      "urls": [
        {
          "display_url": "xquik.com/blog/extracti...",
          "expanded_url": "https://xquik.com/blog/extraction-api",
          "url": "https://t.co/abc123"
        }
      ],
      "hashtags": [],
      "user_mentions": []
    },
    "quoted_tweet": {
      "id": "1893000000000000000",
      "text": "What API tools are you shipping this week?",
      "author": {
        "id": "111222333",
        "username": "devtools"
      }
    },
    "retweetCount": 320,
    "replyCount": 85,
    "likeCount": 1400,
    "quoteCount": 45,
    "viewCount": 250000,
    "bookmarkCount": 210,
    "media": [
      {
        "mediaUrl": "https://pbs.twimg.com/media/example.jpg",
        "type": "photo",
        "url": "https://t.co/abc123"
      }
    ]
  },
  "author": {
    "id": "987654321",
    "username": "xquikcom",
    "followers": 10000,
    "verified": true,
    "profilePicture": "https://pbs.twimg.com/profile_images/xquik/photo.jpg"
  }
}
Next steps: Search Tweets to find tweets by query, or Get User to look up the author profile.
Last modified on May 24, 2026