instagram/
following-list

Recopile los perfiles públicos que siguen las cuentas de Instagram, con nombres de usuario normalizados, enlaces de perfil, señales de visibilidad, contexto de la relación y conteos visibles.

Instagram Following List API

Relaciones de seguidos
Perfiles públicos
Nombres de usuario por lotes
0.3 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

Instagram Following List

Los registros de Instagram Following List representan los perfiles públicos que sigue un nombre de usuario de origen, con identidad normalizada, URL de perfil, señales de visibilidad y contexto de la relación. Las recopilaciones repetidas permiten crear instantáneas de relaciones, mientras que collected_at, source_username y position conservan cuándo y dónde se observó cada registro.

Funcionalidades de la Instagram Following List API

  • Nombres de usuario de origen por lotesEnvíe uno o más nombres de usuario públicos de Instagram en una sola tarea, sin el carácter @ inicial.
  • Procedencia de la relaciónConserva source_username, relationship y position en extra para poder rastrear cada perfil hasta su cuenta de origen.
  • Identidad de perfil normalizadaRecibe el ID de perfil, nombre de usuario, nombre visible, URL canónica del perfil, avatar y las señales públicas de verificación o privacidad cuando están disponibles.
  • Métricas visibles de la cuentaUse los conteos de seguidores, seguidos y publicaciones devueltos cuando esos valores públicos estén presentes en el registro recopilado.
  • Paginación asíncrona de resultadosEnvíe el trabajo de recopilación fuera del hilo de la solicitud, consulte el estado de la tarea y recorra los resultados normalizados con next_cursor.

Parámetros de la Instagram Following List API

ParámetrosObligatorioDescripción
usernamesObligatorioUno o más nombres de usuario públicos de Instagram sin @, separados por comas o saltos de línea.
results_limitOpcionalCantidad máxima de perfiles seguidos solicitados por nombre de usuario de origen; un entero de 1 a 2,000, con 100 como valor predeterminado.

Cómo usar la Instagram Following List API

Envíe nombres de usuario públicos como una tarea asíncrona, consulte el ID de tarea devuelto y luego lea los perfiles seguidos normalizados con paginación por cursor.

  1. Prepare uno o más nombres de usuario públicos de Instagram sin el carácter @ inicial.
  2. Envíe usernames y un results_limit opcional de 1 a 2,000 por POST a /v1/instagram/following-list.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
  4. Lea /v1/tasks/{task_id}?limit=50 y continúe con results.next_cursor cuando has_more sea true.
curl -X POST "https://api.socq.ai/v1/instagram/following-list" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursor

Casos de uso de la Instagram Following List API

  • Mapeo de redes de creadores: Construya mapas revisables de qué creadores de contenido, medios y organizaciones públicos siguen las cuentas seleccionadas.
  • Investigación de cuentas de marca: Compare las relaciones de seguidos visibles entre cuentas de marca, de campaña, regionales o de competidores.
  • Descubrimiento de alianzas: Identifique los perfiles públicos que aparecen en las listas de seguidos de cuentas relevantes para un programa de alianzas.
  • Enriquecimiento de directorios de perfiles: Agregue URL canónicas, nombres visibles, avatares, señales de cuenta y procedencia de la relación a los directorios internos.
  • Seguimiento de cambios en las relaciones: Almacene instantáneas con marca de tiempo y compare los IDs de perfil estables entre ejecuciones para revisar altas y bajas.

Consejos de expertos para la Instagram Following List API

  • Elimine la @ inicial de cada nombre de usuario antes de enviarlo; la entrada del proveedor se normaliza a nombres de usuario simples.
  • Comience con un results_limit acotado y auméntelo solo cuando el flujo de trabajo necesite un conjunto de relaciones visibles más grande.
  • Guarde el ID de perfil junto con extra.source_username, porque el mismo perfil seguido puede aparecer para varias cuentas de origen.
  • Considere normal la variabilidad de los resultados públicos cuando falten avatares, métricas de la cuenta, señales de verificación o posiciones.
  • Prevea resultados vacíos o parciales, porque las relaciones privadas, restringidas, eliminadas o que requieren iniciar sesión quedan fuera del límite admitido.

Además de la Instagram Following List API, use estas APIs cuando necesite otro tipo de datos públicos de Instagram.

  • Instagram Followers Count API — Obtiene la identidad del perfil público y los conteos visibles de seguidores, seguidos y publicaciones.
  • Instagram Posts API — Recolecta publicaciones públicas, contenido multimedia, hashtags, menciones, marcas de tiempo e interacción por nombre de usuario.
  • Instagram Profiles API — Obtiene por nombre de usuario la identidad del perfil público, biografías, enlaces, indicadores de cuenta, categorías y conteos visibles.
  • Instagram Followers List API — Recolecta registros de perfiles públicos de seguidores, con contexto de la cuenta de origen y de la relación.
  • Instagram Similar Accounts API — Lista las cuentas que Instagram sugiere como similares a un nombre de usuario, con nombres de usuario, nombres, avatares y estado de verificación.
  • Instagram Post Likers API — Lista las cuentas de la lista visible de quienes dieron Me gusta a una publicación a partir de su URL, con nombres de usuario, nombres, avatares y estado de verificación.

Explorar otras plataformas

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

Instagram Following List API — FAQ

Instagram Following List API es una interfaz programática para recuperar los registros de perfiles públicos visibles en las listas de seguidos de los nombres de usuario de Instagram enviados. Devuelve identidad normalizada, URL de perfil, señales de visibilidad, contexto de la cuenta de origen, posición en la lista y las métricas de cuenta disponibles.

Following devuelve registros individuales de perfiles públicos de una relación de seguidos visible, mientras que Followers Count devuelve totales de audiencia y publicaciones a nivel de perfil, sin una lista de relaciones.

Los registros pueden incluir ID, nombre de usuario, nombre visible, URL de perfil, URL del avatar, señales de verificación y privacidad, métricas visibles, collected_at, source_username, relationship y position.

Sí. Envíe uno o más nombres de usuario públicos en la lista usernames; source_username identifica qué cuenta de entrada generó cada registro de relación cuando ese campo está disponible.

Solo se pueden devolver las relaciones visibles de perfiles públicos. Los datos de relaciones privadas, restringidas, eliminadas o que requieren iniciar sesión pueden producir resultados parciales o vacíos.

Lea la tarea completada con un límite de hasta 500 registros por página y luego pase results.next_cursor en la siguiente solicitud mientras results.has_more sea true.

Los resultados normalizados exitosos se facturan a 0.3 créditos por registro, sin cargo base; un resultado vacío se rige por la política de solo cargo base y por lo tanto cuesta cero créditos.