API de Seguidores de Instagram

Solo los totales: follower_count y following_count de una cuenta de Instagram, más su id, nombre, avatar y enlace al perfil, por $0.56 por cada 1000 llamadas.

Instagram Seguidores consulta el tamaño de la audiencia de una cuenta pública de Instagram a partir de su username y devuelve un solo registro: follower_count, following_count, el id de la cuenta, el nombre de usuario, el nombre, la foto de perfil y el enlace al perfil. Sirve para saber cuánta gente sigue a una cuenta, una pregunta habitual para equipos de marketing que dimensionan a creadores antes de una campaña, marcas que se comparan con su competencia y analistas que siguen la evolución de una audiencia.

Lo recomendable es enviar el nombre de usuario tal cual, por ejemplo nasa, sin @ y sin la URL del perfil. Las cifras corresponden al momento de la llamada y la capacidad no guarda historial: para ver una tendencia, consulta la cuenta de forma periódica y registra cada valor con su fecha. Un contador en null indica que la cifra no se publicó, lo que no equivale a cero. Aquí solo hay totales; las cuentas en sí se obtienen con Instagram Lista de seguidores e Instagram Lista de cuentas seguidas.

  • Sin cargo por fallos ni resultados vacíos
  • No necesitas iniciar sesión en Instagram
  • Solo totales, sin lista de cuentas

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",
      "params": {
        "username": "nasa"
      }
    }
  2. 2Respuesta JSON

    {
      "results": {
        "username": "nasa",
        "name": "NASA",
        "follower_count": 104336071,
        "following_count": 89,
        …
      }
    }
  3. 3Campos

    usernamenamefollower_countfollowing_count
    nasaNASA10433607189
  4. 4CSV

    instagram-followers-sample.csv id,username,url,name,avatar_url,follower_count,following_count,platform

Entra una solicitud con username y sale un objeto JSON con follower_count y following_count, que se muestra como tabla de campos y se puede descargar en CSV.

Qué datos obtienes

La tabla muestra una llamada real para nasa, obtenida el 26 de septiembre de 2026, 08:56 (UTC), que devolvió un objeto; 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_urlfollower_countfollowing_countplatform
nasainstagram.com/NASA10433607189instagram

Casos de uso

  • Revisar muchos creadores

    Lee follower_count de cada cuenta y compáralo con la cifra que declara el creador.

  • Registrar el crecimiento

    Consulta con periodicidad, guarda follower_count con la hora de lectura y resta una lectura de la siguiente.

  • Comparar con la competencia

    Lee follower_count y following_count de tu cuenta y de una competidora, y compáralos.

  • Medir antes de listar

    Lee primero follower_count y decide después si llamas a followers_list.

Instagram Graph API frente a EveryInfra

La Graph API oficial de Instagram y followers de EveryInfra dan los dos el total de seguidores; aquí se comparan en campos de recuento, cuentas accesibles y acceso.

AspectoInstagram Graph APIEveryInfra
Campos de recuentoCampo followers_count: "Total number of Instagram users following the user." Campo follows_count: "Total number of Instagram users the user follows."follower_count y following_count, más id, username, url, name y avatar_url. Devuelve solo totales, no las cuentas.
Qué cuentasBusiness Discovery: "You can use the Instagram API with Facebook Login to get basic metadata and metrics about other Instagram professional accounts." "Data about age-gated Instagram professional accounts will not be returned."La cuenta que indiques en username, como nombre de usuario sin @ o como URL completa del perfil.
Acceso necesarioToken de acceso: "Required. App user’s User access token."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) · Business Discovery (actualizada el 2026-08-12)

Límites y detalles a tener en cuenta

  • username es obligatorio: el nombre de usuario sin @ o la URL completa del perfil.
  • La respuesta trae solo totales; las cuentas las devuelven followers_list y following_list.
  • follower_count y following_count valen null cuando la cuenta no los publica; null no equivale a 0.
  • Los contadores son los del momento de la llamada, sin historial; para ver una tendencia, consulta con periodicidad y guarda los resultados.
  • avatar_url es un enlace a una imagen, y un enlace de CDN con tamaño puede caducar.
  • Cada llamada consulta una cuenta y devuelve un objeto.

Precios

Pagas $0.000556 por llamada, y cada llamada consulta 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",
  "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, 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: Seguidores (instagram/followers).

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, 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.
- Devuelve un objeto. Campos principales: id, username, url, name, avatar_url, follower_count, following_count.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "instagram",
  "action": "followers",
  "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ífollowersIdentificador 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.

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). id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "id": "req_…",  "platform": "instagram",  "action": "followers",  "results": {    "id": "•••",    "username": "nasa",    "url": "https://www.instagram.com/•••",    "name": "NASA",    "avatar_url": "https://scontent-iad3-2.cdninstagram.com/•••",    "follower_count": 104336071,    "following_count": 89,    "platform": "instagram"  },  "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.
follower_countSeguidores. null significa no publicado, no 0.
following_countCuentas seguidas. null significa no publicado, no 0.
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

¿Cómo consulto con código cuántos seguidores tiene una cuenta de Instagram?

Con una llamada a Instagram Seguidores en la que username lleve el nombre de la cuenta, por ejemplo nasa. El registro de respuesta trae el total en follower_count y, al lado, following_count. Si sigues varias cuentas, haz una llamada por cuenta y guarda cada resultado con fecha y hora; así podrás comparar cada lectura con las anteriores.

¿Instagram Seguidores devuelve la lista de seguidores?

No, solo contadores. Si necesitas ver las cuentas de un lado u otro, Instagram Lista de seguidores e Instagram Lista de cuentas seguidas reciben el mismo username y devuelven las cuentas. Cuando lo único que te interesa es el tamaño de la audiencia, los totales de esta capacidad bastan y te permiten conservar solo cifras agregadas.

¿Qué significa que follower_count venga en null?

Que en esa respuesta la cifra no se publicó; no quiere decir que la cuenta tenga cero seguidores. Deja esas filas fuera de medias y rankings en lugar de contarlas como cero, y vuelve a consultar la cuenta más adelante si necesitas el dato. Un following_count en null se interpreta de la misma forma.

¿Cómo obtengo con una API el número de seguidores de Instagram?

Llama a followers con el nombre de la cuenta en username, por ejemplo nasa, y lee follower_count en el objeto de respuesta. following_count está a su lado. Para varias cuentas, haz una llamada por cuenta.

¿Cuántas cuentas consulta cada llamada?

Una. username admite una sola cuenta y la respuesta es un único objeto, así que no hay limit ni paginación.

¿Cuánto cuesta?

Cuesta $0.000556 por llamada, o $0.56 por cada 1000 llamadas. 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; no hace falta iniciar sesión ni un token de acceso de Instagram.

¿Qué diferencia hay entre followers y followers_list?

followers devuelve un objeto con solo los contadores de seguidores y seguidos. followers_list devuelve las cuentas que siguen al usuario, una fila por cuenta. Si solo necesitas la cifra, usa followers.

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