X Spaces
Les Spaces X, anciennement Twitter Spaces, sont des salons audio en direct sur X, chacun avec un titre, un statut qui passe de programmé à en direct puis à terminé, un hôte principal et d’éventuels co-hôtes, les intervenants invités à prendre la parole, ainsi que le nombre de personnes qui ont écouté en direct et le nombre de lectures de l’enregistrement. Ces informations permettent de rendre compte de la portée d’un Space, de suivre une émission récurrente épisode après épisode et de voir quelles voix reviennent régulièrement prendre la parole dans un domaine.
Fonctionnalités de la X Spaces API
- Tout lien de Space, à n’importe quelle étapeEnvoyez des liens https://x.com/i/spaces/<id> de Spaces programmés, en direct ou déjà terminés : chacun renvoie une seule ligne.
- Statut et horairesstatus vaut scheduled, live, ended ou canceled, avec scheduled_start_at pour le début prévu et published_at pour la date de création du Space.
- Toutes les personnes qui prennent la paroleauthor est l’hôte principal, hosts liste l’hôte et les co-hôtes, et speakers liste les comptes invités à prendre la parole, chacun avec id, username, name, avatar et indicateur de vérification.
- Audience en direct et en rediffusionmetrics.live_listeners_count est le nombre total de personnes qui ont écouté le Space en direct, et metrics.replay_views_count compte les lectures de l’enregistrement par la suite.
- Disponibilité de la rediffusionis_replay_available indique si le Space peut encore être réécouté sur X une fois terminé.
Paramètres de la X Spaces API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liens de Spaces X au format https://x.com/i/spaces/<space_id>, un par ligne ; les Spaces programmés, en direct et terminés sont tous acceptés. |
Comment utiliser la X Spaces API
Envoyez des liens de Spaces et lisez une ligne par Space.
- Envoyez {"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]} en POST à /v1/x/space.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez chaque Space dans results.items ; pour les gros lots, continuez à transmettre results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/x/space" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/spaces/1OdWgBerXWvaQz"]}'
# hosts repeats the main host from author and adds any co-hosts.Cas d’usage de la X Spaces API
- Rendre compte d’un Space que vous avez animé ou sponsorisé : Reportez live_listeners_count, replay_views_count et la liste des intervenants de chaque Space dans un bilan post-événement destiné à un client ou à un sponsor.
- Suivre l’émission audio d’un concurrent : Collectez les liens des Spaces récurrents d’un concurrent et comparez auditeurs, lectures de la rediffusion et invités d’un épisode à l’autre.
- Dresser la liste des intervenants actifs d’une niche : Réunissez les intervenants et co-hôtes des Spaces de votre domaine et comptez combien de fois chaque compte prend la parole.
- Vérifier la programmation d’un Space à venir : Lisez scheduled_start_at et hosts avant un événement, puis consultez de nouveau le Space pour voir si son statut est passé à ended ou à canceled.
Conseils d’expert pour la X Spaces API
- Collectez de nouveau un Space une fois son status à ended pour enregistrer son total final d’auditeurs en direct, et stockez replay_views_count avec collected_at, car les lectures de la rediffusion continuent d’augmenter tant que is_replay_available vaut true.
- Comptez les co-hôtes en retirant l’entrée author de hosts ; l’hôte principal apparaît dans les deux champs.
- Identifiez les intervenants par id lorsque vous combinez plusieurs Spaces, afin de compter une seule fois la même personne, même après un changement de nom d’utilisateur.
API associées
En complément de la X Spaces API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques X.
- Twitter Tweet Scraper API — Récupérez le texte des posts publics, auteurs, l’engagement, médias, hashtags, mentions et relations de conversation à partir d’URL de statuts x.com ou twitter.com.
- Twitter Profile Scraper API — Récupérez par nom d’utilisateur l’identité publique d’un compte, ses biographies, avatars, images de couverture, statut du compte et statistiques d’audience visibles.
- Twitter User Tweets Scraper API — Collectez par nom d’utilisateur les posts publics récents, auteurs, médias, hashtags, mentions et l’engagement, hors réponses.
- X Post Quotes API — Collectez les citations publiques de statuts connus à partir de leur URL, avec commentaire, auteurs, engagement, médias, horodatages et contexte du post source.
- Twitter Mentions API — Collectez les posts publics qui mentionnent un compte donné.
- X Account Location API — Consultez le pays où un compte est basé, son mode de connexion à X, sa date d’inscription et ses changements de nom d’utilisateur.
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API