Search Spaces by title

GET https://api.twitter.com/2/spaces/search?query=&state=&space.fields=&expansions=&user.fields&topic.fields

This endpoint returns Spaces matching the specified keyword query.

Sign up for the Twitter API

Request Params

| Key | Datatype | Required | Description | | query | null | | Required. A search term. Can be a keyword, hashtag, or mention. | | state | null | | Return only Spaces with a specific running status.

Allowed values (specify only one of the following): live,scheduled | | 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, participant_count,speaker_ids,started_at,state,title,updated_at, scheduled_start,is_ticketed,ended_at,topic_ids

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 to expand. Expansions enable requests to expand an ID into a full object in the includes response object.

Available 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 | | topic.fields | null | | Comma-separated list of fields from the Space Topics object you want to return from your request . Available values: id,name,description |

HEADERS

| Key | Datatype | Required | Description |

RESPONSES

status: ``