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

# Introducción

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <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>;
};

La siguiente página describe los endpoints de Spaces incluidos en la X API. Para obtener más información sobre Spaces en general, visita [help.x.com](https://help.x.com/en/using-twitter/spaces). 

Spaces permite la expresión y la interacción mediante conversaciones de audio en vivo. Los endpoints de Spaces proporcionan las herramientas para crear nueva funcionalidad en torno a Spaces. Puedes usar estos endpoints para buscar Spaces en vivo o programados, o para crear experiencias de descubrimiento que ayuden a tus usuarios a encontrar Spaces que puedan interesarles.

Te animamos a usar tu creatividad para ampliar Spaces más allá de cómo lo hemos diseñado. Con estos endpoints puedes crear experiencias para sugerir Spaces a los oyentes en función de las palabras clave presentes en el título, o mostrando cuentas que alojan Spaces en vivo o próximos y que un usuario sigue; también puedes ayudar a los anfitriones a comprender mejor el rendimiento de sus Spaces y obtener más información sobre su audiencia.

<div id="important-resources">
  ### Recursos importantes
</div>

Los siguientes recursos te ayudarán a empezar a trabajar con los endpoints de Spaces:

* [Obtener acceso a X API v2](/es/x-api/getting-started/getting-access)
* [Diccionario de datos de Spaces](/es/x-api/fundamentals/data-dictionary#space)
* [Haz tu primera solicitud a un endpoint de Spaces](/es/x-api/spaces/lookup/introduction)

   

<div id="whats-currently-available">
  #### Qué hay disponible actualmente
</div>

|                        |                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| :--------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Consulta de Spaces** | [Consulta por un solo ID de Space](/es/x-api/spaces/space-lookup-by-space-id)<br /><br />[Consulta mediante múltiples IDs de Space](/es/x-api/spaces/space-lookup-up-space-ids)<br /><br />[Consulta por el ID de su creador](/es/x-api/spaces/space-lookup-by-their-creators)<br /><br />[Consulta de la lista de usuarios que compraron una entrada](/es/x-api/spaces/retrieve-the-list-of-users-who-purchased-a-ticket-to-the-given-space) |
| **Buscar Spaces**      | [Buscar Spaces usando una palabra clave](/es/x-api/spaces/search-for-spaces)                                                                                                                                                                                                                                                                                                                                                                  |

<div id="understanding-the-lifecycle-of-spaces">
  #### Comprender el ciclo de vida de Spaces
</div>

A diferencia de otros recursos de la Plataforma de Desarrolladores de X, Spaces tienen un ciclo de vida definido. Se pueden programar Spaces hasta con 14 días de antelación respecto a su fecha de inicio prevista y dejan de estar disponibles después de que finalizan. Un host también puede cancelar un Space previamente programado en cualquier momento antes de que comience.

Los Spaces son accesibles mientras están en directo; una vez que finalizan, ya no estarán disponibles para su recuperación mediante los endpoints de Spaces, y se devolverá un mensaje de error para indicar esta condición.

Cuando tu App procese datos de Spaces, eres responsable de devolver la información más reciente y de eliminar los datos que ya no estén disponibles en la plataforma. El [endpoint de búsqueda de Spaces](/es/x-api/spaces/lookup/introduction) puede ayudarte a garantizar que respetas las expectativas y la intención de tus usuarios.
 

<div id="roles-in-spaces">
  ### Roles en Spaces
</div>

Estos endpoints reflejan la forma en que funcionan los Spaces en la app de X. En los Spaces, los usuarios de X pueden tener roles definidos según cómo interactúan con un Space y cómo participan en él.
 

<div id="creator-or-primary-host">
  ### Creador (o anfitrión principal)
</div>

El anfitrión principal es el usuario que creó un Space y el propietario de ese Space. Actualmente, los Spaces solo pueden tener un anfitrión, por lo que el anfitrión principal será el único anfitrión. En el [diccionario de datos de Spaces](/es/x-api/fundamentals/data-dictionary#space), la información del anfitrión principal estará en el campo creator\_id, que se puede expandir a un [objeto de usuario](/es/x-api/fundamentals/data-dictionary#user).
 

<div id="hosts">
  ### Anfitriones
</div>

Los anfitriones principales pueden asignar a uno o más usuarios como coanfitriones. En el diccionario de datos de Spaces, estos anfitriones aparecerán como host\_ids, que se pueden expandir en una lista de objetos de usuario. La designación de anfitrión puede cambiar durante la duración de un Space, y los metadatos devueltos por estos endpoints reflejarán el estado en el momento de la solicitud.

Tu aplicación identificará al anfitrión principal comprobando el valor de creator\_id y a los coanfitriones comprobando los valores de host\_ids.
 

<div id="speaker">
  ### Speaker
</div>

Los Speakers son usuarios que tienen permiso para hablar en el Space. En cualquier momento puede haber desde cero Speakers hasta un máximo de 10 (incluidos los Hosts) en un Space. En el diccionario de datos de Space, los Speakers se devolverán en la lista speaker\_ids, que puedes expandir para obtener una lista de objetos de usuario.
 

<div id="listener">
  ### Oyente
</div>

Un oyente puede escuchar un Space, reaccionar en cualquier momento usando las reacciones predefinidas y solicitar convertirse en orador (cuando los anfitriones lo permiten en la configuración del Space). La información sobre los oyentes solo se devolverá como un recuento agregado de participantes (incluidos los anfitriones) en el campo participant\_count.