API referenceX
X details
One post on X, in the standard content shape.
Reads a single post from its URL, with its engagement counts, text and media.
Quote posts, replies and reposts are labelled as such, and the post they point at is resolved and attached rather than left as an identifier.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 2.3s.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/twitter-details" \ -H "Content-Type: application/json" \ -d '{ "url": "https://x.com/levelsio/status/2041112253349442037" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "data": { "additional": { "conversation_id": "2041112253349442037", "creator_demographics": { "created_at": "Mon Jul 08 09:31:59 +0000 2013", "description": "💸https://t.co/sQ0aiU7v02\n📸https://t.co/lAyoqmSBRX $80K/m\n🎮https://t.co/tF49atJ396 $44K/m\n🏡https://t.co/1oqUgfD6CZ $23K/m\n👙@X $20K/m\n🌍https://t.co/UXK5AFqCaQ $15K/m\n💾https://t.co/T74ZwJ1F0C\n🏩https://t.co/4p4dzTDVN6\n📝https://t.co/8VnHmB3uah", "favourites_count": 180922, "followers_count": 935522, "friends_count": 3181, "is_blue_verified": true, "listed_count": 9902, "location": "📕My book $7K/m 👉", "media_count": 19498, "profile_banner_url": "https://pbs.twimg.com/profile_banners/1577241403/1665964220", "protected": false, "statuses_count": 178772, "verified": false, "verified_type": null }, "in_reply_to_handle": null, "in_reply_to_post_id": null, "is_reply": false, "is_retweet": false, "quoted_post": null, "retweeted_post_id": null, "tweet_raw_metrics": { "bookmark_count": 1132, "favorite_count": 5816, "is_quote_status": false, "lang": "en", "possibly_sensitive": false, "quote_count": 48, "reply_count": 463, "retweet_count": 157, "retweeted_source": null, "source": "<a href=\"http://twitter.com/download/iphone\" rel=\"nofollow\">Twitter for iPhone</a>" }, "video_duration_seconds": 10.868, "video_height": 2868, "video_width": 1320 }, "main": { "caption": "Tried Gemma 4 ran locally on my iPhone today\n\nI thought it'd be useful in case the apocalypse happens and I need to ask it for survival tips\n\nLike how to make a fire 🔥 \n\nI guess I'll freeze to death instead 🫠 https://t.co/lFHKm5mcnd", "comment_count": 463, "content_type": "video", "creator_handle": "levelsio", "hashtags": [], "images": [], "in_reply_to_handle": null, "in_reply_to_post_id": null, "is_quote": false, "is_reply": false, "is_repost": false, "is_video": true, "like_count": 5816, "post_id": "2041112253349442037", "post_url": "https://x.com/levelsio/status/2041112253349442037", "profile_picture_url": "https://pbs.twimg.com/profile_images/2077111020305162240/PwddgOau.jpg", "quoted_post": null, "reposted_post": null, "save_count": 1132, "share_count": 205, "slideshow_status": false, "thumbnail_url": "https://pbs.twimg.com/amplify_video_thumb/2041112129609027584/img/ce2x6l6p3lZ9FRb6.jpg", "upload_timestamp": 1775474057, "video_url": "https://video.twimg.com/amplify_video/2041112129609027584/vid/avc1/1320x2868/7yerHxvfTgDcXPTk.mp4?tag=21", "video_urls_by_quality": { "high": "https://video.twimg.com/amplify_video/2041112129609027584/vid/avc1/1320x2868/7yerHxvfTgDcXPTk.mp4?tag=21", "low": "https://video.twimg.com/amplify_video/2041112129609027584/vid/avc1/320x694/4t0LkNnzCDDygpS-.mp4?tag=21", "medium": "https://video.twimg.com/amplify_video/2041112129609027584/vid/avc1/720x1564/0jSomIFIBOiJeOE8.mp4?tag=21", "watermarked": null }, "view_count": 614651 } } }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "twitter-details", "billable": true, "duration_ms": 1813 }}