Démarrage rapide

Récupérer les détails d’un Space par id ou par créateur

Ce guide vous explique comment récupérer des informations sur un Space à l’aide des endpoints de recherche Spaces.

Prérequis

Avant de commencer, vous aurez besoin des éléments suivants :

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

---

​

Récupérer un Space par id

Récupérez les détails d’un Space spécifique :

cURL

shellscript

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

​

Réponse

{
  "data": {
    "id": "1DXxyRYNejbKM",
    "state": "live",
    "title": "Discussing AI and the Future",
    "host_ids": ["2244994945"],
    "participant_count": 245,
    "created_at": "2024-01-15T09:00:00.000Z"
  }
}

---

​

Récupérer plusieurs Spaces

Récupérez plusieurs Spaces en une seule fois :

cURL

shellscript

curl "https://api.x.com/2/spaces?\
ids=1DXxyRYNejbKM,1YqJDqWYNQDGW&\
space.fields=title,state,participant_count" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Récupérer des Spaces par créateur

Récupérez les Spaces hébergés par des utilisateurs spécifiques :

cURL

shellscript

curl "https://api.x.com/2/spaces/by/creator_ids?\
user_ids=2244994945,783214&\
space.fields=title,state,scheduled_start" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Inclure les informations de l’hôte

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

cURL

shellscript

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

​

Réponse avec expansion

{
  "data": {
    "id": "1DXxyRYNejbKM",
    "state": "live",
    "title": "Discussing AI and the Future",
    "host_ids": ["2244994945"]
  },
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "username": "XDevelopers",
        "verified": true
      }
    ]
  }
}

---

​

États des Spaces

État	Description
live	Actuellement en direct
scheduled	Planifié pour une date ultérieure
ended	A pris fin

---

​

Champs disponibles

Champ	Description
title	Titre du Space
host_ids	id des utilisateurs hôtes
speaker_ids	id des utilisateurs intervenants
participant_count	Nombre actuel de participants
scheduled_start	Heure de début planifiée
started_at	Heure de début effective
ended_at	Heure de fin effective
is_ticketed	Indique si le Space est payant (à tickets)
state	État actuel

---

​

Prochaines étapes

Rechercher des Spaces

Trouvez des Spaces par mot-clé

Référence de l’API

Documentation complète de l’endpoint