Twitter List Members
Los miembros de una lista de Twitter son las cuentas que el propietario de esa lista de X eligió y agregó a mano, y cada una tiene un perfil público con nombre, biografía, ubicación, sitio web, verificación, fecha de registro y conteos de seguidores, seguidos y posts. Como alguien del sector ya hizo la selección, estos perfiles ya sirven como una lista corta para prospección, investigación de influencers y enriquecimiento de cuentas, y las instantáneas repetidas registran cómo cambia un grupo seleccionado.
Funcionalidades de la Twitter List Members API
- Cuentas elegidas por el propietario a partir de la URL de la listaCada URL x.com/i/lists/<id> que envíe devuelve las cuentas que su propietario incluyó en la lista, hasta 2,000 por lista, y convierte un grupo seleccionado a mano en filas que puede ordenar y filtrar.
- Un perfil completo de cada miembroLas filas traen username, nombre visible, la biografía en text, las imágenes de avatar y de portada, el sitio web y location.name, datos suficientes para decidir desde la propia fila si una cuenta encaja.
- Alcance, actividad y antigüedad de la cuentametrics.followers_count, following_count y posts_count muestran la audiencia y la producción de cada miembro, y published_at indica la fecha en que la cuenta se unió a X.
- Indicadores de verificación y privacidadis_verified e is_private marcan a los miembros verificados y a las cuentas protegidas, de modo que cada grupo puede tratarse por separado.
Parámetros de la Twitter List Members API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL de listas públicas de X que terminan en /i/lists/<numeric id>, por ejemplo https://x.com/i/lists/1940592907737845989. Los miembros de cada lista se devuelven por separado. |
results_limit | Opcional | Cantidad máxima de miembros que se exportan de cada lista, en pasos de 20 de 20 a 2,000. El valor predeterminado es 100. |
Cómo usar la Twitter List Members API
Envíe las URL de las listas que quiere exportar y recopile los perfiles de los miembros cuando la tarea termine.
- Copie la URL de cada lista desde x.com y envíe {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} por POST a /v1/x/list-members.
- Consulte GET /v1/tasks/{task_id} cada pocos segundos hasta que el estado sea succeeded.
- Guarde los perfiles de los miembros de 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/list-members" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'
# Each member's bio is in text and the date the account joined X is in published_at.Casos de uso de la Twitter List Members API
- Convertir una lista seleccionada en una lista corta de prospectos: Exporte una lista como fundadores de fintech o investigadores de IA y conserve los miembros cuya biografía en text y cuyo sitio web coincidan con su oferta antes de contactarlos.
- Clasificar y segmentar las cuentas de un nicho: Ordene a los miembros por metrics.followers_count y divídalos por is_verified o location.name para separar las voces más grandes y los grupos regionales.
- Enriquecer registros de CRM y de clientes potenciales: Agregue username, el sitio web, location.name y la biografía a los registros de contacto, relacionados por el id de cuenta de cada miembro.
- Registrar cómo cambia una lista: Exporte la misma lista de forma programada y compare los id de los miembros entre ejecuciones para ver quién se agregó o se quitó.
Consejos de expertos para la Twitter List Members API
- Relacione a los miembros entre exportaciones por id, porque los nombres de usuario pueden cambiar.
- Lea location.name para saber dónde dice estar un miembro; city, region y country pueden ser null aunque se muestre un lugar, así que analice location.name por su cuenta antes de agrupar por país.
- Defina results_limit en el siguiente múltiplo de 20 por encima de la cantidad de miembros de la lista para exportarla completa en una sola tarea; solo se cobran los miembros devueltos.
- Envíe la misma URL de lista a X List Tweets API para leer lo que publican estos miembros, y a Twitter List Followers API para ver quién lee la lista.
APIs relacionadas
Además de la Twitter List 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 Post Retweeters API — Recolecta, a nivel de tarea, un conjunto único de perfiles públicos normalizados de las cuentas que hicieron repost de URLs de estado conocidas de X o Twitter.
- 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 List Tweets API — Lee la cronología de una lista, de lo más reciente a lo más antiguo, con los reposts marcados y su autor original.
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- Twitter List Followers API
- X Community Members API
- X Community Moderators 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