instagram/
followers-list

Recopile los perfiles públicos de seguidores de Instagram por nombre de usuario, con identidad normalizada, imagen de perfil, indicadores de visibilidad, contexto de origen, posición y hora de recopilación.

Instagram Followers List API

Perfiles de seguidores
Contexto de origen
Relaciones públicas
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 Followers List

Los seguidores de Instagram son registros públicos de relación de los perfiles visibles en la lista de seguidores de un nombre de usuario enviado, con identidad, imagen de perfil, indicadores de verificación y privacidad, contexto de origen, posición y hora de recopilación. Estos campos sirven para muestrear audiencias, comprobar coincidencias entre cuentas, seleccionar perfiles e investigar listas de relaciones.

Funcionalidades de la Instagram Followers List API

  • Recopilación de seguidores de varias cuentasEnvíe uno o más nombres de usuario de Instagram y solicite los perfiles de seguidores de cada cuenta de origen en una sola tarea asíncrona.
  • Identidad normalizada del seguidorDevuelve el ID de perfil, nombre de usuario, nombre visible, URL de perfil derivada e imagen de perfil pública disponibles para cada fila de seguidor.
  • Señales de visibilidad y de origenConserva los indicadores de verificación y de cuenta privada, además del nombre de usuario de origen y la relación de seguidor, cuando esos valores están expuestos.
  • Contexto de la lista observadaMantiene la posición en el origen y la hora de extracción del Actor cuando están disponibles, con la hora de recopilación de SocQ como marca de tiempo alternativa.
  • Control de resultados por nombre de usuarioAplica results_limit por separado a cada nombre de usuario enviado, con un valor predeterminado de 100 y un rango aceptado de 1 a 2,000.

Parámetros de la Instagram Followers List API

ParámetrosObligatorioDescripción
usernamesObligatorioLista obligatoria y no vacía de nombres de usuario de Instagram. Cada elemento debe ser una cadena no vacía; las @ iniciales se eliminan antes de la recopilación.
results_limitOpcionalMáximo de perfiles de seguidores solicitados por nombre de usuario; el valor predeterminado es 100 y acepta enteros de 1 a 2,000.

Cómo usar la Instagram Followers List API

Envíe nombres de usuario públicos de Instagram, siga la tarea asíncrona y recorra por páginas los registros de perfiles de seguidores normalizados cuando la recopilación tenga éxito.

  1. Prepare uno o más nombres de usuario públicos de Instagram; se acepta una @ inicial y se elimina antes de la recopilación.
  2. Envíe usernames y un results_limit opcional por POST a /v1/instagram/followers-list y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o informe una falla.
  4. Lea data.results.items y siga next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/instagram/followers-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 data.results.items and follow next_cursor while has_more is true

Casos de uso de la Instagram Followers List API

  • Muestreo de audiencia pública: Arme una muestra acotada de nombres de usuario de seguidores, nombres visibles, enlaces de perfil, indicadores de visibilidad y posiciones observadas para una cuenta pública seleccionada.
  • Comprobación de coincidencias entre cuentas: Agrupe las filas por extra.source_username y compare los IDs o nombres de usuario de los seguidores para identificar los perfiles que aparecen en más de una cuenta enviada.
  • Colas de enriquecimiento de perfiles: Seleccione los nombres de usuario devueltos y páselos a Instagram Profiles cuando un flujo de trabajo necesite la biografía o los conteos visibles del perfil.
  • Instantáneas de listas de relaciones: Almacene la identidad del seguidor, el nombre de usuario de origen, la posición observada y collected_at para poder distinguir muestras posteriores de la lista pública.

Consejos de expertos para la Instagram Followers List API

  • Al enviar varios nombres de usuario, calcule la profundidad solicitada como la cantidad de nombres de usuario multiplicada por results_limit, porque el tope y la estimación de créditos se aplican por cuenta de origen.
  • Si un nombre de usuario de origen comienza con @, puede enviarlo sin cambios; el mapeador del proveedor elimina las @ iniciales antes de la ejecución del Actor.
  • Al comparar cuentas, conserve extra.source_username, porque el mismo perfil de seguidor puede aparecer en más de una lista de origen y no se garantiza la eliminación de duplicados entre orígenes.
  • Si position está presente, trátelo como un valor observado de la lista y no como una clasificación estable ni como una medida de la solidez de la relación.
  • Cuando una fuente pública devuelva menos filas de las solicitadas, conserve el resultado parcial y registre collected_at; la privacidad, la disponibilidad de la cuenta, la paginación del origen y los límites del Actor pueden reducir la salida.

Además de la Instagram Followers 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 Following List API — Recolecta los perfiles públicos seguidos por cuentas de Instagram, con identidad, contexto de la relación y conteos visibles de la cuenta.
  • 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 Followers List API — FAQ

Instagram Followers List API es una interfaz programática para recuperar los registros de perfiles públicos visibles en las listas de seguidores de los nombres de usuario de Instagram enviados. Devuelve identidad normalizada, imagen de perfil, indicadores de visibilidad, contexto de la cuenta de origen, posición en la lista y hora de recopilación cuando están disponibles.

usernames es obligatorio y debe ser una lista no vacía de cadenas no vacías. results_limit es opcional, tiene un valor predeterminado de 100 por nombre de usuario y acepta enteros de 1 a 2,000.

Un registro puede contener el ID de perfil, nombre de usuario, nombre visible, URL de perfil derivada, imagen de perfil, indicadores de verificación y privacidad, hora de recopilación y campos adicionales para el nombre de usuario de origen, la relación y la posición observada.

No. Devuelve filas individuales de perfiles públicos de seguidores; use Instagram Followers Count API cuando necesite los conteos agregados visibles de seguidores, seguidos y publicaciones de un perfil.

No. Solo se pueden devolver las relaciones visibles a través de la fuente pública compatible, y las cuentas de origen privadas, no disponibles o con errores de escritura pueden no producir filas.

results_limit es un máximo solicitado y no una garantía de que el resultado esté completo. La privacidad del perfil, la disponibilidad de la cuenta, los límites del Actor, la paginación del origen y el límite actual de la lista pública de seguidores pueden reducir el conteo final.

Cada perfil de seguidor devuelto cuesta 0.3 créditos de SocQ. La estimación usa la cantidad de nombres de usuario multiplicada por results_limit, y un conjunto de resultados vacío no tiene cargo por resultado.