X Following List
Las listas de seguidos de X son relaciones públicas entre cuentas que muestran qué perfiles sigue una cuenta de origen, con identidad, biografías, enlaces, imágenes, estado de la cuenta, contadores y datos de creación. Estos registros sirven para investigar redes de intereses, descubrir cuentas, mapear relaciones y enriquecer conjuntos de datos de perfiles.
Funcionalidades de la X Following List API
- Recopilación de seguidos de varias cuentasAcepta uno o más nombres de usuario públicos de X y aplica una recopilación acotada e independiente de la lista de seguidos a cada cuenta de origen.
- Identidad y contexto del perfilDevuelve los ID, los nombres de usuario, los nombres visibles, las URL canónicas, las biografías, los sitios web, las ubicaciones, los avatares, los banners y las fechas de creación de las cuentas seguidas.
- Señales de la cuenta y contadores públicosCombina las señales visibles de verificación, protección, mensajes, post fijado y automatización con los conteos de seguidores, seguidos, posts, contenido multimedia y Me gusta.
- Registros normalizados con su origenMantiene cada perfil guardado en una estructura pública coherente, con collected_at y extra.input_username para poder rastrear el origen.
Parámetros de la X Following List API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Lista obligatoria de nombres de usuario públicos de X que no estén vacíos. Los valores pueden incluir u omitir una @ inicial. |
results_limit | Opcional | Máximo de perfiles seguidos que se solicitan por nombre de usuario. El valor predeterminado es 200 y se aceptan múltiplos de 200 de 200 a 2000. |
Cómo usar la X Following List API
Envíe nombres de usuario públicos de origen y lea los registros normalizados de perfiles seguidos de la tarea asíncrona completada.
- Prepare uno o más nombres de usuario públicos de X, con o sin una @ inicial, y elija un results_limit por nombre de usuario que sea un múltiplo de 200 de 200 a 2000.
- Envíe por POST usernames y results_limit a /v1/x/following-list y guarde el task_id devuelto.
- Consulte GET /v1/tasks/{task_id} mientras la tarea esté en queued, running o retrying, y deténgase cuando llegue a succeeded o failed.
- Tras el éxito, lea data.results.items y siga solicitando la tarea con next_cursor mientras data.results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/x/following-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 pass next_cursor while data.results.has_more is trueCasos de uso de la X Following List API
- Investigación de redes de intereses: Relacione cada nombre de usuario de origen conservado con las identidades, biografías, enlaces y ubicaciones de los perfiles que sigue, para examinar los intereses públicos en torno a cuentas conocidas.
- Descubrimiento de cuentas a partir de perfiles semilla: Use los nombres, las biografías, las imágenes, las señales de verificación y los contadores visibles para revisar cuentas candidatas encontradas en la lista pública de seguidos de un perfil de origen.
- Enriquecimiento de listas de relaciones: Agregue ID estables, URL canónicas de perfiles, metadatos públicos de las cuentas, contadores y horas de recopilación a registros de relaciones que ya se basan en nombres de usuario.
Consejos de expertos para la X Following List API
- Elimine las @ iniciales y deduplique los nombres de usuario de origen sin distinguir mayúsculas y minúsculas antes del envío, para que los identificadores equivalentes no repitan el trabajo sobre la cuenta de origen.
- Dimensione results_limit por nombre de usuario en incrementos de 200; con varios orígenes, prevea hasta usernames × results_limit registros antes de considerar el final de las listas y la deduplicación a nivel de tarea.
- Al construir un grafo de muchos a muchos, no suponga una fila guardada por cada par perfil de origen y perfil seguido, porque un perfil seguido repetido puede deduplicarse y conservar un único valor de extra.input_username.
- Trate una lista vacía o corta como un resultado de la visibilidad pública y permita que las imágenes, las señales de estado y los contadores opcionales queden como nulos en sus registros posteriores.
- No interprete el orden devuelto como antigüedad de la relación, intensidad de la interacción o respaldo, porque la respuesta expone el orden de recopilación y no esas señales.
APIs relacionadas
Además de la X Following 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.
- Twitter User Tweets Scraper API — Recolecta posts públicos recientes, autores, contenido multimedia, hashtags, menciones e interacción por nombre de usuario, sin incluir respuestas.
- 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 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 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.
- Twitter Tweet 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 Verified Followers 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 Follow Checker API
- Twitter Video Transcript API