Démarrage rapide

Rechercher des Spaces par mot-clé

Ce guide vous explique comment rechercher des Spaces par mot-clé.

Prérequis

Avant de commencer, vous aurez besoin de :

• D’un compte développeur avec une App approuvée
• Du Jeton Bearer de votre App

---

​

Rechercher des Spaces

Recherchez des Spaces qui correspondent à un mot-clé :

cURL

shellscript

curl "https://api.x.com/2/spaces/search?\
query=AI&\
space.fields=title,host_ids,participant_count,state&\
state=live" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

Réponse

{
  "data": [
    {
      "id": "1DXxyRYNejbKM",
      "state": "live",
      "title": "Discussing AI and the Future",
      "host_ids": ["2244994945"],
      "participant_count": 245
    },
    {
      "id": "1YqJDqWYNQDGW",
      "state": "live",
      "title": "AI in Healthcare",
      "host_ids": ["783214"],
      "participant_count": 89
    }
  ],
  "meta": {
    "result_count": 2
  }
}

---

​

Filtrer par statut

Rechercher uniquement les Spaces en direct ou programmés :

​

Spaces en direct uniquement

cURL

shellscript

curl "https://api.x.com/2/spaces/search?query=tech&state=live" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

Spaces programmées uniquement

cURL

shellscript

curl "https://api.x.com/2/spaces/search?query=tech&state=scheduled" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Inclure les informations sur l’hôte

Inclure les données de l’utilisateur hôte :

cURL

shellscript

curl "https://api.x.com/2/spaces/search?\
query=AI&\
space.fields=title,host_ids,state&\
expansions=host_ids&\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Paramètres courants

Paramètre	Description
query	Requête de recherche (obligatoire)
state	Filtre : live, scheduled ou all
max_results	Nombre de résultats à renvoyer (1-100)
space.fields	Champs Space à inclure
expansions	Objets associés à inclure
user.fields	Champs utilisateur à inclure

---

​

Prochaines étapes

Recherche de Spaces

Rechercher des Spaces par identifiant

Référence de l’API

Documentation complète de l’endpoint