Tweet lookup API, post details & engagement counts

{
  "tweet": {
    "id": "1234567890",
    "text": "New feature",
    "retweetCount": 5,
    "replyCount": 3,
    "likeCount": 42
  }
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "tweet_not_found",
  "message": "Tweet not found. Check the tweet ID."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

GET

tweets

{id}

Tweet lookup API, post details & engagement counts

curl --request GET \
  --url https://xquik.com/api/v1/x/tweets/{id}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/tweets/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "tweet": {
    "media": [
      {}
    ]
  },
  "author": {}
}

1 credit per call · All plans from $0.00012/credit · Direct MPP: USD 0.00015 per call

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

See Read Data Richness for every optional tweet, author, and media field.

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

const tweetId = "1893456789012345678";
const response = await fetch(`https://xquik.com/api/v1/x/tweets/${tweetId}`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const data = await response.json();
const tweet = data.tweet;
const author = data.author ?? {};
const media = tweet.media ?? [];
const quotedTweet = tweet.quoted_tweet;
const handoff = {
  tweet_id: tweet.id,
  text: tweet.text,
  author_id: author.id ?? null,
  author_username: author.username ?? null,
  author_followers: author.followers ?? null,
  author_verified: author.verified ?? null,
  author_profile_picture: author.profilePicture ?? null,
  created_at: tweet.createdAt ?? null,
  conversation_id: tweet.conversationId ?? null,
  is_reply: tweet.isReply === true,
  is_quote_status: tweet.isQuoteStatus === true,
  is_note_tweet: tweet.isNoteTweet === true,
  tweet_source: tweet.source ?? null,
  quote_tweet_id: quotedTweet?.id ?? null,
  metrics: {
    retweets: tweet.retweetCount ?? 0,
    replies: tweet.replyCount ?? 0,
    likes: tweet.likeCount ?? 0,
    quotes: tweet.quoteCount ?? 0,
    views: tweet.viewCount ?? 0,
    bookmarks: tweet.bookmarkCount ?? 0,
  },
  media_urls: media.map((item) => item.mediaUrl),
};
process.stdout.write(`${JSON.stringify(handoff)}\n`);

import json
import requests

tweet_id = "1893456789012345678"
response = requests.get(
    f"https://xquik.com/api/v1/x/tweets/{tweet_id}",
    headers={"x-api-key": "xq_your_api_key_here"},
)
data = response.json()
tweet = data["tweet"]
author = data.get("author") or {}
media = tweet.get("media", [])
quoted_tweet = tweet.get("quoted_tweet") or {}
handoff = {
    "tweet_id": tweet["id"],
    "text": tweet["text"],
    "author_id": author.get("id"),
    "author_username": author.get("username"),
    "author_followers": author.get("followers"),
    "author_verified": author.get("verified"),
    "author_profile_picture": author.get("profilePicture"),
    "created_at": tweet.get("createdAt"),
    "conversation_id": tweet.get("conversationId"),
    "is_reply": tweet.get("isReply") is True,
    "is_quote_status": tweet.get("isQuoteStatus") is True,
    "is_note_tweet": tweet.get("isNoteTweet") is True,
    "tweet_source": tweet.get("source"),
    "quote_tweet_id": quoted_tweet.get("id"),
    "metrics": {
        "retweets": tweet.get("retweetCount", 0),
        "replies": tweet.get("replyCount", 0),
        "likes": tweet.get("likeCount", 0),
        "quotes": tweet.get("quoteCount", 0),
        "views": tweet.get("viewCount", 0),
        "bookmarks": tweet.get("bookmarkCount", 0),
    },
    "media_urls": [item["mediaUrl"] for item in media],
}
print(json.dumps(handoff))

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. For workflows that accept pasted Tweet URLs, call Search tweets with the URL in q and omit cursor, sinceTime, and untilTime. URLs, usernames, and short IDs still return 400 invalid_tweet_id on this path endpoint. 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.

Store a tweet lookup record

Use the numeric Tweet ID as the stable key. Keep text, author, thread, quote, engagement, media, and disclosure fields as separate columns instead of flattening the response into one unsearchable value.

Tweet record column	Response source	Handoff rule
`tweet_id`	`tweet.id`	Use as the stable tweet upsert key.
`tweet_url`	`tweet.url`	Preserve the original X permalink when returned.
`text`	`tweet.text`	Store the complete returned tweet or Note Tweet text.
`created_at`	`tweet.createdAt`	Preserve the tweet publication time.
`author_id`	`author.id`	Keep a stable author identity when usernames change.
`author_username`	`author.username`	Display the current author handle.
`conversation_id`	`tweet.conversationId`	Join the tweet to its conversation thread.
`in_reply_to_id`	`tweet.inReplyToId`	Join replies to their immediate parent tweet.
`quote_tweet_id`	`tweet.quoted_tweet.id`	Preserve quoted-tweet attribution when present.
`is_note_tweet`	`tweet.isNoteTweet`	Distinguish long-form Note Tweet text.
`like_count`	`tweet.likeCount`	Store the observed engagement count with lookup time.
`reply_count`	`tweet.replyCount`	Route active conversation threads for review.
`media_urls`	`tweet.media[].mediaUrl`	Preserve image, video, or animated GIF URLs.
`content_disclosure`	`tweet.contentDisclosure`	Preserve paid-promotion or AI-media labels when returned.

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

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, verification filters, or pasted Tweet URL exact lookup.

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

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here authenticates paid_reads guest keys. Direct MPP uses the Payment ... credential. Get it from the WWW-Authenticate: Payment challenge.

Response

200 OK

object

The tweet data. Tweet object fields.

string

Tweet ID.

string

Tweet text content. For Note Tweets (long-form posts), returns the complete text up to 25,000 characters.

string

ISO 8601 creation timestamp.

boolean

Whether this is a Note Tweet (long-form post, up to 25,000 characters). Omitted when false.

boolean

Whether this tweet is a reply to another tweet. Omitted when false.

boolean

Whether X limits who can reply. Omitted if unavailable.

boolean

Whether this tweet quotes another tweet. Omitted when false.

string

ID of the root tweet in the conversation thread.

object

Public reply policy and conversation owner. Omitted if unavailable.

object[]

Public interaction restrictions. Omitted if unavailable.

string[]

Users that left this conversation. Omitted if unavailable.

string

Tweet ID this post replies to. Omitted when not a reply.

string

User ID this post replies to. Omitted when unavailable.

string

Username this post replies to. Omitted when unavailable.

string

Client application used to post this tweet.

string

Tweet type. Omitted if unavailable.

string

Tweet permalink. Omitted if unavailable.

string

Tweet language code. Omitted if unavailable.

number[]

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

object

Parsed entities from the tweet text (URLs, mentions, hashtags, media).

object

Disclosure metadata for paid partnership and AI-generated media labels. Includes advertising.isPaidPromotion and aiGenerated.hasAiGeneratedMedia when X returns them. Omitted if unavailable.

string

Community ID. Omitted outside communities.

string

Quoted tweet ID. Omitted when unavailable.

object

The quoted tweet object. Present when isQuoteStatus is true.

object

The original tweet when this post is a repost. Omitted otherwise.

object

Unavailable tweet metadata. Omitted for available tweets.

number

Retweet count.

number

Reply count.

number

Like count.

number

Quote tweet count.

number

View count.

number

Bookmark count.

object[]

Attached media items. Omitted when the tweet has no attached media. Media item fields.

string

Direct media URL (pbs.twimg.com).

object[]

Available video renditions with bitrate, content type, and URL. Omitted for images.

string

Media type: photo, video, or animated_gif.

string

Shortened t.co URL from the tweet text.

object

The tweet author. Omitted if author data is unavailable. Author object fields.

string

Author user ID.

string

Author handle without @.

string

Author display name.

integer

Follower count.

boolean

Whether X marks the author as verified.

string

Author profile image URL.

{
  "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",
    "contentDisclosure": {
      "advertising": { "isPaidPromotion": true },
      "aiGenerated": {
        "detectionSource": "UserDeclared",
        "hasAiGeneratedMedia": true
      }
    },
    "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": "username",
    "followers": 10000,
    "verified": true,
    "profilePicture": "https://pbs.twimg.com/profile_images/xquik/photo.jpg"
  }
}

400 Invalid tweet ID

{ "error": "invalid_tweet_id" }

The provided tweet ID is empty or not a valid format.

401 Unauthenticated

{ "error": "unauthenticated" }

Missing or invalid API key. Check the x-api-key header value.

402 Payment required

Account keys get account options; guest keys get guest top-up only. Anonymous calls receive a direct MPP WWW-Authenticate: Payment challenge plus a guest wallet creation action. No checkout starts automatically. Confirm any payment action.

404 Tweet not found

{ "error": "tweet_not_found" }

The tweet does not exist. It may have been deleted or the ID is invalid.

502 X API unavailable

{ "error": "x_api_unavailable" }

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

429 Rate limit exceeded

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

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

424 Dependency failed

{ "error": "x_api_unavailable" }

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

Next steps. Search Tweets to find tweets by query, or Get User to look up the author profile.

{
  "tweet": {
    "id": "1234567890",
    "text": "New feature",
    "retweetCount": 5,
    "replyCount": 3,
    "likeCount": 42
  }
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "tweet_not_found",
  "message": "Tweet not found. Check the tweet ID."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

Tweet lookup API, post details & engagement counts

curl --request GET \
  --url https://xquik.com/api/v1/x/tweets/{id}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/tweets/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "tweet": {
    "media": [
      {}
    ]
  },
  "author": {}
}

​Direct tweet handoff

Single row

Author context

Quote context

Conversation joins

Long-form tweets

Media assets

​Store a tweet lookup record

​Path parameters

​Which tweet endpoint?

One tweet by ID

Many tweet IDs

Keyword or advanced search

Thread context

Engagement lists

Saved exports

​Headers

​Response

​200 OK

​400 Invalid tweet ID

​401 Unauthenticated

​402 Payment required

​404 Tweet not found

​502 X API unavailable

​429 Rate limit exceeded

​424 Dependency failed

Direct tweet handoff

Store a tweet lookup record

Path parameters

Which tweet endpoint?

Headers

Response

200 OK

400 Invalid tweet ID

401 Unauthenticated

402 Payment required

404 Tweet not found

502 X API unavailable

429 Rate limit exceeded

424 Dependency failed