> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-508d47e7.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Spaces Search
> The Spaces Search endpoint lets you search for live or scheduled Spaces by keyword. Reference for the X API v2 standard tier covering search.
export const Button = ({href, children}) => {
return ;
};
The Spaces Search endpoint lets you search for live or scheduled Spaces by keyword. Find Spaces about topics of interest.
## Overview
Search Spaces by title
Find live and upcoming Spaces
***
## Endpoint
| Method | Endpoint | Description |
| :- | :- | :- |
| GET | [`/2/spaces/search`](/x-api/spaces/search-spaces) | Search for Spaces |
***
## Parameters
| Parameter | Description |
| :- | :- |
| `query` | Search query (required) |
| `state` | Filter by `live` or `scheduled` |
| `space.fields` | Additional Space fields |
| `expansions` | Related objects to include |
***
## Example request
```bash theme={null}
curl "https://api.x.com/2/spaces/search?\
query=AI&\
state=live&\
space.fields=title,host_ids,participant_count" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
## Example response
```json title="Example response" lines wrap icon="https://mintcdn.com/x-preview-mintlify-508d47e7/K_EDPi0sX8nSJWO1/icons/xds/icon-brackets.svg?fit=max&auto=format&n=K_EDPi0sX8nSJWO1&q=85&s=fbbeace0b61ab86c0a4f8da0e43ebe06" theme={null}
{
"data": [
{
"id": "1DXxyRYNejbKM",
"state": "live",
"title": "Discussing AI and the Future",
"host_ids": ["1234567890"],
"participant_count": 245
}
],
"meta": {
"result_count": 1
}
}
```
***
## Getting started
**Prerequisites**
* An approved [developer account](https://developer.x.com/en/portal/petition/essential/basic-info)
* A [Project and App](/resources/fundamentals/developer-apps) in the Developer Console
* Your App's [keys and tokens](/resources/fundamentals/authentication)
Search for your first Space
Look up Spaces by ID
Full endpoint documentation