x/
list-members

Exporte las cuentas que forman parte de listas públicas de X a partir de sus URL, con el nombre de usuario, la biografía, la ubicación, el sitio web, la verificación y los conteos de seguidores, seguidos y posts de cada miembro.

Twitter List Members API

URL de la lista
Cuentas elegidas por el propietario
Perfiles completos de los miembros
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 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ámetrosObligatorioDescripción
urlsObligatorioURL 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_limitOpcionalCantidad 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.

  1. 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.
  2. Consulte GET /v1/tasks/{task_id} cada pocos segundos hasta que el estado sea succeeded.
  3. 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.

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.

Explorar otras plataformas

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

Twitter List Members API — FAQ

Twitter List Members API es una interfaz programática para exportar las cuentas que pertenecen a listas públicas de X a partir de la URL /i/lists de cada lista. Devuelve un perfil por miembro con username, nombre, biografía, ubicación, sitio web, indicadores de verificación y de privacidad, fecha de registro y conteos de seguidores, seguidos y posts.

Copie la URL de la lista desde x.com, envíela en urls con un results_limit y lea los perfiles de los miembros en la tarea terminada, siguiendo next_cursor mientras has_more sea true. Cada miembro es un registro JSON que puede guardar en una hoja de cálculo o en un CRM.

Sí. Cualquier lista pública puede exportarse a partir de su URL, sin importar quién la creó.

Hasta 2,000 por lista, definidos con results_limit en pasos de 20; el valor predeterminado es 100. Cuando envía varias listas, el límite se aplica a cada una.

Cada miembro devuelto cuesta 0.7 créditos, así que una lista de 100 miembros cuesta 70 créditos. Un resultado vacío no tiene costo.