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

NameTypeRequirementDescription
tweet_idstringRequiredNumeric X post ID, up to 32 digits. Take it from the post URL: x.com/<user>/status/<tweet_id>.

Response fields

FieldTypeDescription
tweetobjectThe post. See the fields below.
id / text / created_at / lang / urlstringPost identity, text, X's created_at string, language, and permalink.
likes / retweets / replies / quotes / bookmarks / viewsnumberEach has a *_status field: present, not_exposed, or parser_miss. Optional: a metric X hides is omitted, never zero.
authorobjectid, username, name, verified, blue_verified, profile_image_url.
media[] / hashtags[] / urls[] / mentions[]arrayAttachments (type, url, preview_url), hashtags, links (url, display_url, expanded_url), and mentioned usernames. Always present; empty when none.
is_reply / is_retweet / is_quotebooleanPost 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
  }
}