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ámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Lista 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_limit | Opcional | Má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.
- Prepare uno o más nombres de usuario públicos de X; la @ inicial es opcional.
- Envíe por POST usernames y un results_limit válido a /v1/x/followers-list y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea llegue a succeeded o failed.
- 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 trueCasos 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.
APIs relacionadas
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.
- 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 Posts API
- X Thread Context API
- X Account Location API
- X List Tweets API
- Twitter List Members 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 Video Transcript API