> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Endpoints de Spaces na X API v2

> Use os endpoints de Spaces da X API v2 para consultar Spaces de áudio ao vivo ou agendados, buscar por palavra-chave e inspecionar detalhes de criadores, hosts, speakers e ouvintes.

export const Button = ({href, children}) => {
  return <div className="not-prose">
    <a href={href}>
      <button className="x-btn">
        <span>{children}</span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

A página a seguir descreve os endpoints de Spaces incluídos na X API. Para saber mais sobre Spaces em geral, visite [help.x.com](https://help.x.com/en/using-twitter/spaces).

Spaces permitem expressão e interação por meio de conversas de áudio ao vivo. Os endpoints de Spaces fornecem as ferramentas para criar novas funcionalidades em torno de Spaces. Você pode usar esses endpoints para consultar Spaces ao vivo ou agendados, ou para construir experiências de descoberta que dêem aos seus usuários formas de encontrar Spaces de seu interesse.

Encorajamos você a usar sua criatividade para estender Spaces além da forma como o construímos. Com esses endpoints, você pode criar experiências para sugerir Spaces aos ouvintes com base em palavras-chave presentes no título, ou destacando contas que hospedam Spaces ao vivo ou futuros e são seguidas por um usuário; você também pode ajudar Hosts a entender melhor o desempenho de seus Spaces e obter mais insights sobre seu público.

### Recursos importantes

Os recursos a seguir ajudarão você a começar e integrar com os endpoints de Spaces:

* [Obtendo acesso à X API v2](/x-api/getting-started/getting-access)
* [Dicionário de dados de Spaces](/x-api/fundamentals/data-dictionary/reference#space)
* [Faça sua primeira requisição a um endpoint de Spaces](/x-api/spaces/lookup/introduction)

#### O que está disponível atualmente

|                   |                                                                                                                                                                                                                                                                                                                                                                                                                      |
| :---------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Spaces lookup** | [Consulta por um único Spaces ID](/x-api/spaces/space-lookup-by-space-id)<br /><br />[Consulta usando múltiplos Spaces IDs](/x-api/spaces/space-lookup-up-space-ids)<br /><br />[Consulta pelo ID do criador](/x-api/spaces/space-lookup-by-their-creators)<br /><br />[Consulta da lista de usuários que compraram um ingresso](/x-api/spaces/retrieve-the-list-of-users-who-purchased-a-ticket-to-the-given-space) |
| **Buscar Spaces** | [Buscar spaces usando uma palavra-chave](/x-api/spaces/search-for-spaces)                                                                                                                                                                                                                                                                                                                                            |

#### Entendendo o ciclo de vida dos Spaces

Ao contrário de outros recursos da Plataforma de Desenvolvedores do X, Spaces têm um ciclo de vida definido. Spaces podem ser agendados com até 14 dias de antecedência em relação à data de início pretendida e ficam indisponíveis após seu término. Um host também pode cancelar um Space previamente agendado a qualquer momento antes do início.

Spaces são acessíveis enquanto estão ao vivo; uma vez encerrados, eles deixarão de estar disponíveis para recuperação usando os endpoints de Spaces, e uma mensagem de erro será retornada para indicar essa condição.

Quando seu app manipula dados de Spaces, você é responsável por retornar as informações mais atualizadas e por remover dados que não estão mais disponíveis na plataforma. O [endpoint de Spaces lookup](/x-api/spaces/lookup/introduction) pode ajudar você a garantir o respeito às expectativas e à intenção dos seus usuários.

### Papéis em Spaces

Esses endpoints refletem a forma como Spaces funcionam no app X. Em Spaces, usuários do X podem ter papéis definidos, dependendo de como interagem com e em um Space.

### Creator (ou primary host)

O primary Host é o usuário que criou um Space e o proprietário do Space em si. Atualmente, Spaces só podem ter um Host, então o primary Host será o único Host. No [dicionário de dados de Spaces](/x-api/fundamentals/data-dictionary/reference#space), as informações do primary Host estarão no campo creator\_id, que pode ser expandido em um [objeto user](/x-api/fundamentals/data-dictionary/reference#user).

### Hosts

Os primary Hosts podem tornar um ou mais usuários co-hosts. No dicionário de dados de Spaces, esses Hosts aparecerão como host\_ids, que podem ser expandidos em uma lista de objetos user. A designação de Host pode mudar ao longo da duração de um Space, e os metadados retornados por esses endpoints refletirão o status no momento da requisição.

Seu app saberá quem é o primary host verificando o valor de creator\_id, e quem são os co-hosts verificando os valores de host\_ids.

### Speaker

Speakers são usuários que têm permissão para falar no Space. Zero ou mais Speakers podem estar presentes a qualquer momento, e pode haver até 10 Speakers (incluindo os Hosts) em um Space. No dicionário de dados de Space, os speakers serão retornados na lista speaker\_ids, que você pode expandir em uma lista de objetos user.

### Listener

Um Listener pode ouvir um Space, reagir a qualquer momento usando as reações predefinidas e pedir para se tornar um speaker (quando os Hosts permitirem isso nas configurações do Space). As informações de Listener só serão retornadas como uma contagem agregada de participantes (incluindo Hosts) no campo participant\_count.