Twitter API Documentation
Spaces lookup by list of IDs
GET https://api.twitter.com/2/spaces?ids=&space.fields=&expansions=&user.fields=
This endpoint returns information about one or more Spaces with the specified comma-separated list of IDs. You can request up to 100 Spaces in a single request
Body
PARAM
| Key | Datatype | Required | Description |
ids
|
null | Required. A comma separated list of IDs of the Spaces to lookup. You can specify up to 100 IDs. | |
space.fields
|
null | Comma-separated list of fields from the Space object you want to return from your request. Available fields: host_ids,created_at,creator_id,id,lang,invited_user_ids, participants,speaker_ids,started_at,state,title,updated_at, scheduled_start,is_ticketed Default fields: id,state | |
expansions
|
null | Comma-separated list of fields to expand. Expansions enable requests to expand an ID into a full object in the includes response object. Available values: invited_user_ids,speaker_ids,creator_id,host_ids | |
user.fields
|
null | Comma-separated list of fields from the Space object you want to return from your request. Allowed values: created_at,description,entities,id,location,name,pinned_tweet_id,profile_image_url,protected,public_metrics,url,username,verified,withheld Default values: id,name,username |
HEADERS
| Key | Datatype | Required | Description |
RESPONSES
status OK
| {
"data": [
{
"id": "",
"state": "dolore qui sunt non",
"host_ids": [
"<string>",
"<string>"
],
"created_at": "<dateTime>",
"creator_id": "<string>",
"lang": "ipsum aliqua",
"is_ticketed": "<boolean>",
"invited_user_ids": [
"<string>",
"<string>"
],
"participant_count": "<integer>",
"scheduled_start": "<dateTime>",
"speaker_ids": [
"<string>",
"<string>"
],
"started_at": "<dateTime>",
"title": "<string>",
"updated_at": "<dateTime>"
}
],
"includes": {
"users": [
{
"id": "<string>",
"name": "<string>",
"username": "<string>",
"created_at": "<dateTime>",
"protected": "<boolean>",
"verified": "<boolean>",
"withheld": {
"country_codes": [
{
"value": "<Error: Too many levels of nesting to fake this schema>"
}
],
"scope": "<string>"
},
"profile_image_url": "<uri>",
"location": "<string>",
"url": "<string>",
"description": "<string>",
"entities": {
"url": {
"urls": [
{
"value": "<Error: Too many levels of nesting to fake this schema>"
}
]
},
"description": {
"urls": [
{
"value": "<Error: Too many levels of nesting to fake this schema>"
}
],
"hashtags": [
{
"value": "<Error: Too many levels of nesting to fake this schema>"
}
],
"mentions": [
{
"value": "<Error: Too many levels of nesting to fake this schema>"
}
],
"cashtags": [
{
"value": "<Error: Too many levels of nesting to fake this schema>"
}
]
}
},
"pinned_tweet_id": "<string>",
"public_metrics": {
"followers_count": "<integer>",
"following_count": "<integer>",
"tweet_count": "<integer>",
"listed_count": "<integer>"
}
}
]
},
"errors": [
{
"detail": "<string>",
"status": "<integer>",
"title": "<string>",
"type": "<string>"
}
]
} |
Curl
curl -X GET 'https://api.twitter.com/2/spaces?ids=&space.fields=&expansions=&user.fields=?ids=&space.fields=&expansions=&user.fields='