tweet_idstringrequired
Tweet ID, can be obtained from the tweet link. For example: 1808168603721650364 in https://x.com/elonmusk/status/1808168603721650364
https://api.sandbase.ai/v1/api/twitter/web/tweet-detailGet a single tweet (X post) by ID: full text, author, media, and like, retweet, reply, quote, bookmark and view counts.
[
{
"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"
}
}
]Select an example to load its inputs and result into the playground.
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.
active before you use it in a dashboard.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.
| Name | Type | Required | Description |
|---|---|---|---|
tweet_id | string | Yes | Tweet ID, can be obtained from the tweet link. For example: 1808168603721650364 in https://x.com/elonmusk/status/1808168603721650364 |
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
}
| Field | Meaning |
|---|---|
id / conversation_id | The tweet ID and the ID of the conversation it belongs to. They match for a post that starts a conversation. |
text / display_text | text is the post text with the media short link at the end. display_text is the same text without the link. |
created_at | Post time as a string, for example Tue Jul 02 15:59:23 +0000 2024. |
likes / retweets / replies / quotes / bookmarks | Engagement counts for the post, as numbers. |
views | View count. It comes back as a string, for example 53722244. |
author.screen_name / author.name / author.rest_id | The author's handle, display name and numeric user ID. |
author.sub_count / author.blue_verified | sub_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_https | Direct image URL for each photo attached to the tweet. |
entities.media[].type / entities.media[].media_url_https | The media type, such as photo, and its image URL. The entry also has sizes and the short url used in the text. |
status / lang / sensitive | Post state (active here), language code, and a flag for sensitive content. |
tweet_id from the tweet link. In https://x.com/elonmusk/status/1808168603721650364 the ID is 1808168603721650364.in_reply_to_status_id_str and reply_to are null when the tweet is not a reply.$0.001 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.
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.
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.
Start building
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/twitter/web/tweet-detail" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"tweet_id": "1808168603721650364"
}
SANDBASE_JSON
)
printf '%s\n' "$result"Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
tweet_idstringrequiredTweet ID, can be obtained from the tweet link. For example: 1808168603721650364 in https://x.com/elonmusk/status/1808168603721650364
Saved example response for this API; no live request is made when viewing it.
[
{
"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"
}
}
]Explore more
| API | Price | Response |
|---|---|---|
Twitter Tweet DetailThis API Twitter | $0.001 per call | JSON |
Twitter | $0.001 per call | JSON |
Twitter | $0.001 per call | JSON |
Twitter | $0.001 per call | JSON |
Twitter | $0.001 per call | JSON |
Twitter | $0.001 per call | JSON |
Questions
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.
$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.
Required: tweet_id (string). The Parameters table and the Playground on this page list every field.
A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.
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.
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.
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.
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.