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ètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Mot-clé à rechercher parmi les communautés X, par exemple bitcoin. |
results_limit | Facultatif | Nombre 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.
- Envoyez {"query": "bitcoin", "results_limit": 20} en POST à /v1/x/search-communities.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- 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.
API associées
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.
- Twitter Tweet Scraper API
- Twitter Profile Scraper API
- Twitter User Tweets Scraper API
- X Followers List API
- X Following List API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- Twitter Mentions API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Moderators API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API