x/
following-list

Recopile los perfiles públicos de X seguidos por uno o más nombres de usuario, con identidad, biografías, señales de la cuenta, contadores visibles y contexto de la cuenta de origen.

X Following List API

Relaciones de seguimiento
Contexto del perfil
Límites por cuenta
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 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ámetrosObligatorioDescripción
usernamesObligatorioLista obligatoria de nombres de usuario públicos de X que no estén vacíos. Los valores pueden incluir u omitir una @ inicial.
results_limitOpcionalMá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.

  1. 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.
  2. Envíe por POST usernames y results_limit a /v1/x/following-list y guarde el task_id devuelto.
  3. Consulte GET /v1/tasks/{task_id} mientras la tarea esté en queued, running o retrying, y deténgase cuando llegue a succeeded o failed.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

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

X Following List API — FAQ

X Following List API es una interfaz programática para recopilar los perfiles públicos seguidos por uno o más nombres de usuario de X. Devuelve identidad normalizada, biografías, enlaces, imágenes, señales de la cuenta, contadores visibles, marcas de tiempo y contexto de origen.

Envíe una lista usernames que no esté vacía. Cada identificador público puede incluir u omitir una @ inicial, y los nombres de usuario de origen equivalentes se normalizan sin distinguir mayúsculas y minúsculas antes de la recopilación del proveedor.

results_limit tiene un valor predeterminado de 200, acepta múltiplos de 200 hasta 2000 y se aplica por separado a cada nombre de usuario de origen. Una lista visible puede terminar antes del límite solicitado.

Un registro puede contener el ID del perfil, el nombre de usuario, el nombre visible, la URL canónica, la biografía, el sitio web, la ubicación, el avatar, el banner, las señales de verificación y protección, los contadores públicos, la fecha de creación de la cuenta, la hora de recopilación y extra.input_username.

No necesariamente. Las identidades de perfil estables se deduplican al guardar los resultados, por lo que un perfil seguido por varias cuentas enviadas puede aparecer una sola vez, con el contexto de origen conservado en ese registro guardado.

Las cuentas protegidas o restringidas, los límites de visibilidad pública, las páginas de lista no disponibles o el final de la lista visible de seguidos pueden reducir los registros guardados. Compruebe la accesibilidad pública de la cuenta de origen antes de reintentar.

No. Trate el orden solo como orden de recopilación; no establece cuándo comenzó una relación, con qué frecuencia interactúan las cuentas ni si la cuenta de origen respalda a un perfil seguido.

Cada registro de perfil normalizado guardado cuesta 0.5 créditos. La facturación usa la cantidad real de registros guardados, por lo que un resultado vacío no tiene cargo por unidad de resultado.