Tweet
GET/v1/twitter/tweet1 credit
Returns a single post: full text, entities, media, like, reply, repost, quote, bookmark and view counts, and its author.
01Query parameters
| Name | Type | Description |
|---|---|---|
| urlrequired | string | The post's URL on x.com or twitter.com, e.g. `https://x.com/NASA/status/2110491624337760703`. |
| trimoptional | boolean | `true` returns only `rest_id`, `views` and `legacy`.Default: false |
| cache_max_ageoptional | string | Accepted for compatibility; every call is fetched fresh and costs the normal price. Any other value is a free 400.Accepted values:1d3d7d14d30d |
02Request
curl "https://api.scrapesocial.ai/v1/twitter/tweet?url=https%3A%2F%2Fx.com%2FNASA%2Fstatus%2F2110491624337760703" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Responses
Real answers from the API. Lists are shortened to 2 items.
GET /v1/twitter/tweet?url=https%3A%2F%2Fx.com%2FNASA%2Fstatus%2F2110491624337760703
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"__typename": "Tweet",
"content_disclosure": {
"ai_generated_disclosure": {
"can_edit": true,
"has_ai_generated_media": false
}
},
"core": {
"user_results": {
"result": {
"__typename": "User",
"affiliates_highlighted_label": {},
"avatar": {
"image_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg"
},
"core": {
"created_at": "Wed Dec 19 20:20:32 +0000 2007",
"name": "NASA",
"screen_name": "NASA"
},
"dm_permissions": {
"can_dm": false
},
"follow_request_sent": false,
"has_graduated_access": true,
"id": "VXNlcjoxMTM0ODI4Mg==",
"is_blue_verified": true,
"legacy": {
"default_profile": false,
"default_profile_image": false,
"description": "Making the seemingly impossible, possible. ✨",
"entities": {
"description": {},
"url": {
"urls": [
{
"display_url": "nasa.gov",
"expanded_url": "http://www.nasa.gov/",
"indices": [
0,
23
],
"url": "https://t.co/9NkQJKAnuU"
}
]
}
},
"fast_followers_count": 0,
"favourites_count": 17049,
"follow_request_sent": false,
"followers_count": 92312406,
"friends_count": 115,
"has_custom_timelines": true,
"is_translator": false,
"listed_count": 96844,
"media_count": 28207,
"needs_phone_verification": false,
"normal_followers_count": 92312406,
"notifications": false,
"pinned_tweet_ids_str": [
"2113776971603689874"
],
"possibly_sensitive": false,
"profile_banner_url": "https://pbs.twimg.com/profile_banners/11348282/1788992290",
"profile_interstitial_type": "",
"statuses_count": 74455,
"time_zone": "",
"translator_type": "regular",
"url": "https://t.co/9NkQJKAnuU",
"utc_offset": 0,
"withheld_description": "",
"withheld_scope": ""
},
"location": {
"location": "Pale Blue Dot"
},
"media_permissions": {
"can_media_tag": false
},
"parody_commentary_fan_label": "None",
"privacy": {
"protected": false
},
"profile_bio": {
"description": "Making the seemingly impossible, possible. ✨"
},
"profile_description_language": "en",
"profile_image_shape": "Square",
"relationship_perspectives": {
"blocked_by": false,
"blocking": false,
"followed_by": false,
"following": false,
"muting": false
},
"rest_id": "11348282",
"super_follow_eligible": false,
"super_followed_by": false,
"super_following": false,
"verification": {
"verified": false,
"verified_type": "Government"
}
}
}
},
"edit_control": {
"edit_tweet_ids": [
"2110491624337760703"
],
"editable_until_msecs": "1792018988000",
"edits_remaining": "5",
"is_edit_eligible": true
},
"grok_analysis_button": true,
"grok_annotations": {
"is_image_editable_by_grok": true
},
"is_translatable": false,
"legacy": {
"bookmark_count": 127,
"bookmarked": false,
"conversation_id_str": "2110491624337760703",
"created_at": "Wed Oct 14 22:03:08 +0000 2026",
"display_text_range": [
0,
196
],
"entities": {
"media": [
{
"display_url": "pic.x.com/zVlEbx7Qf1",
"expanded_url": "https://x.com/NASA/status/2110491624337760703/photo/1",
"ext_alt_text": "An astronaut on a spacewalk outside the International Space Station raises their arm in the direction of the camera. Equipment and hardware surround them.",
"ext_media_availability": {
"status": "Available"
},
"features": {
"large": {
"faces": []
},
"medium": {
"faces": []
},
"orig": {
"faces": []
},
"small": {
"faces": []
}
},
"id_str": "2110491621426917377",
"indices": [
197,
220
],
"media_key": "3_2110491621426917377",
"media_results": {
"result": {
"media_key": "3_2110491621426917377"
}
},
"media_url_https": "https://pbs.twimg.com/media/HUn48qSW8AEmiHh.jpg",
"original_info": {
"focus_rects": [
{
"h": 1075,
"w": 1920,
"x": 0,
"y": 0
},
{
"h": 1280,
"w": 1280,
"x": 272,
"y": 0
}
],
"height": 1280,
"width": 1920
},
"sizes": {
"large": {
"h": 1280,
"resize": "fit",
"w": 1920
},
"medium": {
"h": 800,
"resize": "fit",
"w": 1200
},
"small": {
"h": 453,
"resize": "fit",
"w": 680
},
"thumb": {
"h": 150,
"resize": "crop",
"w": 150
}
},
"type": "photo",
"url": "https://t.co/zVlEbx7Qf1"
}
],
"urls": [
{
"display_url": "go.nasa.gov/4i6Xa9I",
"expanded_url": "https://go.nasa.gov/4i6Xa9I",
"indices": [
173,
196
],
"url": "https://t.co/uNgY1GXU8o"
}
],
"user_mentions": [
{
"id_str": "1451773004",
"indices": [
146,
160
],
"name": "International Space Station",
"screen_name": "Space_Station"
}
]
},
"extended_entities": {
"media": [
{
"display_url": "pic.x.com/zVlEbx7Qf1",
"expanded_url": "https://x.com/NASA/status/2110491624337760703/photo/1",
"ext_alt_text": "An astronaut on a spacewalk outside the International Space Station raises their arm in the direction of the camera. Equipment and hardware surround them.",
"ext_media_availability": {
"status": "Available"
},
"features": {
"large": {
"faces": []
},
"medium": {
"faces": []
},
"orig": {
"faces": []
},
"small": {
"faces": []
}
},
"id_str": "2110491621426917377",
"indices": [
197,
220
],
"media_key": "3_2110491621426917377",
"media_results": {
"result": {
"media_key": "3_2110491621426917377"
}
},
"media_url_https": "https://pbs.twimg.com/media/HUn48qSW8AEmiHh.jpg",
"original_info": {
"focus_rects": [
{
"h": 1075,
"w": 1920,
"x": 0,
"y": 0
},
{
"h": 1280,
"w": 1280,
"x": 272,
"y": 0
}
],
"height": 1280,
"width": 1920
},
"sizes": {
"large": {
"h": 1280,
"resize": "fit",
"w": 1920
},
"medium": {
"h": 800,
"resize": "fit",
"w": 1200
},
"small": {
"h": 453,
"resize": "fit",
"w": 680
},
"thumb": {
"h": 150,
"resize": "crop",
"w": 150
}
},
"type": "photo",
"url": "https://t.co/zVlEbx7Qf1"
}
]
},
"favorite_count": 2691,
"favorited": false,
"full_text": "There's work to be done 🛠️\n\nJoin us on Oct. 20 for a preview of two upcoming spacewalks in which astronauts will install solar arrays to give the @Space_Station more power: https://t.co/uNgY1GXU8o https://t.co/zVlEbx7Qf1",
"id_str": "2110491624337760703",
"is_quote_status": false,
"lang": "en",
"possibly_sensitive": false,
"possibly_sensitive_editable": true,
"quote_count": 725,
"reply_count": 178,
"retweet_count": 390,
"retweeted": false,
"user_id_str": "11348282"
},
"rest_id": "2110491624337760703",
"unmention_data": {},
"views": {
"count": "944692",
"state": "EnabledWithCount"
}
}Common to every endpoint
Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notes
An unknown or deleted post is a free 404 (`Tweet not found`). A URL without a numeric status id is a free 400 (`Tweet ID is not a number`).
05Errors & credits
Every error has success: false, a real HTTP status and costs no credits.
400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.