Spaces
Space lookup up Space IDs
Returns a variety of information about the Spaces specified by the requested IDs
get/2/spaces
Query parameters
idsstring[] required
The list of Space IDs to return.
[ "1SLjjRYNejbKM" ]
space.fieldsstring[]
The fields available for a Space object.
A comma separated list of Space fields to display.
[ "created_at", "creator_id", "ended_at", "host_ids", "id", "invited_user_ids", "is_ticketed", "lang", "participant_count", "scheduled_start", "speaker_ids", "started_at", "state", "subscriber_count", "title", "topic_ids", "updated_at" ]
expansionsstring[]
The list of fields you can expand for a Space object. If the field has an ID, it can be expanded into a full object.
A comma separated list of fields to expand.
[ "creator_id", "host_ids", "invited_user_ids", "speaker_ids", "topic_ids" ]
user.fieldsstring[]
The fields available for a User object.
A comma separated list of User fields to display.
[ "created_at", "description", "entities", "id", "location", "name", "pinned_tweet_id", "profile_image_url", "protected", "public_metrics", "url", "username", "verified", "verified_type", "withheld" ]
topic.fieldsstring[]
The fields available for a Topic object.
A comma separated list of Topic fields to display.
[ "description", "id", "name" ]
Response
The request has succeeded.
Example response
{
"data": [
{
"created_at": "2021-07-06T18:40:40.000Z",
"creator_id": "2244994945",
"ended_at": "2021-07-06T18:40:40.000Z",
"host_ids": [
"2244994945"
],
"id": "1SLjjRYNejbKM",
"invited_user_ids": [
"2244994945"
],
"lang": "en",
"participant_count": 10,
"scheduled_start": "2021-07-06T18:40:40.000Z",
"speaker_ids": [
"2244994945"
],
"started_at": "2021-7-14T04:35:55Z",
"state": "live",
"subscriber_count": 10,
"title": "Spaces are Awesome",
"topics": [
{
"description": "All about technology",
"id": "848920371311001600",
"name": "Technology"
}
],
"updated_at": "2021-7-14T04:35:55Z"
}
],
"includes": {
"places": [
{
"contained_within": [
"f7eb2fa2fea288b1"
],
"country": "United States",
"country_code": "US",
"full_name": "Lakewood, CO",
"geo": {
"bbox": [
-105.193475,
39.60973,
-105.053164,
39.761974
],
"geometry": {
"coordinates": [
-105.18816086351444,
40.247749999999996
],
"type": "Point"
}
},
"id": "f7eb2fa2fea288b1",
"name": "Lakewood",
"place_type": "city"
}
],
"polls": [
{
"id": "1365059861688410112"
}
],
"topics": [
{
"description": "All about technology",
"name": "Technology"
}
],
"tweets": [
{
"author_id": "2244994945",
"created_at": "Wed Jan 06 18:40:40 +0000 2021",
"id": "1346889436626259968",
"text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"
}
],
"users": [
{
"created_at": "2013-12-14T04:35:55Z",
"id": "2244994945",
"name": "Twitter Dev",
"protected": false,
"username": "TwitterDev"
}
]
}
}