> For the complete documentation index, see [llms.txt](https://socialdata.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://socialdata.gitbook.io/docs/twitter-spaces/retrieve-twitter-spaces-stream-details.md).

# Retrieve Twitter spaces stream details

{% hint style="danger" %} <mark style="color:red;">**WARNING:**</mark>&#x20;

**You are viewing an outdated version of our documentation.** \
**For the latest and most accurate information, please visit** [**docs.socialdata.tools**](https://docs.socialdata.tools)**.**
{% endhint %}

### Endpoint

```url
GET https://api.socialdata.tools/twitter/spaces/show?id=...
```

### Endpoint parameters

| Name                                     | Description                          | Example       |
| ---------------------------------------- | ------------------------------------ | ------------- |
| <p>id<br><strong>(Required)</strong></p> | 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

```bash
curl "https://api.socialdata.tools/spaces/show?id=1jMJgLdenVjxL"
-H 'Authorization: Bearer API_KEY'
-H 'Accept: application/json'
```

[![Run In Postman](https://run.pstmn.io/button.svg)](https://god.gw.postman.com/run-collection/36444222-9d3f261a-6fc3-44cd-90eb-f0d191d6d1a8?action=collection%2Ffork\&source=rip_markdown\&collection-url=entityId%3D36444222-9d3f261a-6fc3-44cd-90eb-f0d191d6d1a8%26entityType%3Dcollection%26workspaceId%3D22407140-425b-41ff-969e-1fb938fe8e86)

### Example response

```json
// 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"
}
```