x/
community-members

Exporte los miembros de una comunidad pública de X a partir de su enlace, con la biografía, la ubicación, el sitio web, el indicador de verificación y los conteos de seguidores de cada miembro, hasta 2,000 por comunidad.

X Community Members API

Enlace de la comunidad
Un perfil por miembro
Hasta 2,000 miembros por comunidad
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 Community Members

Los miembros de una comunidad de X son las cuentas que decidieron unirse a una comunidad temática, y cada una tiene un perfil público con biografía, ubicación, sitio web, estado de verificación, fecha de creación de la cuenta y conteos de seguidores, seguidos y posts. Como unirse es un acto deliberado en torno a un solo tema, estos perfiles describen una audiencia que se eligió a sí misma y que puede dimensionarse, segmentarse por alcance o por lugar y compararse con los miembros de una comunidad vecina.

Funcionalidades de la X Community Members API

  • Listas de miembros a partir de enlaces de comunidadesPegue uno o más enlaces https://x.com/i/communities/<id> y cada miembro de cada comunidad vuelve como una fila de perfil propia.
  • Quién es cada miembroLas filas traen el nombre de usuario, el nombre visible, la biografía en text, el avatar, la imagen de portada, el sitio web y la ubicación declarada, de modo que cada miembro puede reconocerse y describirse con la exportación misma.
  • El alcance de cada miembrometrics contiene followers_count, following_count y posts_count, lo que separa las voces con más alcance de una comunidad de su mayoría silenciosa.
  • Verificación y antigüedad de la cuentais_verified, is_private y published_at, la fecha en que se creó la cuenta de X del miembro, muestran de un vistazo qué tan consolidada está cada persona de la lista.

Parámetros de la X Community Members API

ParámetrosObligatorioDescripción
urlsObligatorioEnlaces de comunidades públicas de X con el formato https://x.com/i/communities/<numeric_id>, uno por línea.
results_limitOpcionalMiembros que se devuelven por cada comunidad, en múltiplos de 20 de 20 a 2,000. El valor predeterminado es 100.

Cómo usar la X Community Members API

Envíe enlaces de comunidades y recorra por páginas los perfiles de los miembros.

  1. Envíe {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100} por POST a /v1/x/community-members.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. Lea los perfiles de los miembros en results.items y devuelva results.next_cursor mientras has_more sea true.
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":100}'

# results_limit is applied to each community in urls, so two links can return up to 200 members here.

Casos de uso de la X Community Members API

  • Perfilar la audiencia de una comunidad: Agrupe a los miembros por location.name, revise las biografías en text en busca de cargos e intereses y grafique followers_count para describir quién se unió realmente a una comunidad.
  • Preseleccionar miembros para alianzas: Ordene a los miembros por metrics.followers_count, conserve los verificados y use el sitio web y la biografía para elegir a los creadores de contenido de un nicho a los que vale la pena contactar.
  • Medir la superposición entre dos comunidades: Exporte los miembros de dos comunidades relacionadas y relaciónelos por id para contar las personas que pertenecen a ambas.
  • Revisar una comunidad en busca de cuentas recientes: Combine un published_at reciente con valores bajos de posts_count y followers_count para ver qué proporción de los miembros de una comunidad son cuentas recién creadas o casi inactivas.

Consejos de expertos para la X Community Members API

  • Envíe una comunidad por tarea cuando piense comparar membresías; las filas de miembros traen solo el perfil, así que la entrada de la tarea es lo que vincula cada fila con su comunidad.
  • Lea primero members_count con X Community o X Communities Search y defina results_limit en el siguiente múltiplo de 20 por encima de esa cifra para solicitar la lista completa en una sola tarea.
  • Normalice location.name antes de agrupar por país: contiene el lugar en texto libre que escribió el miembro, como “Sydney”, y los campos de ciudad y país suelen venir vacíos.

Además de la X Community Members API, use estas APIs cuando necesite otro tipo de datos públicos de X.

  • Twitter Profile Scraper API — Obtiene por nombre de usuario la identidad de la cuenta pública, biografías, avatares, imágenes de portada, estado de la cuenta y estadísticas visibles de audiencia.
  • X Followers List API — Recolecta las identidades de las cuentas seguidoras públicas y las métricas visibles de sus perfiles para uno o más nombres de usuario de X.
  • X Following List API — Recolecta los perfiles seguidos por cuentas públicas de X, incluyendo identidad, biografías, señales de la cuenta, contadores visibles y nombres de usuario de origen.
  • X Community API — Lee enlaces de comunidades para obtener descripciones, cantidad de miembros, reglas y políticas de ingreso.
  • X Account Location API — Consulta el país donde está ubicada una cuenta, cómo se conecta a X, su fecha de registro y sus cambios de nombre de usuario.
  • X Community Moderators API — Obtén los administradores y moderadores de una comunidad como perfiles completos.

Explorar otras plataformas

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

X Community Members API — FAQ

X Community Members API es una interfaz programática para exportar los miembros de comunidades públicas de X a partir de sus enlaces /i/communities/. Devuelve un perfil por miembro con nombre de usuario, biografía, ubicación, sitio web, estado de verificación y conteos de seguidores, seguidos y posts.

Sí. El enlace de la comunidad es la única entrada, así que puede exportar los miembros de una comunidad pública a la que nunca se unió, y no se requiere iniciar sesión en X.

Busque una palabra clave con X Communities Search. Cada resultado incluye la url de la comunidad, que puede pasar a este endpoint sin cambios.

Hasta 2,000. results_limit acepta múltiplos de 20 de 20 a 2,000, su valor predeterminado es 100 y se cuenta por separado para cada enlace de comunidad de la solicitud.

No. published_at es la fecha en que se creó la cuenta de X del miembro. La fecha de ingreso a la comunidad no forma parte del resultado.

Si no se encuentra ninguna de las comunidades de una solicitud, la tarea falla y los créditos se reembolsan por completo. Si solo faltan algunas, los miembros de las demás se devuelven igual.