XTwitterListes XCommunautés XSpaces XGuide API

Nouveaux endpoints de l’API X : listes, communautés, Spaces, Articles et localisation des comptes

14 nouveaux endpoints SocQ X (Twitter) couvrent la localisation des comptes, les abonnés vérifiés, la vérification des abonnements, les listes, les communautés, les médias et les réponses, les Articles, les Spaces et les transcriptions vidéo.

SocQMis à jour le 19 novembre 202610 min de lecture

Les endpoints X de SocQ renvoyaient déjà les profils publics, posts, timelines, recherches, réponses, citations, abonnés et tendances ; le guide de collecte X/Twitter les présente. Le 2026-11-17, 14 endpoints supplémentaires ont été mis en ligne sur la page de la plateforme X. Ils atteignent des parties de X que les endpoints de base ne couvraient pas : le panneau « About this account » (À propos de ce compte), les listes, les membres et modérateurs des communautés, les onglets Médias et Réponses d’un utilisateur, les Articles longs, les Spaces et la parole dans les vidéos.

Ce guide les regroupe par usage, montre une requête pour chacun et indique le prix.

Réponse rapide : envoyez un corps JSON à POST https://api.socq.ai/v1/x/<endpoint>. Enregistrez le task_id renvoyé, interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded, puis lisez data.results.items. Les 14 endpoints coûtent 0,7 crédit ($0,0035) par résultat, avec une seule exception pour les vidéos longues dans Video Transcript.

Les nouveaux endpoints X en un coup d’œil

1 crédit SocQ = $0,005. Il n’y a pas de frais de base : un résultat vide ne coûte rien.

EndpointCe qu’il renvoiePrix
API X Account LocationPays où se trouve un compte, mode de connexion à X, date d’inscription, changements de nom d’utilisateur0,7 crédit ($0,0035) par compte
API X Verified FollowersComptes vérifiés qui suivent un profil0,7 crédit ($0,0035) par abonné
API Twitter Follow CheckerIndicateurs « suit », « est suivi par » et « mutuel » pour jusqu’à 100 paires0,7 crédit ($0,0035) par paire
API X List TweetsLa timeline d’une liste, du plus récent au plus ancien, avec les reposts signalés0,7 crédit ($0,0035) par post
API Twitter List MembersComptes inscrits sur une liste, sous forme de profils complets0,7 crédit ($0,0035) par membre
API Twitter List FollowersComptes qui suivent une liste, sous forme de profils complets0,7 crédit ($0,0035) par abonné
API X Communities SearchCommunautés correspondant à un mot-clé, avec nombre de membres et URL0,7 crédit ($0,0035) par communauté
API X Community MembersMembres d’une communauté, sous forme de profils complets0,7 crédit ($0,0035) par membre
API X Community ModeratorsAdministrateurs et modérateurs d’une communauté0,7 crédit ($0,0035) par modérateur
API Twitter Media ScraperPosts de l’onglet Médias d’un compte, avec les fichiers en pleine qualité0,7 crédit ($0,0035) par post
API X User RepliesRéponses rédigées par un compte, chacune avec le post auquel elle répond0,7 crédit ($0,0035) par réponse
API X ArticlesTitre de l’Article, ligne d’aperçu, corps complet, couverture et engagement0,7 crédit ($0,0035) par Article
API X SpacesStatut du Space, programmation, hôtes, intervenants, auditeurs et rediffusions0,7 crédit ($0,0035) par Space
API Twitter Video TranscriptTexte parlé de la vidéo d’un post, avec sa durée0,7 crédit ($0,0035) par vidéo jusqu’à 2 minutes

Authentification et flux de tâches asynchrones

Toutes les requêtes s’authentifient avec une clé API. Le même en-tête sert pour l’envoi, le statut de la tâche et la récupération des résultats :

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Chaque collecte s’exécute comme une tâche en arrière-plan :

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

L’appel d’envoi répond immédiatement avec data.task_id et data.status. Interrogez la tâche avec cet ID :

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Lorsque status vaut succeeded, la réponse contient result_count, credits_amount et la première page d’enregistrements normalisés dans data.results.items. limit vaut 50 par défaut et peut aller jusqu’à 500. Si results.has_more vaut true, passez results.next_cursor comme cursor pour lire la page suivante. Une tâche en échec porte error_message.

Chaque endpoint ci-dessous accepte aussi un callback_url facultatif. SocQ envoie un POST avec un résumé de la tâche lorsqu’elle se termine ; lisez les enregistrements depuis l’endpoint des tâches. Un délai d’expiration côté client n’annule pas une tâche : reprenez avec le même ID de tâche au lieu de renvoyer la requête. Un 402 signifie que le compte n’a plus de crédits, et un 429 que la clé a atteint une limite de débit ou de crédits.

Remarque sur results_limit : pour Verified Followers et les endpoints de membres de listes et de communautés, il s’applique à chaque entrée, vaut 100 par défaut et doit être un multiple de 20 compris entre 20 et 2000. Pour Communities Search, il doit être un multiple de 10 compris entre 10 et 500.

Vérifier des comptes et leurs relations

Account Location lit le panneau « About this account » : country, connected_via (par exemple United States App Store ou Web), la date d’inscription, username_changes_count et affiliate_username. Utilisez-le pour vérifier des influenceurs et repérer des comptes coordonnés. Certains comptes, comme de nombreux comptes gouvernementaux, n’ont pas de pays ; ils renvoient tout de même une ligne avec country: null. (docs)

curl -X POST "https://api.socq.ai/v1/x/user-about" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["elonmusk", "BBCWorld"]}'

Verified Followers renvoie la liste que X affiche sous l’onglet Abonnés vérifiés. Chaque ligne est un abonné vérifié (actor) relié au compte demandé (related_actor). Utilisez-le pour mesurer la part influente d’une audience ou constituer une liste de prospection à partir des abonnés d’un concurrent. (docs)

curl -X POST "https://api.socq.ai/v1/x/verified-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["NASA"], "results_limit": 20}'

Follow Checker compare un username avec jusqu’à 100 usernames. Chaque paire renvoie is_following, is_followed_by et is_mutual. Utilisez-le pour confirmer que les participants d’une campagne suivent votre marque. (docs)

curl -X POST "https://api.socq.ai/v1/x/check-follow" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk", "usernames": ["SpaceX", "NASA"]}'

Lire les listes X

Les trois endpoints acceptent des URL de listes publiques au format /i/lists/{numeric_id}.

List Tweets renvoie la timeline de la liste, du plus récent au plus ancien. Les reposts sont conservés et marqués par is_repost, avec reposted_post_id et reposted_author, pour que vous puissiez les filtrer. Une seule requête surveille toute une niche. (docs)

curl -X POST "https://api.socq.ai/v1/x/list-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

List Members exporte les comptes d’une liste sous forme de profils complets avec bio, localisation, site web, vérification et nombres d’abonnés, d’abonnements et de posts. Une liste sélectionnée à la main est une base de prospection toute prête. (docs)

curl -X POST "https://api.socq.ai/v1/x/list-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

List Followers renvoie les comptes abonnés à une liste, dans le même format de profil. Suivre une liste exprime un intérêt déclaré pour son sujet, ce qui en fait un segment de recherche précis. (docs)

curl -X POST "https://api.socq.ai/v1/x/list-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

Cartographier les communautés X

Communities Search trouve des communautés par mot-clé, avec nom, nombre de membres, bannière, is_nsfw et URL de la communauté. (docs)

curl -X POST "https://api.socq.ai/v1/x/search-communities" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "bitcoin", "results_limit": 20}'

Passez une URL de communauté (/i/communities/{numeric_id}) à Community Members pour obtenir ses membres sous forme de profils complets. (docs)

curl -X POST "https://api.socq.ai/v1/x/community-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 20}'

Community Moderators renvoie toute l’équipe, administrateurs compris, en une seule requête. Ce sont les contacts à privilégier pour un sponsoring ou une AMA. (docs)

curl -X POST "https://api.socq.ai/v1/x/community-moderators" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/communities/1493446837214187523"]}'

La description et les règles d’une communauté sont traitées dans le guide des détails de communauté, et ses posts dans le guide des posts de communauté.

Collecter les médias et les réponses d’un compte

Les deux endpoints prennent un seul username ; results_limit vaut 20 par défaut et accepte de 1 à 1000.

Media Scraper renvoie les posts de l’onglet Médias d’un compte, du plus récent au plus ancien, avec texte, engagement, vues et fichiers médias. Les vidéos pointent vers le MP4 de la meilleure qualité disponible. (docs)

curl -X POST "https://api.socq.ai/v1/x/user-media" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "NASA", "results_limit": 20}'

User Replies renvoie l’onglet Réponses du compte, du plus récent au plus ancien. Chaque réponse porte in_reply_to avec le texte, l’auteur, le lien et l’heure du post auquel elle répond, si bien que chaque ligne se lit comme un échange complet. (docs)

curl -X POST "https://api.socq.ai/v1/x/user-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk", "results_limit": 20}'

Pour des conversations entières, consultez le guide du contexte des threads.

Lire les Articles, les Spaces et la parole des vidéos

Articles prend l’URL du post qui publie un Article (/{username}/status/{post_id}) et renvoie title, la ligne d’aperçu dans summary, le corps complet dans text, l’image de couverture, l’auteur ainsi que les likes, réponses, citations et vues. Un post qui n’est pas un Article ne renvoie aucune ligne ; si aucune des URL n’est un Article, la tâche échoue et n’est pas facturée. (docs)

curl -X POST "https://api.socq.ai/v1/x/article" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/USDOL/status/2119796255089947070"]}'

Spaces prend des liens /i/spaces/{space_id}. Chaque Space renvoie son titre, status (programmé, en direct ou terminé), scheduled_start_at, les hôtes, les intervenants, les auditeurs en direct, les vues de la rediffusion et is_replay_available. (docs)

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"]}'

Video Transcript transforme la parole de la vidéo d’un post en texte brut, avec duration_seconds. Une vidéo jusqu’à 2 minutes coûte 0,7 crédit. Une vidéo plus longue coûte 4 crédits ($0,02) par minute entamée de sa durée totale : une vidéo de 3 minutes coûte donc 12 crédits ($0,06). Les posts sans vidéo ne renvoient aucune ligne et ne sont pas facturés. (docs)

curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/NASA/status/2119833829389041896"]}'

Guides X associés

Pour comparer SocQ à d’autres fournisseurs de données X et à l’API officielle, lisez Tarifs de l’API Twitter et meilleures alternatives à l’API X, Les 7 meilleures API de scraping Twitter/X et Alternatives à TwitterAPI.io.

FAQ

Que renvoie l’API X Account Location quand X n’indique aucun pays ?

Une ligne avec country à null. Les autres champs, comme connected_via et la date d’inscription, sont tout de même renvoyés.

Pourquoi results_limit doit-il être un multiple de 20 ?

C’est la règle pour Verified Followers, List Tweets, List Members, List Followers et Community Members : de 20 à 2000 par pas de 20, appliqué à chaque entrée. Communities Search utilise des pas de 10, de 10 à 500.

Suis-je facturé pour les posts qui ne sont pas des Articles ou qui n’ont pas de vidéo ?

Non. Ces posts ne renvoient aucune ligne, et vous ne payez que les lignes renvoyées. Si aucune des URL envoyées à l’API Articles n’est un Article, la tâche échoue et n’est pas facturée.

Combien coûte la transcription d’une vidéo longue ?

Jusqu’à 2 minutes : 0,7 crédit. Au-delà : 4 crédits par minute entamée de la durée totale, donc 3 minutes coûtent 12 crédits et 5 minutes 20 crédits ($0,10).

Puis-je vérifier de nombreuses relations d’abonnement en une fois ?

Oui. Follow Checker compare un compte avec jusqu’à 100 autres en une requête, facturé 0,7 crédit par paire.

X API

Tester le workflow avec une URL publique X

Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.

Découvrir les API X