Retrieve Twitter spaces stream details
WARNING:
You are viewing an outdated version of our documentation. For the latest and most accurate information, please visit docs.socialdata.tools.
Endpoint
GET https://api.socialdata.tools/twitter/spaces/show?id=...
Endpoint parameters
id (Required)
The ID of the desired Twitter Space.
1jMJgLdenVjxL
Response codes
HTTP 200 OK - succeeded
HTTP 402 Payment Required - not enough credits to perform this request
HTTP 404 Not Found - requested tweet does not exist
HTTP 422 Unprocessable Content - validation failed (e.g. one of the required parameters was not provided)
HTTP 500 Internal Server Error - other error, typically means that SocialData API failed to obtain the requested information and you should try again later
Rate limits
By default each user has a limit of 120 requests per minute shared across all endpoints. Please reach out to support@socialdata.tools if you need to raise your rate limit.
Example request
curl "https://api.socialdata.tools/spaces/show?id=1jMJgLdenVjxL"
-H 'Authorization: Bearer API_KEY'
-H 'Accept: application/json'
Example response
// If succeeded:
{
"state": "Ended",
"title": "The Algorithm goes open source",
"media_key": "28_1641872499875930112",
"created_at": 1680287883093,
"scheduled_start": 1680289200000,
"started_at": 1680289206898,
"ended_at": "1680293477270",
"updated_at": 1680293485413,
"disallow_join": false,
"narrow_cast_space_type": 0,
"is_employee_only": false,
"is_locked": false,
"is_space_available_for_replay": true,
"is_space_available_for_clipping": false,
"conversation_controls": 0,
"total_replay_watched": 1291373,
"total_live_listeners": 435271,
"id": "1jMJgLdenVjxL",
"creator": {
"id": "6844292",
"affiliates_highlighted_label": {
"label": {
"url": {
"url": "https:\/\/twitter.com\/X",
"urlType": "DeepLink"
},
"badge": {
"url": "https:\/\/pbs.twimg.com\/profile_images\/1683899100922511378\/5lY42eHs_bigger.jpg"
},
"description": "X",
"userLabelType": "BusinessLabel",
"userLabelDisplayType": "Badge"
}
},
"has_graduated_access": true,
"is_blue_verified": true,
"profile_image_shape": "Square",
"legacy": {
"can_dm": false,
"can_media_tag": true,
"created_at": "Sat Jun 16 00:14:36 +0000 2007",
"default_profile": false,
"default_profile_image": false,
"description": "Updates from our Product and Infrastructure teams.",
"entities": {
"description": {
"urls": []
}
},
"fast_followers_count": 0,
"favourites_count": 267,
"followers_count": 1324928,
"friends_count": 12,
"has_custom_timelines": true,
"is_translator": false,
"listed_count": 4701,
"location": "San Francisco",
"media_count": 63,
"name": "Engineering",
"normal_followers_count": 1324928,
"pinned_tweet_ids_str": [],
"possibly_sensitive": false,
"profile_banner_url": "https:\/\/pbs.twimg.com\/profile_banners\/6844292\/1690213191",
"profile_image_url_https": "https:\/\/pbs.twimg.com\/profile_images\/1683502255574593536\/anU7i4uA_normal.jpg",
"profile_interstitial_type": "",
"screen_name": "XEng",
"statuses_count": 905,
"translator_type": "regular",
"verified": false,
"verified_type": "Business",
"want_retweets": false,
"withheld_in_countries": []
}
}
}
// If failed:
{
"status":"error",
"message":"Space not found"
}
Last updated