This endpoint allows you to search Spaces by their title, and to filter results by status. This endpoint is useful to discover live or upcoming Spaces based on keywords, mentioned users or hashtags in their title.

The endpoint accepts one or more keywords as a query. Its results can be filtered by the status of a Space (live or scheduled). By default, a request will return both live and scheduled Spaces that match the specified query.

To access these endpoints, you must sign up for a developer account. When authenticating, you must use keys and tokens from a developer App that is located within a Project.

Learn more about getting access to the Twitter API v2 endpoints in our Getting started page.