x/
search-communities

Recherchez des communautés X par mot-clé et obtenez pour chaque résultat son nom, son lien, sa bannière, son nombre de membres et son indicateur de contenu sensible, jusqu’à 500 communautés par recherche.

X Communities Search API

Mot-clé en entrée
Nombre de membres par communauté
Indicateur de contenu sensible
0,7 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

X Communities Search

Les communautés X sont des groupes thématiques que l’on rejoint sur X, et dans les résultats de recherche chacune affiche un nom, une bannière, un nombre de membres et une indication de contenu sensible. Lancer un mot-clé sur ces résultats montre où un sujet est discuté, quels groupes sont les plus grands et lesquels portent une mention adulte ou sensible avant même qu’on les ouvre.

Fonctionnalités de la X Communities Search API

  • Un mot-clé, toutes les communautés correspondantesPlacez un mot ou une expression dans query, par exemple bitcoin, et les communautés que X associe à cette recherche reviennent chacune sur une ligne.
  • Nom et bannièrename et cover_url donnent le titre et la bannière de chaque communauté, de quoi la reconnaître dans une liste ou l’afficher dans votre propre interface.
  • Le nombre de membres pour mesurer la taillemetrics.members_count indique combien de personnes ont rejoint la communauté : un petit groupe se distingue ainsi d’une communauté de plusieurs dizaines de milliers de membres dès la recherche.
  • Indicateur de contenu sensibleis_nsfw vaut true lorsque la communauté est signalée comme sensible sur X, ce qui permet de traiter les espaces pour adultes avant qu’ils n’arrivent dans un rapport ou devant un utilisateur.
  • ID et lien stablesChaque ligne contient l’id numérique de la communauté et son url https://x.com/i/communities/<id>, qui restent identiques d’une recherche à l’autre et servent de clé dans vos propres données.

Paramètres de la X Communities Search API

ParamètresObligatoireDescription
queryObligatoireMot-clé à rechercher parmi les communautés X, par exemple bitcoin.
results_limitFacultatifNombre de communautés à renvoyer, multiple de 10 compris entre 10 et 500. 20 par défaut.

Comment utiliser la X Communities Search API

Recherchez un mot-clé et parcourez page par page les communautés correspondantes.

  1. Envoyez {"query": "bitcoin", "results_limit": 20} en POST à /v1/x/search-communities.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez les communautés correspondantes dans results.items ; tant que has_more vaut true, demandez la page suivante avec results.next_cursor.
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}'

# Each result's url can go straight into X Community Members, X Community Moderators or X Community Posts.

Cas d’usage de la X Communities Search API

  • Cartographier où un sujet se discute sur X : Recherchez les termes principaux d’un marché ou d’un loisir et collectez les noms, liens et nombres de membres des communautés qui montrent où se concentre la conversation.
  • Présélectionner les plus grandes communautés d’une niche : Triez les résultats par metrics.members_count pour retenir les quelques communautés assez grandes pour mériter un sponsoring, un post ou un examen plus approfondi.
  • Garder des listes de communautés sûres pour les marques : Écartez chaque ligne où is_nsfw vaut true avant de partager une liste de communautés avec un client ou de l’afficher dans un produit.
  • Alimenter les exports de membres et de modérateurs : Transmettez l’url de chaque communauté retenue à X Community Members ou à X Community Moderators pour passer d’une liste de groupes aux personnes qui les composent.

Conseils d’expert pour la X Communities Search API

  • Lancez des variantes proches d’un terme, comme bitcoin et btc, puis fusionnez les résultats par id, car une même communauté peut correspondre à plusieurs mots-clés.
  • Pour suivre la croissance des communautés, répétez la même requête à intervalles réguliers et stockez metrics.members_count avec collected_at sous chaque id.

En complément de la X Communities Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques X.

  • Twitter Search API — Trouvez des posts publics par expression de recherche, avec tri par récents ou populaires et limite de résultats configurable.
  • X Trends API — Collectez des instantanés des tendances X publiques actuelles pour des WOEID numériques connus, avec rang source, requête, description et contexte géographique.
  • Twitter User Search API — Trouvez des comptes X publics par mot-clé.
  • X Community API — Lisez des liens de communautés pour obtenir descriptions, nombres de membres, règles et conditions d’adhésion.
  • X Community Posts API — Lisez les posts publics partagés dans une communauté, avec leur texte, leurs auteurs et leurs nombres d’interactions.
  • X Community Members API — Exportez les membres d’une communauté sous forme de profils complets avec bio et nombre d’abonnés.

Explorer d’autres plateformes

Combinez les données X avec les données publiques d’autres plateformes sociales prises en charge.

X Communities Search API — FAQ

X Communities Search API est une interface programmatique qui trouve les communautés X correspondant à un mot-clé. Elle renvoie pour chaque communauté son id, son url, son nom, sa bannière, son nombre de membres et son indicateur de contenu sensible.

Envoyez le mot-clé dans query, par exemple bitcoin. Les communautés correspondantes reviennent avec leur nom, leur lien et leur nombre de membres, prêtes à être ouvertes sur X ou transmises à un autre endpoint de communauté.

Oui, dans votre propre code. Chaque résultat inclut metrics.members_count : collectez d’abord les résultats, puis triez-les ou appliquez une taille minimale.

Jusqu’à 500. results_limit accepte les multiples de 10 de 10 à 500 et vaut 20 par défaut ; lisez les résultats page par page avec next_cursor.

Ce champ vaut true lorsque X signale que la communauté contient du contenu sensible, et false dans le cas contraire.

Non. Les résultats de recherche indiquent le nom, la bannière, le nombre de membres et l’indicateur de contenu sensible. Transmettez l’url à X Community API pour obtenir la description, les règles et les conditions d’adhésion.

Aucune communauté n’y correspondait. La tâche réussit tout de même avec un résultat vide, et rien n’est facturé.