Docs/X Post Detail
Docs / API reference
POST/v1/data/twitter/tweet
X Post Detail
Get one X post by ID with text, author, engagement metrics, media, hashtags, links, and mentions.
Execution model
Live request
Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.
Credit weight
Live catalog
Current weights are managed from the Data API Weights admin table and shown on pricing before use.
Parameters
| Name | Type | Requirement | Description |
|---|---|---|---|
| tweet_id | string | Required | Numeric X post ID, up to 32 digits. Take it from the post URL: x.com/<user>/status/<tweet_id>. |
Response fields
| Field | Type | Description |
|---|---|---|
| tweet | object | The post. See the fields below. |
| id / text / created_at / lang / url | string | Post identity, text, X's created_at string, language, and permalink. |
| likes / retweets / replies / quotes / bookmarks / views | number | Each has a *_status field: present, not_exposed, or parser_miss. Optional: a metric X hides is omitted, never zero. |
| author | object | id, username, name, verified, blue_verified, profile_image_url. |
| media[] / hashtags[] / urls[] / mentions[] | array | Attachments (type, url, preview_url), hashtags, links (url, display_url, expanded_url), and mentioned usernames. Always present; empty when none. |
| is_reply / is_retweet / is_quote | boolean | Post kind. Reply, retweet and quote IDs (in_reply_to_*, retweeted_tweet_id, retweeted_tweet, quoted_tweet_id) appear only when they apply. |
Request and response
curl -X POST "https://api.datablue.dev/v1/data/twitter/tweet" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"tweet_id": "1850000000000000001"
}'Example response
{
"success": true,
"time_taken": 1.65,
"tweet": {
"id": "1850000000000000001",
"text": "A new image from the James Webb Space Telescope.",
"text_complete": true,
"created_at": "Mon Nov 10 15:00:00 +0000 2026",
"likes": 24000,
"likes_status": "present",
"retweets": 4800,
"retweets_status": "present",
"replies": 320,
"replies_status": "present",
"quotes": 180,
"quotes_status": "present",
"bookmarks": 900,
"bookmarks_status": "present",
"views": 1200000,
"views_status": "present",
"lang": "en",
"url": "https://x.com/NASA/status/1850000000000000001",
"author": {
"id": "11348282",
"username": "NASA",
"name": "NASA",
"blue_verified": true,
"profile_image_url": "https://pbs.twimg.com/profile_images/example_400x400.jpg"
},
"media": [
{
"type": "photo",
"url": "https://pbs.twimg.com/media/example.jpg"
}
],
"hashtags": [
"JWST"
],
"urls": [],
"mentions": [],
"conversation_id": "1850000000000000001",
"is_reply": false,
"is_retweet": false,
"is_quote": false
}
}