Twitter Spaces Search (V2) - Data API Endpoint

Spaces Search (V2) by query, bearer token, expansions, fields (spaces), fields (users), state and limit.


Download Twitter Spaces Search (V2) data from the Official Twitter API | 👥  Contributors: steve 🚩  Report

✏️ Inputs

Query query Required

Your search term. This can be any text (including mentions and Hashtags) present in the title of the Space.

E.g. hello
Bearer Token access_token Required

Your Twitter app’s Bearer Token for collecting data with. If you don’t have one, see How to Get a Twitter API Key Without Approval or check out Twitter’s docs on Bearer Tokens for more information.

If you get the error client-not-enrolled, then make sure you’re not using a standalone app and try creating a new application with the Add App button under a project and NOT under the standalone section.

Expansions expansions Optional

A comma-separated list of additional data to return back in the response. See Twitter API Expansions for possible values or copy the example value here to get as much data back as possible.

E.g. invited_user_ids,speaker_ids,creator_id,host_ids
Fields (Spaces) space_fields Optional

Fields to return with spaces.

E.g. 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
Fields (Users) user_fields Optional

A comma-separated list of fields you would like back for users in the response. See the Twitter API User Model for more information or just use the example value here to get as much data back as possible.

E.g. created_at,description,entities,id,location,name,pinned_tweet_id,profile_image_url,protected,public_metrics,url,username,verified,withheld
State state Optional

Set this to all, live or scheduled to change which spaces are returned.

E.g. all
Limit limit Optional

How many results to return per request.

📝 Notes

Posted by steve on Sept. 29, 2022, 6:30 a.m. 🚩  Report

⚡️ Endpoint

GET https://api.twitter.com/2/spaces/search?query={{query}}&expansions={{ expansions }}&max_results={{ limit }}&space.fields={{ space_fields }}&state={{ state }}&user.fields={{ user_fields }}

Body

None

Headers

Authorization
Bearer {{access_token}}