> ## 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.

# Recherche de Spaces

> Récupérer les détails d'un Space à partir de son id ou rechercher des Spaces par leurs créateurs

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>;
};

Les endpoints de recherche de Spaces vous permettent de récupérer des informations sur des Spaces en direct ou programmés. Vous pouvez rechercher des Spaces par leur id ou trouver des Spaces créés par des utilisateurs spécifiques.

<div id="overview">
  ## Vue d’ensemble
</div>

<CardGroup cols={2}>
  <Card title="Par ID" icon="microphone">
    Récupérer les détails d’un Space spécifique
  </Card>

  <Card title="Spaces multiples" icon="microphone-lines">
    Rechercher plusieurs Spaces à la fois
  </Card>

  <Card title="Par créateur" icon="user">
    Trouver des Spaces en fonction de leurs hôtes
  </Card>

  <Card title="Acheteurs" icon="ticket">
    Récupérer la liste des utilisateurs ayant acheté des billets
  </Card>
</CardGroup>

***

<div id="endpoints">
  ## Endpoints
</div>

| Méthode | Endpoint                                                                 | Description                                                    |
| :------ | :----------------------------------------------------------------------- | :------------------------------------------------------------- |
| GET     | [`/2/spaces/:id`](/fr/x-api/spaces/get-space-by-id)                      | Récupérer un Space par identifiant                             |
| GET     | [`/2/spaces`](/fr/x-api/spaces/get-spaces-by-ids)                        | Récupérer des Spaces par identifiants                          |
| GET     | [`/2/spaces/by/creator_ids`](/fr/x-api/spaces/get-spaces-by-creator-ids) | Récupérer des Spaces par identifiants d'utilisateurs créateurs |
| GET     | [`/2/spaces/:id/buyers`](/fr/x-api/spaces/get-space-ticket-buyers)       | Récupérer les acheteurs de billets pour un Space               |
| GET     | [`/2/spaces/:id/tweets`](/fr/x-api/spaces/get-space-posts)               | Récupérer les Publications partagées dans un Space             |

***

<div id="response-fields">
  ## Champs de réponse
</div>

Par défaut, la réponse inclut `id` et `state`. Demandez des champs supplémentaires :

| Champ               | Description                            |
| :------------------ | :------------------------------------- |
| `title`             | Titre du Space                         |
| `host_ids`          | ID des utilisateurs hôtes              |
| `speaker_ids`       | ID des utilisateurs intervenants       |
| `participant_count` | Nombre de participants                 |
| `scheduled_start`   | Heure de début programmée              |
| `started_at`        | Heure de début réelle                  |
| `ended_at`          | Heure de fin                           |
| `is_ticketed`       | Indique si le Space est à accès payant |

<div id="space-states">
  ### États des Spaces
</div>

| État        | Description |
| :---------- | :---------- |
| `live`      | En cours    |
| `scheduled` | Programmé   |
| `ended`     | Terminé     |

***

<div id="example-request">
  ## Exemple de requête
</div>

```bash theme={null}
curl "https://api.x.com/2/spaces/1DXxyRYNejbKM?\
space.fields=title,host_ids,participant_count,scheduled_start,state" \
  -H "Authorization: Bearer $BEARER_TOKEN"
```

***

<div id="getting-started">
  ## Prise en main
</div>

<Note>
  **Prérequis**

  * Un [compte développeur](https://developer.x.com/en/portal/petition/essential/basic-info) approuvé
  * Un [projet et une App](/fr/resources/fundamentals/developer-apps) dans la Console de développement
  * Les [clés et jetons](/fr/resources/fundamentals/authentication) de votre App
</Note>

<CardGroup cols={2}>
  <Card title="Démarrage rapide" icon="rocket" href="/fr/x-api/spaces/lookup/quickstart">
    Effectuez votre première requête de recherche de Spaces
  </Card>

  <Card title="Rechercher des Spaces" icon="magnifying-glass" href="/fr/x-api/spaces/search/introduction">
    Trouvez des Spaces par mot-clé
  </Card>

  <Card title="Référence de l’API" icon="code" href="/fr/x-api/spaces/space-lookup-by-space-id">
    Documentation complète de l’endpoint
  </Card>

  <Card title="Exemples de code" icon="github" href="https://github.com/xdevplatform/Twitter-API-v2-sample-code">
    Exemples de code fonctionnels
  </Card>
</CardGroup>