Passer au contenu principal
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.

Vue d’ensemble

Par ID

Récupérer les détails d’un Space spécifique

Spaces multiples

Rechercher plusieurs Spaces à la fois

Par créateur

Trouver des Spaces en fonction de leurs hôtes

Acheteurs

Récupérer la liste des utilisateurs ayant acheté des billets

Endpoints

MéthodeEndpointDescription
GET/2/spaces/:idRécupérer un Space par identifiant
GET/2/spacesRécupérer des Spaces par identifiants
GET/2/spaces/by/creator_idsRécupérer des Spaces par identifiants d’utilisateurs créateurs
GET/2/spaces/:id/buyersRécupérer les acheteurs de billets pour un Space
GET/2/spaces/:id/tweetsRécupérer les Publications partagées dans un Space

Champs de réponse

Par défaut, la réponse inclut id et state. Demandez des champs supplémentaires :
ChampDescription
titleTitre du Space
host_idsID des utilisateurs hôtes
speaker_idsID des utilisateurs intervenants
participant_countNombre de participants
scheduled_startHeure de début programmée
started_atHeure de début réelle
ended_atHeure de fin
is_ticketedIndique si le Space est à accès payant

États des Spaces

ÉtatDescription
liveEn cours
scheduledProgrammé
endedTerminé

Exemple de requête

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

Prise en main

Prérequis

Démarrage rapide

Effectuez votre première requête de recherche de Spaces

Rechercher des Spaces

Trouvez des Spaces par mot-clé

Référence de l’API

Documentation complète de l’endpoint

Exemples de code

Exemples de code fonctionnels