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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Enlaces de comunidades públicas de X con el formato https://x.com/i/communities/<numeric_id>, uno por línea. |
results_limit | Opcional | Miembros 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.
- Envíe {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100} por POST a /v1/x/community-members.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- 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.
APIs relacionadas
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.
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API