x/
search-communities

Busque comunidades de X por palabra clave y obtenga el nombre, el enlace, la imagen de portada, la cantidad de miembros y el indicador de contenido sensible de cada coincidencia, con hasta 500 comunidades por búsqueda.

X Communities Search API

Búsqueda por palabra clave
Miembros por comunidad
Indicador de contenido sensible
0.7 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
queryObligatorioLa palabra clave con la que se buscan comunidades de X, como bitcoin.
results_limitOpcionalCuá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.

  1. Envíe {"query": "bitcoin", "results_limit": 20} por POST a /v1/x/search-communities.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. 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.

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.

Explorar otras plataformas

Combine los datos de X con datos públicos de otras plataformas sociales compatibles.

X Communities Search API — FAQ

X Communities Search API es una interfaz programática para encontrar comunidades de X que coinciden con una palabra clave. Devuelve el id, la url, el nombre, la imagen de portada, la cantidad de miembros y el indicador de contenido sensible de cada comunidad.

Envíe la palabra clave en query, por ejemplo bitcoin. Las comunidades que coinciden vuelven con sus nombres, enlaces y cantidad de miembros, listas para abrirse en X o pasarse a otro endpoint de comunidades.

Sí, en su propio código. Cada resultado incluye metrics.members_count, así que primero recopile las coincidencias y luego ordénelas o aplique un tamaño mínimo.

Hasta 500. results_limit acepta múltiplos de 10 de 10 a 500 y su valor predeterminado es 20; lea los resultados página por página con next_cursor.

Es true cuando X marca la comunidad como una que contiene contenido sensible, y false en caso contrario.

No. Los resultados de búsqueda muestran el nombre, la imagen de portada, la cantidad de miembros y el indicador de contenido sensible. Pase la url a X Community API para obtener la descripción, las reglas y las políticas de ingreso.

Ninguna comunidad coincidió con ella. La tarea termina con éxito con un resultado vacío y no se cobra nada.