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ámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Lista 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_limit | Opcional | Má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.
- Prepare uno o más nombres de usuario públicos de Instagram; se acepta una @ inicial y se elimina antes de la recopilación.
- Envíe usernames y un results_limit opcional por POST a /v1/instagram/followers-list y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o informe una falla.
- 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 trueCasos 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.
APIs relacionadas
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.
- Instagram Reels API
- Instagram Search API
- Instagram Comments API
- Instagram Hashtag Posts API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Comment Replies API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API