x/
followers-list

Recopile las cuentas públicas que siguen a uno o más nombres de usuario de X, con identidades normalizadas, métricas visibles del perfil, tareas asíncronas y recuperación por cursor.

X Followers List API

Cuentas de seguidores
Métricas del perfil
Recopilación por lotes
0.5 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

X Followers List

La lista de seguidores de X es el conjunto de registros de cuentas públicas de las personas que siguen a un nombre de usuario enviado, en el momento de la recopilación. Sirve para investigar audiencias y enriquecer listas, y está sujeta a la disponibilidad pública, a la paginación del proveedor y a la deduplicación a nivel de tarea.

Funcionalidades de la X Followers List API

  • Recopilación de seguidores de varias cuentasEnvíe uno o más nombres de usuario públicos de X en una sola tarea, con o sin una @ inicial.
  • Controles de resultados por nombre de usuarioSolicite de 200 a 2,000 registros de seguidores por nombre de usuario, en incrementos de 200; el valor predeterminado es 200.
  • Registros normalizados de cuentas públicasReciba los ID de cuenta, las URL canónicas de los perfiles, la identidad del autor, los contadores visibles del perfil y las marcas de tiempo normalizadas mediante el resultado público de la tarea.
  • Opciones de entrega asíncronaConsulte los resultados de la tarea con un cursor opaco hasta que termine la recopilación y continúe después por todas las páginas de resultados disponibles.

Parámetros de la X Followers List API

ParámetrosObligatorioDescripción
usernamesObligatorioLista obligatoria de nombres de usuario públicos de X. Los valores pueden incluir u omitir una @ inicial; se recortan los espacios y se eliminan los nombres de usuario duplicados sin distinguir mayúsculas y minúsculas antes de la recopilación.
results_limitOpcionalMáximo de resultados que se recopilan por cada nombre de usuario. El valor predeterminado es 200 y se aceptan múltiplos de 200 de 200 a 2,000.

Cómo usar la X Followers List API

Inicie una tarea de recopilación de seguidores, espere a que termine y recorra por páginas los registros de cuentas públicas guardados.

  1. Prepare uno o más nombres de usuario públicos de X; la @ inicial es opcional.
  2. Envíe por POST usernames y un results_limit válido a /v1/x/followers-list y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea llegue a succeeded o failed.
  4. Tras el éxito, lea data.results.items y devuelva next_cursor al endpoint de la tarea mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/x/followers-list" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@X"],"results_limit":200}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la X Followers List API

  • Crear muestras para investigar audiencias: Recopile las cuentas públicas que siguen a perfiles de X seleccionados y analice la escala visible de las cuentas en la muestra devuelta.
  • Enriquecer directorios de cuentas conocidas: Agregue URL canónicas de perfiles de X, identidades visibles, ID de cuenta y contadores visibles a los registros de cuentas de sus sistemas posteriores.
  • Crear instantáneas de seguidores repetibles: Ejecute con el tiempo la misma recopilación acotada y conserve las marcas de tiempo de las tareas para comparar los conjuntos de cuentas públicas guardados.

Consejos de expertos para la X Followers List API

  • Elimine los nombres de usuario duplicados antes del envío, porque la estimación temporal de créditos usa la longitud de la lista enviada, mientras que la recopilación normaliza los identificadores duplicados.
  • Trate results_limit como un tope por nombre de usuario y no como una promesa de que cada cuenta devolverá la cantidad solicitada de registros públicos.
  • Use el id de cada resultado como clave estable; un mismo seguidor que aparezca bajo varios nombres de usuario enviados se guarda una sola vez dentro de una tarea.
  • Mantenga separada la paginación del proveedor de la recuperación de resultados: solo el next_cursor opaco de /v1/tasks/{task_id} es público.
  • Gestione los resultados vacíos y parciales sin hacer fallar el flujo de trabajo, porque las cuentas no disponibles, las restricciones de acceso o una fuente agotada pueden acortar una recopilación.

Además de la X Followers List 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 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 Community API — Lee enlaces de comunidades para obtener descripciones, cantidad de miembros, reglas y políticas de ingreso.
  • X Verified Followers API — Recolecta las cuentas verificadas que siguen un perfil, con su nombre de usuario, nombre visible, foto de perfil y fecha de registro.
  • Twitter Follow Checker API — Comprueba si una cuenta sigue a otras y si estas la siguen de vuelta.

Explorar otras plataformas

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

X Followers List API — FAQ

X Followers List API es una interfaz programática para recopilar los registros públicos de las cuentas de las personas que siguen a uno o más nombres de usuario de X enviados.

Envíe una lista usernames que no esté vacía. Cada valor puede incluir u omitir una @ inicial; los espacios circundantes se recortan y los identificadores duplicados se eliminan sin distinguir mayúsculas y minúsculas antes de la recopilación del proveedor.

El valor se aplica por separado a cada nombre de usuario, su valor predeterminado es 200 y debe ser un múltiplo de 200 entre 200 y 2,000. Es un tope, así que la disponibilidad pública y la paginación pueden producir menos resultados.

El serializador actual de la tarea devuelve el ID de la cuenta, la URL canónica del perfil, el ID del autor, el nombre de usuario y el nombre, las métricas visibles del perfil, la fecha de creación normalizada de la cuenta cuando está disponible y la fecha de creación del registro guardado.

Las filas repetidas del proveedor se deduplican por ID de cuenta, y una misma cuenta se guarda una sola vez en toda la tarea, incluso si sigue a más de un nombre de usuario enviado.

Cada resultado guardado de forma única cuesta 0.5 créditos de SocQ. La tarea se cobra por adelantado como results_limit multiplicado por la cantidad de nombres de usuario enviados, y los créditos no usados se reembolsan tras la liquidación exitosa; un resultado vacío cuesta cero créditos.