> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-5e62557c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Busca de Spaces
> O endpoint de Busca de Spaces permite pesquisar Spaces ao vivo ou agendados por palavra-chave. Referência para a X API v2 standard tier cobrindo search.
export const Button = ({href, children}) => {
return ;
};
O endpoint de Busca de Spaces permite pesquisar Spaces ao vivo ou agendados por palavra-chave. Encontre Spaces sobre tópicos de interesse.
## Visão geral
Pesquise Spaces pelo título
Encontre Spaces ao vivo e futuros
***
## Endpoint
| Método | Endpoint | Descrição |
| :----- | :------------------------------------------------ | :------------ |
| GET | [`/2/spaces/search`](/x-api/spaces/search-spaces) | Buscar Spaces |
***
## Parâmetros
| Parâmetro | Descrição |
| :------------- | :-------------------------------- |
| `query` | Consulta de busca (obrigatório) |
| `state` | Filtrar por `live` ou `scheduled` |
| `space.fields` | Campos adicionais de Space |
| `expansions` | Objetos relacionados a incluir |
***
## Exemplo de requisição
```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"
```
## Exemplo de resposta
```json title="Exemplo de resposta" lines wrap icon="https://mintcdn.com/x-preview-mintlify-5e62557c/QVCcrJRuVU5c6Fli/icons/xds/icon-brackets.svg?fit=max&auto=format&n=QVCcrJRuVU5c6Fli&q=85&s=8c7124cd379f973762b135033c4e3df8" theme={null}
{
"data": [
{
"id": "1DXxyRYNejbKM",
"state": "live",
"title": "Discussing AI and the Future",
"host_ids": ["1234567890"],
"participant_count": 245
}
],
"meta": {
"result_count": 1
}
}
```
***
## Primeiros passos
**Pré-requisitos**
* Uma [conta de desenvolvedor](https://developer.x.com/en/portal/petition/essential/basic-info) aprovada
* Um [Projeto e App](/resources/fundamentals/developer-apps) no Developer Console
* As [chaves e tokens](/resources/fundamentals/authentication) do seu App
Busque seu primeiro Space
Consulte Spaces por ID
Documentação completa do endpoint