> ## 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.
# Get tweets (batch)
> Retrieve multiple tweets by ID in a single request, up to 100 at a time
For the complete documentation index, see llms.txt.
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](https://xquik.com/#pricing) from \$0.00012/credit
```bash cURL theme={null}
curl "https://xquik.com/api/v1/x/tweets?ids=1893456789012345678,1893456789012345679" \
-H "x-api-key: xq_YOUR_KEY_HERE" | jq
```
```javascript Node.js theme={null}
const ids = ["1893456789012345678", "1893456789012345679"];
const response = await fetch(
`https://xquik.com/api/v1/x/tweets?ids=${ids.join(",")}`,
{
headers: { "x-api-key": "xq_YOUR_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));
```
```python Python theme={null}
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_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 shape durable tweet rows instead of printing
full response pages. Persist `tweetRows` or `tweet_rows` and `missingIds` or
`missing_ids` with the original ID list so retries only request missing tweets.
## Direct batch tweet handoff
Use `GET /x/tweets` when a CRM, warehouse, newsroom, moderation queue, or agent
workflow already has tweet IDs and needs tweet text, authors, metrics, media
URLs, and missing-ID handling in one response. Use [Get Tweet](/api-reference/x/get-tweet)
when you need one tweet by ID, or [Search Tweets](/api-reference/x/search-tweets)
when you need 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` instead of relying 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`.
## Query parameters
Comma-separated tweet IDs. Maximum 100 per request.
## Headers
Your API key. Session cookie authentication is also supported.
## Response
Array of tweets matching the requested IDs.
Tweet ID.
Tweet text.
Tweet type. Omitted if unavailable.
ISO 8601 creation timestamp.
Whether this is a Note Tweet. Omitted if unavailable.
Like count. Omitted if unavailable.
Retweet count. Omitted if unavailable.
Reply count. Omitted if unavailable.
Quote tweet count. Omitted if unavailable.
View count. Omitted if unavailable.
Bookmark count. Omitted if unavailable.
Permalink URL on X. Omitted if unavailable.
Tweet language code. Omitted if unavailable.
Whether the tweet is a reply. Omitted if unavailable.
Tweet ID being replied to. Omitted if not a reply.
User ID being replied to. Omitted if unavailable.
Username being replied to. Omitted if unavailable.
Conversation thread ID. Omitted if unavailable.
Client used to post the tweet. Omitted if unavailable.
Start and end offsets for rendered tweet text. Omitted if unavailable.
Whether replies are limited. Omitted if unavailable.
Whether this tweet quotes another tweet. Omitted if unavailable.
Parsed entities. Omitted if unavailable.
Disclosure metadata for paid partnership and AI-generated media labels. Includes `advertising.isPaidPromotion` and `aiGenerated.hasAiGeneratedMedia` when X returns them. Omitted if unavailable.
Tweet author profile. Omitted if unavailable.
Author user ID.
Author handle without `@`.
Author display name. Omitted if unavailable.
Follower count. Omitted if unavailable.
Whether the author is verified. Omitted if unavailable.
Author profile image URL. Omitted if unavailable.
Media attachments. Omitted when the tweet has no media.
Direct media URL.
Media type.
Shortened URL from the tweet text.
Embedded quoted tweet. Omitted if not a quote tweet.
Original retweeted tweet. Omitted if not a retweet.
Always `false` for batch requests.
Always empty for batch requests.
```json theme={null}
{
"tweets": [
{
"id": "1893456789012345678",
"text": "Hello world!",
"createdAt": "2026-03-27T10:00:00.000Z",
"likeCount": 42,
"retweetCount": 5,
"author": {
"id": "9876543210",
"username": "xquikcom",
"name": "Xquik",
"followers": 12000,
"verified": true,
"profilePicture": "https://pbs.twimg.com/profile_images/example.jpg"
}
}
],
"has_next_page": false,
"next_cursor": ""
}
```
```json theme={null}
{ "error": "missing_ids", "message": "ids parameter required" }
```
```json theme={null}
{ "error": "too_many_ids", "message": "Max 100 IDs per request" }
```
```json theme={null}
{ "error": "unauthenticated" }
```
```json theme={null}
{ "error": "no_subscription" }
```
No active subscription or insufficient credits. Possible error values: `no_subscription`, `subscription_inactive`, `no_credits`, `insufficient_credits`.
```json theme={null}
{ "error": "x_api_unavailable" }
```
The read service returned an error. Retry after a short delay.
```json theme={null}
{ "error": "rate_limit_exceeded", "retryAfter": 60 }
```
Your tier rate limit was exceeded. Wait for the `Retry-After` header before retrying.
```json theme={null}
{ "error": "x_api_unavailable" }
```
The normalized v1 response contract can return 424 when the read service is unavailable.
**Related:** [Batch Users](/api-reference/x/batch-users) · [Get Tweet](/api-reference/x/get-tweet)