Twitter List Followers
Los seguidores de una lista de Twitter son las cuentas que se suscribieron a esa lista de X para leer los tweets de sus miembros, y cada una tiene un perfil público con biografía, ubicación, verificación, fecha de registro y conteos de seguidores, seguidos y posts. Seguir una lista es una decisión de mantenerse al día con su tema, así que estos perfiles muestran a quién atrae un nicho, permiten comparar a los lectores de listas relacionadas y señalan a personas a las que vale la pena contactar sobre ese tema.
Funcionalidades de la Twitter List Followers API
- Suscriptores de cualquier lista públicaEnvíe enlaces x.com/i/lists/<id> y obtenga las cuentas que eligieron seguir la línea de tiempo de cada lista, hasta 2,000 por lista.
- Quién es cada seguidorCada fila incluye username, nombre visible, la biografía en text, avatar, imagen de portada, sitio web y location.name, que en conjunto muestran qué tipo de personas atrae una lista.
- Alcance, actividad, antigüedad y verificaciónmetrics.followers_count, following_count y posts_count, published_at como fecha de registro e is_verified ayudan a distinguir a los seguidores consolidados y activos de las cuentas nuevas o con poca actividad.
Parámetros de la Twitter List Followers API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Una o más URL de listas públicas de X, cada una con el formato https://x.com/i/lists/<numeric id>. Se recopilan los seguidores de cada lista incluida. |
results_limit | Opcional | Seguidores que se recopilan por lista: un múltiplo de 20 entre 20 y 2,000, con 100 como valor predeterminado. |
Cómo usar la Twitter List Followers API
Inicie una tarea con una o más URL de listas y luego recorra por páginas las cuentas que siguen cada lista.
- Envíe {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} por POST a /v1/x/list-followers y guarde el task_id.
- Llame a GET /v1/tasks/{task_id} a intervalos hasta que status pase a succeeded.
- Recopile los seguidores de results.items y pase results.next_cursor en la siguiente llamada mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/x/list-followers" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'
# Every item is an account that follows the list; the list's members come from /v1/x/list-members.Casos de uso de la Twitter List Followers API
- Ver quién sigue su propia lista: Recopile los seguidores de una lista pública que usted administra para saber quién la lee y qué lectores tienen las audiencias más grandes según followers_count.
- Perfilar la audiencia de un tema: Lea las biografías y location.name de las personas que siguen una lista de tecnología climática o de fundadores de SaaS para describir quién se interesa por ese tema.
- Seleccionar personas para contactar: Filtre los seguidores por palabras clave en text y por followers_count para elegir cuentas que ya leen sobre su sector.
- Comparar a los lectores de listas rivales: Recopile en una sola tarea los seguidores de dos listas sobre el mismo tema y relaciónelos por id para encontrar a los lectores compartidos y a los exclusivos de cada lista.
- Crear la base de una audiencia similar: Exporte los nombres de usuario y los id de los seguidores de una lista bien elegida como conjunto inicial para la segmentación por audiencias similares o por intereses en sus herramientas de publicidad.
Consejos de expertos para la Twitter List Followers API
- Relacione por id los seguidores con los miembros de la lista obtenidos con Twitter List Members API para encontrar a los miembros que también siguen la lista y a los lectores que quedan fuera de ella.
- Use el mismo results_limit en todas las listas que compare, para que cada audiencia se recopile con la misma profundidad.
- Guarde los id de los seguidores de cada ejecución; así, una exportación posterior de la misma lista muestra quién empezó a seguirla en el intervalo.
APIs relacionadas
Además de la Twitter List Followers 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 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 List Members API — Exporta las cuentas de una lista como perfiles completos con biografía, ubicación y contadores.
- 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 Account Location API
- X Verified 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