> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-143107c1.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-143107c1/r6g1kiGndqT3mXyl/icons/xds/icon-brackets.svg?fit=max&auto=format&n=r6g1kiGndqT3mXyl&q=85&s=88ceb60b966b22f08f4a1d35eefb6484" 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