X Communities Search
Las comunidades de X son grupos temáticos a los que las personas se unen en X, y en un listado de búsqueda cada una muestra un nombre, una imagen de portada, la cantidad de miembros y un indicador de si está marcada como sensible. Buscar una palabra clave en esos listados revela dónde se habla de un tema, qué grupos son los más grandes y cuáles llevan una etiqueta de contenido adulto o sensible antes de que alguien los abra.
Funcionalidades de la X Communities Search API
- Una palabra clave, todas las comunidades que coincidenPonga una palabra o frase en query, como bitcoin, y las comunidades que X muestra para ella vuelven en una fila cada una.
- Nombre e imagen de portadaname y cover_url dan el título y la imagen de portada de cada comunidad, suficientes para reconocerla en una lista o mostrarla en su propia interfaz.
- Cantidad de miembros para dimensionarmetrics.members_count indica cuántas personas se unieron, así que un grupo diminuto y una comunidad de decenas de miles pueden distinguirse directamente desde la búsqueda.
- Marca de contenido sensibleis_nsfw es true cuando la comunidad está marcada como sensible en X, lo que permite tratar los espacios para adultos antes de que lleguen a un informe o a un usuario.
- ID y enlace establesCada fila incluye el id numérico de la comunidad y su url https://x.com/i/communities/<id>, que se mantienen iguales entre búsquedas y sirven como clave en sus propios datos.
Parámetros de la X Communities Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | La palabra clave con la que se buscan comunidades de X, como bitcoin. |
results_limit | Opcional | Cuántas comunidades se devuelven, en múltiplos de 10 de 10 a 500. El valor predeterminado es 20. |
Cómo usar la X Communities Search API
Busque una palabra clave y recorra por páginas las comunidades que coinciden.
- Envíe {"query": "bitcoin", "results_limit": 20} por POST a /v1/x/search-communities.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea las comunidades que coinciden en results.items; mientras has_more sea true, solicite la página siguiente con 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.Casos de uso de la X Communities Search API
- Mapear dónde vive un tema en X: Busque los términos principales de un mercado o de un pasatiempo y recopile los nombres, los enlaces y la cantidad de miembros de las comunidades que muestran dónde se concentra su conversación.
- Preseleccionar las comunidades más grandes de un nicho: Ordene las coincidencias por metrics.members_count para elegir las pocas comunidades lo bastante grandes como para justificar un patrocinio, un post o una revisión más detallada.
- Mantener las listas de comunidades seguras para la marca: Descarte todas las filas con is_nsfw en true antes de compartir una lista de comunidades con un cliente o de mostrarla dentro de un producto.
- Alimentar exportaciones de miembros y moderadores: Pase la url de cada comunidad preseleccionada a X Community Members o X Community Moderators para pasar de una lista de grupos a las personas que los integran.
Consejos de expertos para la X Communities Search API
- Busque variantes cercanas de un término, como bitcoin y btc, y combine los resultados por id, porque una misma comunidad puede coincidir con varias palabras clave.
- Para seguir cómo crecen las comunidades, repita la misma búsqueda de forma programada y guarde metrics.members_count con collected_at bajo cada id.
APIs relacionadas
Además de la X Communities Search API, use estas APIs cuando necesite otro tipo de datos públicos de X.
- Twitter Search API — Encuentra posts públicos mediante una expresión de búsqueda, con orden por más recientes o más populares y un límite de resultados configurable.
- X Trends API — Recolecta instantáneas de las tendencias públicas actuales de X para WOEIDs numéricos conocidos, con posición de origen, consulta, descripción y contexto de ubicación.
- Twitter User Search API — Encuentra cuentas públicas de X por palabra clave.
- X Community API — Lee enlaces de comunidades para obtener descripciones, cantidad de miembros, reglas y políticas de ingreso.
- X Community Posts API — Lee los posts públicos compartidos en una comunidad, con su texto, autores y conteos de interacción.
- X Community Members API — Exporta los miembros de una comunidad como perfiles completos con biografía y número de seguidores.
- 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