x/
list-followers

Vea quién está suscrito a listas públicas de X: envíe la URL de una lista y obtenga la biografía, la ubicación, el indicador de verificación, la fecha de registro y los conteos de seguidores, seguidos y posts de cada seguidor.

Twitter List Followers API

URL de la lista
Suscriptores de la lista
Hasta 2,000 por lista
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

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ámetrosObligatorioDescripción
urlsObligatorioUna 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_limitOpcionalSeguidores 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.

  1. Envíe {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} por POST a /v1/x/list-followers y guarde el task_id.
  2. Llame a GET /v1/tasks/{task_id} a intervalos hasta que status pase a succeeded.
  3. 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.

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.

Explorar otras plataformas

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

Twitter List Followers API — FAQ

Twitter List Followers API es una interfaz programática para recopilar las cuentas que siguen listas públicas de X, o que están suscritas a ellas, a partir de la URL /i/lists de cada lista. Devuelve el username, el nombre, la biografía, la ubicación, el sitio web, los indicadores de verificación y de privacidad, la fecha de registro y los conteos de seguidores, seguidos y posts de cada seguidor.

Sí, en el caso de las listas públicas. Envíe la URL de la lista y cada suscriptor vuelve como una fila de perfil, hasta 2,000 por lista.

Los seguidores se suscribieron a una lista para leer su línea de tiempo; los miembros son las cuentas que el propietario de la lista agregó. Esta API devuelve seguidores y Twitter List Members API devuelve miembros.

No. Devuelve los suscriptores de una lista. Para obtener las cuentas que siguen un perfil de usuario, use X Followers List API.

Las listas pequeñas suelen tener pocos suscriptores, y el resultado contiene exactamente las cuentas que siguen la lista. Cada seguidor devuelto cuesta 0.7 créditos y un resultado vacío no tiene costo.