API de Lista de seguidores de Instagram

Obtén hasta 500 cuentas que siguen a un usuario de Instagram en JSON, cada una con nombre de usuario, nombre, avatar y señales de privacidad y verificación, por $0.56 por cada 1000 llamadas.

  • Sin cargo por fallos ni resultados vacíos
  • No necesitas iniciar sesión en Instagram
  • Las filas llegan en la misma respuesta

Salud de la API

Salud 24 h
Normal
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Normal

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

    POST /api/v1/social
    {
      "platform": "instagram",
      "action": "followers_list",
      "params": {
        "username": "nasa"
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "username": "",
          "is_private": false,
          "is_verified": false,
          "relation": "Followers"
        },
        …
      ],
      "count": 49
    }
  3. 3Filas

    usernameis_privateis_verifiedrelation
    falsefalseFollowers
    falsefalseFollowers
  4. 4CSV

    instagram-followers_list-sample.csv id,username,url,name,avatar_url,is_private,is_verified,relation,of_user,platform

Entra una solicitud con username, vuelve una respuesta JSON y sus results pasan a ser filas de una tabla y un archivo CSV.

Qué datos obtienes

Cada fila es una cuenta que sigue al usuario. La tabla muestra filas de una llamada real para nasa, obtenidas el 26 de septiembre de 2026, 08:56 (UTC), que devolvió 49 filas; las barras grises marcan datos personales eliminados (••• en el CSV). En tus llamadas recibes estos campos, tal como figuran en la referencia de campos.

idusernameurlnameavatar_urlis_privateis_verifiedrelationof_userplatform
instagram.com/falsefalseFollowersnasainstagram
instagram.com/falsefalseFollowersnasainstagram

Casos de uso

  • Investigar audiencias

    Lee las cuentas que siguen a un creador o a una marca para ver quién forma su audiencia.

  • Comparar dos audiencias

    Haz la llamada para dos cuentas y compara sus listas de seguidores una junto a otra.

  • Revisar la mezcla de seguidores

    Cuenta los valores de is_private y is_verified en las filas devueltas para un creador.

  • Conjuntos de datos

    Exporta las filas de seguidores a CSV y añádelas a un conjunto de datos de investigación.

Instagram Graph API frente a EveryInfra

A continuación se comparan la Graph API oficial de Instagram y followers_list de EveryInfra en datos de seguidores, cuentas accesibles y acceso.

AspectoInstagram Graph APIEveryInfra
Datos de seguidoresCampo followers_count: "Total number of Instagram users following the user."Una lista de las cuentas que siguen al usuario; cada fila trae id, username, url, name, avatar_url, is_private, is_verified, relation, of_user y platform.
Qué cuentas"Get fields and edges on an Instagram Business or Creator Account."La cuenta que indiques en username, como nombre de usuario sin @ o como URL completa del perfil.
Acceso necesarioTokens de acceso: "Facebook User access token" o "Instagram User user access token"; permisos instagram_basic o instagram_business_basic.Una clave de API de EveryInfra en la cabecera Authorization: Bearer. No hace falta iniciar sesión en Instagram ni un token de acceso de Instagram.

Las citas proceden de la documentación para desarrolladores de Meta, comprobadas el 2026-11-09. Fuentes oficiales: IG User (actualizada el 2026-04-22)

Límites y detalles a tener en cuenta

  • limit es un entero de 1 a 500 y vale 50 por defecto; un valor mayor devuelve 422 antes de cualquier cobro.
  • No hay parámetro de cursor ni de página, así que una llamada devuelve como máximo 500 filas de una cuenta.
  • Una llamada puede devolver menos filas que limit, y la lista puede ser parcial.
  • is_verified vale null cuando no se puede determinar la verificación.
  • avatar_url es un enlace a una imagen, y un enlace de CDN con tamaño puede caducar.
  • followers devuelve solo el total de seguidores; followers_list devuelve la lista de cuentas.

Precios

Pagas $0.000556 por llamada, no por fila, y cada llamada lee hasta 500 seguidores de una cuenta. Las llamadas fallidas y los resultados vacíos no se cobran.

LlamadasCosto
10,000$5.56
100,000$55.56
1,000,000$555.56

Los totales se calculan con el precio de lista por llamada.

Ejemplos de código

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "instagram",
  "action": "followers_list",
  "params": {
    "username": "nasa"
  }
}'

Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Referencia de API

Consulta los parámetros, los campos de respuesta, los errores y la facturación de followers_list, y copia la página o ábrela en Markdown para dársela a un asistente de IA.

POST

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Instagram: Lista de seguidores (instagram/followers_list).

Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en instagram y action en followers_list, y los parámetros dentro de params.
- Parámetros obligatorios:
  - username: Handle de la cuenta de Instagram, se recomienda sin el @ o la URL completa del perfil. profile/persona/user_posts/reels consultan los datos de la cuenta.
- Parámetros opcionales:
  - limit: Número máximo de filas que devuelve esta llamada, un entero de 1 a 500. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. (por defecto: 50)
- Devuelve una lista de registros. Campos principales de cada registro: id, username, url, name, avatar_url, is_private, is_verified, relation, of_user.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "instagram",
  "action": "followers_list",
  "params": {
    "username": "nasa"
  }
}
- Precio: $0.56 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.

Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.

Parámetros de la solicitud

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
platformbodystringSíinstagramIdentificador de la plataforma, valor fijo.
actionbodystringSífollowers_listIdentificador de la capacidad, valor fijo.
usernamebody.paramsstringSí-Handle de la cuenta de Instagram, se recomienda sin el @ o la URL completa del perfil. profile/persona/user_posts/reels consultan los datos de la cuenta; followers solo consulta la cantidad de seguidores, followers_list/following_list consultan la lista de cuentas de seguidores/seguidos.
limitbody.paramsinteger (1–500)No50Número máximo de filas que devuelve esta llamada, un entero de 1 a 500. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. Los valores mayores devuelven 422 antes de cualquier cobro.

Ejemplo de respuesta

#
Obtenida el 26 de septiembre de 2026, 08:56 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto); la lista conserva los primeros 2. id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "id": "req_…",  "platform": "instagram",  "action": "followers_list",  "results": [    {      "id": "•••",      "username": "•••",      "url": "https://www.instagram.com/•••",      "name": "•••",      "avatar_url": "https://instagram.ftas7-1.fna.fbcdn.net/•••",      "is_private": false,      "is_verified": false,      "relation": "Followers",      "of_user": "nasa",      "platform": "instagram"    },    {      "id": "•••",      "username": "•••",      "url": "https://www.instagram.com/•••",      "name": "•••",      "avatar_url": "https://scontent-lhr6-1.cdninstagram.com/•••",      "is_private": false,      "is_verified": false,      "relation": "Followers",      "of_user": "nasa",      "platform": "instagram"    }  ],  "count": 49,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campos de la respuesta

#

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.

CampoSignificado
idIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
usernameNombre de usuario (@usuario).
urlEnlace al registro en la plataforma.
nameNombre del propio objeto, en capacidades de cuentas, productos y negocios.
avatar_urlEnlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar.
is_privateConserva el significado de la plataforma
is_verifiedSi la plataforma verificó la cuenta. null significa que no se puede determinar.
relationConserva el significado de la plataforma
of_userConserva el significado de la plataforma
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Errores y facturación

#
401
Falta la clave o no es válida.
402
Saldo insuficiente. Recarga primero.
422
Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
429
Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
503
No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
200 vacío
Sin datos. Sin cargo.

Errores

Preguntas frecuentes

¿Qué devuelve la API de Instagram de lista de seguidores?

Devuelve las cuentas que siguen a un usuario de Instagram, buscado por username, una fila por cuenta con id, username, url, name, avatar_url, is_private, is_verified, relation, of_user y platform. La lista puede ser parcial.

¿Cuántos seguidores devuelve una llamada?

Como máximo 500 filas de una cuenta. Fija limit entre 1 y 500; el valor por defecto es 50 y una llamada puede devolver menos filas. No hay parámetro de cursor ni de página.

¿Cuánto cuesta?

Cuesta $0.000556 por llamada, o $0.56 por cada 1000 llamadas, y se factura por llamada, no por fila. Las llamadas fallidas y los resultados vacíos no se cobran.

¿Necesito iniciar sesión en Instagram?

No. Envías una clave de API de EveryInfra en la cabecera Authorization: Bearer. La solicitud lleva solo username y el limit opcional; no hace falta iniciar sesión ni un token de acceso de Instagram.

¿Qué diferencia hay entre followers y followers_list?

followers devuelve solo el total de seguidores. followers_list devuelve la lista de cuentas que siguen al usuario.

Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de Instagram.

Nuestras estadísticas siempre están activas. Google Analytics, solo con «Permitir analítica». Política de privacidad