Twitter Tweet Detail

API docs
https://api.sandbase.ai/v1/api/twitter/web/tweet-detail

Get a single tweet (X post) by ID: full text, author, media, and like, retweet, reply, quote, bookmark and view counts.

Price
$0.001USD / call
Method
POST
Response
JSON
Parameters
1 required · 0 optional
100 free calls / dayFirst 100 calls per day free (shared per organization) · Resets at 00:00 UTC. Pay per call after that.

Playground

Input
Tweet ID, can be obtained from the tweet link. For example: 1808168603721650364 in https://x.com/elonmusk/status/1808168603721650364
OutputExample
Responseoutputs · 3.6 KB · 136 lines
[
  {
    "data": {
      "author": {
        "blue_verified": true,
        "image": "https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_normal.jpg",
        "name": "Elon Musk",
        "rest_id": "44196397",
        "screen_name": "elonmusk",
        "sub_count": 241421603,
        "verification": null
      },
      "bookmarks": 6630,
      "conversation_control": {
        "policy": null
      },
      "conversation_id": "1808168603721650364",
      "created_at": "Tue Jul 02 15:59:23 +0000 2024",
      "display_text": "The New York Times is attacking *your* freedom of speech!",
      "entities": {
        "hashtags": [],
        "media": [
          {
            "display_url": "pic.x.com/TRIa13TWdY",
            "expanded_url": "https://x.com/elonmusk/status/1808168603721650364/photo/1",
            "ext_media_availability": {
              "status": "Available"
            },
            "features": {
              "large": {
                "faces": []
              },
              "medium": {
                "faces": []
              },
              "orig": {
                "faces": []
              },
              "small": {
                "faces": []
              }
            },
            "id_str": "1808168600894689280",
            "indices": [
              58,
              81
            ],
            "media_key": "3_1808168600894689280",
            "media_results": {
              "result": {
                "media_key": "3_1808168600894689280"
              }
            },
            "media_url_https": "https://pbs.twimg.com/media/GRfnwy5X0AAwIK2.jpg",
            "original_info": {
              "focus_rects": [
                {
                  "h": 355,
                  "w": 634,
                  "x": 20,
                  "y": 0
                },
                {
                  "h": 355,
                  "w": 355,
                  "x": 160,
                  "y": 0
                },
                {
                  "h": 355,
                  "w": 311,
                  "x": 182,
                  "y": 0
                },
                "… 2 more items in the full response"
              ],
              "height": 355,
              "width": 712
            },
            "sizes": {
              "large": {
                "h": 355,
                "resize": "fit",
                "w": 712
              },
              "medium": {
                "h": 355,
                "resize": "fit",
                "w": 712
              },
              "small": {
                "h": 339,
                "resize": "fit",
                "w": 680
              },
              "thumb": {
                "h": 150,
                "resize": "crop",
                "w": 150
              }
            },
            "type": "photo",
            "url": "https://t.co/TRIa13TWdY"
          }
        ],
        "symbols": [],
        "timestamps": [],
        "urls": [],
        "user_mentions": []
      },
      "id": "1808168603721650364",
      "in_reply_to_screen_name": null,
      "in_reply_to_status_id_str": null,
      "in_reply_to_user_id_str": null,
      "initial_tweets": null,
      "lang": "en",
      "likes": 284243,
      "media": {
        "photo": [
          {
            "id": "1808168600894689280",
            "media_url_https": "https://pbs.twimg.com/media/GRfnwy5X0AAwIK2.jpg"
          }
        ]
      },
      "quotes": 3901,
      "replies": 19281,
      "reply_to": null,
      "retweets": 52539,
      "sensitive": false,
      "status": "active",
      "text": "The New York Times is attacking *your* freedom of speech! https://t.co/TRIa13TWdY",
      "views": "53720642"
    }
  }
]

Examples

Select an example to load its inputs and result into the playground.

API README

Tweet Detail API

Returns one tweet (X post) with its full text, author, media, reply context and engagement counts. It needs one input, the decimal identifier tweet_id encoded as a string.

Use cases

  • Read selected post counters at chosen observation times; any repeated workflow needs a separate interval and call budget.
  • Fetch the full text and media URLs of a tweet cited in a report or news article.
  • Check whether a post is still active before you use it in a dashboard.
  • Pull the author's follower count and verification flag for a post you want to review.

Request

curl -X POST "https://api.sandbase.ai/v1/api/twitter/web/tweet-detail" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "1808168603721650364"}'

The result is returned in outputs[0].data.

Parameters

NameTypeRequiredDescription
tweet_idstringYesTweet ID, can be obtained from the tweet link. For example: 1808168603721650364 in https://x.com/elonmusk/status/1808168603721650364

Example response

Real response for the request above, trimmed: lists keep their first item and long strings are cut.

{
  "author": {
    "blue_verified": true,
    "image": "https://pbs.twimg.com/profile_images/2103567689515954176/aR-Kjpp4_normal.jpg",
    "name": "Elon Musk",
    "rest_id": "44196397",
    "screen_name": "elonmusk",
    "sub_count": 241472212,
    "verification": null
  },
  "bookmarks": 6534,
  "conversation_control": {
    "policy": null
  },
  "conversation_id": "1808168603721650364",
  "created_at": "Tue Jul 02 15:59:23 +0000 2024",
  "display_text": "The New York Times is attacking *your* freedom of speech!",
  "entities": {
    "hashtags": [],
    "media": [
      {
        "display_url": "pic.x.com/TRIa13TWdY",
        "expanded_url": "https://x.com/elonmusk/status/1808168603721650364/photo/1",
        "ext_media_availability": {
          "status": "Available"
        },
        "features": {
          "large": {
            "faces": []
          },
          "medium": {
            "faces": []
          },
          "orig": {
            "faces": []
          },
          "small": {
            "faces": []
          }
        },
        "id_str": "1808168600894689280",
        "indices": [
          58
        ],
        "media_key": "3_1808168600894689280",
        "media_results": {
          "result": {
            "media_key": "3_1808168600894689280"
          }
        },
        "media_url_https": "https://pbs.twimg.com/media/GRfnwy5X0AAwIK2.jpg",
        "original_info": {
          "focus_rects": [
            {
              "h": 355,
              "w": 634,
              "x": 20,
              "y": 0
            }
          ],
          "height": 355,
          "width": 712
        },
        "sizes": {
          "large": {
            "h": 355,
            "resize": "fit",
            "w": 712
          },
          "medium": {
            "h": 355,
            "resize": "fit",
            "w": 712
          },
          "small": {
            "h": 339,
            "resize": "fit",
            "w": 680
          },
          "thumb": {
            "h": 150,
            "resize": "crop",
            "w": 150
          }
        },
        "type": "photo"
      }
    ],
    "symbols": [],
    "timestamps": [],
    "urls": [],
    "user_mentions": []
  },
  "id": "1808168603721650364",
  "in_reply_to_screen_name": null,
  "in_reply_to_status_id_str": null,
  "in_reply_to_user_id_str": null,
  "initial_tweets": null
}

Response fields

FieldMeaning
id / conversation_idThe tweet ID and the ID of the conversation it belongs to. They match for a post that starts a conversation.
text / display_texttext is the post text with the media short link at the end. display_text is the same text without the link.
created_atPost time as a string, for example Tue Jul 02 15:59:23 +0000 2024.
likes / retweets / replies / quotes / bookmarksEngagement counts for the post, as numbers.
viewsView count. It comes back as a string, for example 53722244.
author.screen_name / author.name / author.rest_idThe author's handle, display name and numeric user ID.
author.sub_count / author.blue_verifiedsub_count is a count tied to the author account and is 241472212 in this response. blue_verified is a true or false flag for the author's verification.
media.photo[].media_url_httpsDirect image URL for each photo attached to the tweet.
entities.media[].type / entities.media[].media_url_httpsThe media type, such as photo, and its image URL. The entry also has sizes and the short url used in the text.
status / lang / sensitivePost state (active here), language code, and a flag for sensitive content.

Notes

  • Take tweet_id from the tweet link. In https://x.com/elonmusk/status/1808168603721650364 the ID is 1808168603721650364.
  • Reply fields such as in_reply_to_status_id_str and reply_to are null when the tweet is not a reply.
  • To read the replies to a tweet, use Twitter (X) Tweet Comments.
  • To list the accounts that retweeted it, use Twitter (X) Retweet User List.

Pricing

$0.001 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.

Read one selected X post snapshot

Take the decimal identifier from a selected status URL and send it as the string tweet_id. The schema example is 1808168603721650364. Do not send the URL, a handle or a JavaScript Number: this identifier exceeds the safe integer range. Preserve the exact string in your request and stored record; conversion after rounding cannot recover it.

Check completed SandBase status and an object at outputs[0].data, then inspect the flat business object. The selected full saved examples contain status active and an exact string id, not data.tweet or a search-result list. Compare id with the selected tweet_id. A missing or mismatched identity or a non-active status should stop a report of a retrieved active post, even when the outer request completed. Missing text limits text analysis; an empty text field alone does not prove the post is absent. Do not invent a code/message success flag.

The public page has five saved examples dated August 20, 2026. These are historical observations of one post; the shortened README is separate reference material. This revision did not run a new lookup or a monitoring interval. The saved examples do not establish current availability, refresh latency or how frequently upstream counters change.

Keep views as its returned string and likes, retweets, replies, quotes and bookmarks under their own field names. Missing or null counts remain unknown, not zero. author.sub_count is associated with the author, not the selected post's views. Store your observation time separately from the post's created_at string and the catalog example timestamp. One snapshot cannot measure growth, unique viewers or engagement velocity.

For a later comparison, select an explicit budget and interval, then compare the same string post ID and metric definition across valid observations. Preserve decreases, missing values and changes in visibility as observations instead of forcing a positive growth curve. A difference in counters is not a count of distinct new people, and a failed read is not a zero-valued sample. This guide does not start a scheduler, retry loop or automatic collection of replies.

conversation_id and in_reply_to_status_id_str describe context; they do not contain the conversation. A null reply_to or initial_tweets field does not prove that nobody replied. Media URLs and quoted or linked records are references, not already downloaded or verified source material. Do not execute embedded content or follow media and comments automatically. Author verification flags are displayed signals, not independent identity verification.

Give your agent one post task

Share the setup Skill, Markdown quickstart, selected post URL or exact string ID and the fields you need. Keep SANDBASE_API_KEY locally; use Bearer authentication with POST /v1/api/twitter/web/tweet-detail. Ask the agent to inspect the current schema, check one response and return the exact source ID, observation time and unknown fields.

Pricing checked on November 8, 2026 lists $0.001 per call and eligibility for 100 daily calls shared across eligible data APIs in the organization, resetting at 00:00 UTC. Eligibility is not your remaining allowance. Repeated reads need an explicit call budget; no new business or paid request was made for this revision. The X post snapshot tutorial explains response validation and the boundaries of historical monitoring examples.

Explore more

Related APIs

All APIs
APIPriceResponse
Twitter$0.001 per callJSON
Twitter$0.001 per callJSON
Twitter$0.001 per callJSON
Twitter$0.001 per callJSON
Twitter$0.001 per callJSON
Twitter$0.001 per callJSON

Questions

FAQ

How do I use the Twitter Tweet Detail API?

Send a POST request to https://api.sandbase.ai/v1/api/twitter/web/tweet-detail with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Twitter Tweet Detail API cost?

$0.001 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the Twitter Tweet Detail API accept?

Required: tweet_id (string). The Parameters table and the Playground on this page list every field.

What does the Twitter Tweet Detail API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Twitter developer account or API key?

No. Twitter Tweet Detail runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Twitter API access separately.

Should tweet_id be a number or a string?

Send the exact decimal ID as a string. The schema requires tweet_id, not a status URL or handle. Large IDs exceed JavaScript’s safe integer range; preserve the original string and compare it with the returned id before storing a successful observation.

Does a completed request prove that an active post was retrieved?

No. Check outputs[0].data as a flat object, then verify the business status and exact returned id. The saved examples show status active; missing identity, a mismatch or another status must not become an active-post report. Missing text limits text analysis; empty text alone does not establish an absent post. No new live lookup was performed for this guide.

Can a saved response or two counters prove real-time audience growth?

No. The five saved examples are historical observations dated August 20. Keep views as a string, each metric name and observation time, and preserve missing values. Counter differences do not establish unique people or freshness guarantees; errors are not zero samples and repeated reads require a chosen budget.