Twitter batch tweet lookup API & post details

{
  "tweets": [
    {
      "id": "1234567890",
      "text": "Just launched our new feature!",
      "createdAt": "2025-01-15T12:00:00Z",
      "likeCount": 42,
      "retweetCount": 5
    }
  ],
  "has_next_page": false,
  "next_cursor": ""
}

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

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

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

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

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

tweets

Twitter batch tweet lookup API & post details

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

package main

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

func main() {

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

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

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

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

	fmt.Println(string(body))

}

{
  "tweets": [
    {
      "id": "<string>",
      "text": "<string>",
      "type": "<string>",
      "createdAt": "<string>",
      "isNoteTweet": true,
      "isPinned": true,
      "likeCount": 123,
      "retweetCount": 123,
      "replyCount": 123,
      "quoteCount": 123,
      "viewCount": 123,
      "bookmarkCount": 123,
      "url": "<string>",
      "lang": "<string>",
      "isReply": true,
      "inReplyToId": "<string>",
      "inReplyToUserId": "<string>",
      "inReplyToUsername": "<string>",
      "conversationId": "<string>",
      "source": "<string>",
      "displayTextRange": [
        123
      ],
      "isLimitedReply": true,
      "isQuoteStatus": true,
      "isRetweet": true,
      "entities": {},
      "contentDisclosure": {},
      "author": {},
      "media": [
        {}
      ],
      "quoted_tweet": {},
      "retweeted_tweet": {}
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

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.

When to use batch lookup

Use this route to look up as many as 100 tweet IDs at once. It charges only for returned tweets. Use list-tweets when reading a list feed instead.

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 · Accepts account credits and guest paid_reads

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

const ids = ["1893456789012345678", "1893456789012345679"];
const response = await fetch(`https://xquik.com/api/v1/x/tweets?ids=${ids.join(",")}`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const data = await response.json();
const tweetsById = new Map(data.tweets.map((tweet) => [tweet.id, tweet]));
const tweetRows = data.tweets.map((tweet) => {
  const author = tweet.author ?? {};

  return {
    requested_ids: ids,
    tweet_id: tweet.id,
    text: tweet.text,
    author_id: author.id ?? null,
    author_username: author.username ?? null,
    author_name: author.name ?? 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,
    like_count: tweet.likeCount ?? null,
    reply_count: tweet.replyCount ?? null,
    retweet_count: tweet.retweetCount ?? null,
    quote_count: tweet.quoteCount ?? null,
    media_urls: tweet.media?.map((item) => item.mediaUrl).filter(Boolean) ?? [],
    has_next_page: data.has_next_page,
    next_cursor: data.next_cursor || null,
  };
});
const missingIds = ids.filter((id) => !tweetsById.has(id));

import requests

ids = ["1893456789012345678", "1893456789012345679"]
response = requests.get(
    "https://xquik.com/api/v1/x/tweets",
    params={"ids": ",".join(ids)},
    headers={"x-api-key": "xq_your_api_key_here"},
)
data = response.json()
tweets_by_id = {tweet["id"]: tweet for tweet in data["tweets"]}
tweet_rows = []
for tweet in data["tweets"]:
    author = tweet.get("author") or {}
    tweet_rows.append(
        {
            "requested_ids": ids,
            "tweet_id": tweet["id"],
            "text": tweet["text"],
            "author_id": author.get("id"),
            "author_username": author.get("username"),
            "author_name": author.get("name"),
            "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"),
            "like_count": tweet.get("likeCount"),
            "reply_count": tweet.get("replyCount"),
            "retweet_count": tweet.get("retweetCount"),
            "quote_count": tweet.get("quoteCount"),
            "media_urls": [
                item["mediaUrl"]
                for item in tweet.get("media", [])
                if item.get("mediaUrl")
            ],
            "has_next_page": data["has_next_page"],
            "next_cursor": data["next_cursor"] or None,
        }
    )

missing_ids = [tweet_id for tweet_id in ids if tweet_id not in tweets_by_id]

The Node.js and Python snippets build tweet rows. They do not print full response pages. Store tweetRows or tweet_rows and missingIds or missing_ids with the original ID list. Retries then request only missing tweets.

Direct batch tweet handoff

Use GET /x/tweets when a CRM, warehouse, newsroom, moderation queue, or agent workflow already has tweet IDs. One response returns tweet text, authors, metrics, media URLs, and missing-ID handling. Use Get Tweet for one tweet by ID. Use Search Tweets to find tweets by query. Store requested_ids, tweet_id, text, author_id, author_username, author_name, author_followers, author_verified, author_profile_picture, created_at, conversation_id, engagement counts, media URLs, has_next_page, and next_cursor. Join returned tweets by tweet_id. Do not rely on response order. Send at most 100 IDs per request. Batch requests always return has_next_page: false and next_cursor: "". Zero affordable results return 402 insufficient_credits.

Store exact batch lookup results

Keep the original request order separately. Join returned tweets by numeric Tweet ID because unavailable or unaffordable IDs can be absent.

Batch lookup column	Response source	Reconciliation rule
`batch_id`	Integration value	Group every requested and returned Tweet ID.
`requested_tweet_id`	Parsed `ids` input	Keep all requested IDs, including missing ones.
`tweet_id`	`tweets[].id`	Join a returned tweet to its request row.
`text`	`tweets[].text`	Keep the returned tweet or Note Tweet text.
`author_id`	`tweets[].author.id`	Keep a stable author key.
`author_username`	`tweets[].author.username`	Display the returned author handle.
`created_at`	`tweets[].createdAt`	Keep the tweet publication time.
`conversation_id`	`tweets[].conversationId`	Join returned tweets to conversation workflows.
`media_urls`	`tweets[].media[].mediaUrl`	Keep image and video URLs for returned tweets.
`lookup_status`	Derived from returned IDs	Set `returned` or `missing` for every requested ID.
`has_next_page`	Response value	Expect `false` for an exact batch request.
`next_cursor`	Response value	Expect an empty string. Never paginate an exact batch.

Input or result condition	Handling
More than 100 Tweet IDs	Split the IDs into batches of 100 or fewer.
Duplicate Tweet IDs	Deduplicate before sending. Keep source references separately.
Returned Tweet ID	Store the normalized row under the matching request ID.
Missing Tweet ID	Keep a missing row for targeted retry or review.
Low credit balance	Accept a smaller returned set and mark the missing IDs.
Zero affordable results	Stop on `402 insufficient_credits` and fund the account before retrying.

Query parameters

string

required

1 to 100 tweets, separated by commas. Each is a tweet ID or a tweet URL, such as x.com/nasa/status/20. A tweet named twice is read once.

Headers

string

Full account API key. Session cookie and OAuth authentication are also supported.

string

Send Bearer xq_your_guest_key_here for an active paid_reads guest key.

Response

200 OK

object[]

Array of tweets matching the requested IDs. Tweet object fields.

string

Tweet ID.

string

Tweet text.

string

Tweet type. Omitted if unavailable.

string

ISO 8601 creation timestamp.

boolean

Whether this is a Note Tweet. Omitted if unavailable.

boolean

Whether the author pinned this post to their profile. Omitted if unavailable.

number

Like count. Omitted if unavailable.

number

Retweet count. Omitted if unavailable.

number

Reply count. Omitted if unavailable.

number

Quote tweet count. Omitted if unavailable.

number

View count. Omitted if unavailable.

number

Bookmark count. Omitted if unavailable.

string

Permalink URL on X. Omitted if unavailable.

string

Tweet language code. Omitted if unavailable.

boolean

Whether the tweet is a reply. Omitted if unavailable.

string

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

string

User ID being replied to. Omitted if unavailable.

string

Username being replied to. Omitted if unavailable.

string

Conversation thread ID. Omitted if unavailable.

string

Client used to post the tweet. Omitted if unavailable.

number[]

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

boolean

Whether replies are limited. Omitted if unavailable.

boolean

Whether this tweet quotes another tweet. Omitted if unavailable.

boolean

Whether this row is a retweet. text carries the original post in full.

object

Parsed entities. Omitted if unavailable.

object

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

object

Tweet author profile. Omitted if unavailable. Author object fields.

string

Author user ID.

string

Author handle without @.

string

Author display name. Omitted if unavailable.

number

Follower count. Omitted if unavailable.

boolean

Whether the author is verified. Omitted if unavailable.

string

Author profile image URL. Omitted if unavailable.

object[]

Media attachments. Omitted when the tweet has no media. Media object fields.

string

Direct media URL.

object[]

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

string

Media type.

string

Shortened URL from the tweet text.

object

Embedded quoted tweet. Omitted if not a quote tweet.

object

Original retweeted tweet. Omitted if not a retweet.

boolean

Always false for batch requests.

string

Always empty for batch requests.

{
  "tweets": [
    {
      "id": "1893456789012345678",
      "text": "Hello world!",
      "createdAt": "2026-03-27T10:00:00.000Z",
      "likeCount": 42,
      "retweetCount": 5,
      "author": {
        "id": "9876543210",
        "username": "username",
        "name": "Xquik",
        "followers": 12000,
        "verified": true,
        "profilePicture": "https://pbs.twimg.com/profile_images/example.jpg"
      }
    }
  ],
  "has_next_page": false,
  "next_cursor": ""
}

400 Missing IDs

{ "error": "missing_ids", "message": "ids parameter required" }

400 Too many IDs

{ "error": "too_many_ids", "message": "Max 100 IDs per request" }

400 Invalid tweet ID

{
  "error": "invalid_tweet_id",
  "message": "Send ids as 1 to 100 tweet IDs or tweet links, separated by commas."
}

An entry of ids names no tweet. Send each entry as a tweet ID or a tweet URL. The request costs nothing.

401 Unauthenticated

Anonymous requests get WWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.

{ "error": "unauthenticated" }

402 Payment required

Full account keys can receive no_subscription, subscription_inactive, no_credits, or insufficient_credits with account payment options. Guest keys receive only the guest top-up action. The failed request creates no checkout. Ask the user to confirm before calling any checkout or top-up route.

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 }

You exceeded your tier rate limit. 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.

Related. Batch Users · Get Tweet

{
  "tweets": [
    {
      "id": "1234567890",
      "text": "Just launched our new feature!",
      "createdAt": "2025-01-15T12:00:00Z",
      "likeCount": 42,
      "retweetCount": 5
    }
  ],
  "has_next_page": false,
  "next_cursor": ""
}

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

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

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

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

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

Twitter batch tweet lookup API & post details

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

package main

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

func main() {

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

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

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

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

	fmt.Println(string(body))

}

{
  "tweets": [
    {
      "id": "<string>",
      "text": "<string>",
      "type": "<string>",
      "createdAt": "<string>",
      "isNoteTweet": true,
      "isPinned": true,
      "likeCount": 123,
      "retweetCount": 123,
      "replyCount": 123,
      "quoteCount": 123,
      "viewCount": 123,
      "bookmarkCount": 123,
      "url": "<string>",
      "lang": "<string>",
      "isReply": true,
      "inReplyToId": "<string>",
      "inReplyToUserId": "<string>",
      "inReplyToUsername": "<string>",
      "conversationId": "<string>",
      "source": "<string>",
      "displayTextRange": [
        123
      ],
      "isLimitedReply": true,
      "isQuoteStatus": true,
      "isRetweet": true,
      "entities": {},
      "contentDisclosure": {},
      "author": {},
      "media": [
        {}
      ],
      "quoted_tweet": {},
      "retweeted_tweet": {}
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Twitter batch tweet lookup API & post details

When to use batch lookup

Direct batch tweet handoff

Store exact batch lookup results

Query parameters

Headers

Response

200 OK

400 Missing IDs

400 Too many IDs

400 Invalid tweet ID

401 Unauthenticated

402 Payment required

502 X API unavailable

429 Rate limit exceeded

424 Dependency failed

​When to use batch lookup

​Direct batch tweet handoff

​Store exact batch lookup results

​Query parameters

​Headers

​Response

​200 OK

​400 Missing IDs

​400 Too many IDs

​400 Invalid tweet ID

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

​429 Rate limit exceeded

​424 Dependency failed

When to use batch lookup

Direct batch tweet handoff

Store exact batch lookup results

Query parameters

Headers

Response

200 OK

400 Missing IDs

400 Too many IDs

400 Invalid tweet ID

401 Unauthenticated

402 Payment required

502 X API unavailable

429 Rate limit exceeded

424 Dependency failed