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
Últimas 24 horas
Últimos 30 días
1Solicitud
POST /api/v1/social { "platform": "instagram", "action": "followers", "params": { "username": "nasa" } }2Respuesta JSON
{ "results": { "username": "nasa", "name": "NASA", "follower_count": 104336071, "following_count": 89, … } }3Campos
username name follower_count following_count nasa NASA 104336071 89 4CSV
instagram-followers-sample.csv id,username,url,name,avatar_url,follower_count,following_count,platform
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.
| id | username | url | name | avatar_url | follower_count | following_count | platform |
|---|---|---|---|---|---|---|---|
| nasa | instagram.com/ | NASA | 104336071 | 89 |
Casos de uso
Revisar muchos creadores
Lee
follower_countde cada cuenta y compáralo con la cifra que declara el creador.Registrar el crecimiento
Consulta con periodicidad, guarda
follower_countcon la hora de lectura y resta una lectura de la siguiente.Comparar con la competencia
Lee
follower_countyfollowing_countde tu cuenta y de una competidora, y compáralos.Medir antes de listar
Lee primero
follower_county decide después si llamas afollowers_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.
| Aspecto | Instagram Graph API | EveryInfra |
|---|---|---|
| Campos de recuento | Campo 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é cuentas | Business 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 necesario | Token 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
usernamees obligatorio: el nombre de usuario sin @ o la URL completa del perfil.- La respuesta trae solo totales; las cuentas las devuelven
followers_listyfollowing_list. follower_countyfollowing_countvalennullcuando la cuenta no los publica;nullno 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_urles 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.
| Llamadas | Costo |
|---|---|
| 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
#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.
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
#| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | 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. |
platform | body | string | Sí | instagram | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | followers | Identificador de la capacidad, valor fijo. |
username | body.params | string | Sí | - | 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
#{ "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.
| Campo | Significado |
|---|---|
id | Identificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas. |
username | Nombre de usuario (@usuario). |
url | Enlace al registro en la plataforma. |
name | Nombre del propio objeto, en capacidades de cuentas, productos y negocios. |
avatar_url | Enlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar. |
follower_count | Seguidores. null significa no publicado, no 0. |
following_count | Cuentas seguidas. null significa no publicado, no 0. |
platform | Identificador 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.
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.
Capacidades de Instagram relacionadas
Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de Instagram.
- Detalles de la publicación
post$0.56 por cada 1000 llamadasProcesa una o varias URL enurlsy devuelve publicaciones de Instagram con autor, texto, tipo de medio y métricas visibles. - Detalles
profile$0.56 por cada 1000 llamadasResuelve unusernamede Instagram y devuelve nombre, biografía, contadores y señales públicas de cuenta. - Análisis de la cuenta
persona$0.56 por cada 1000 llamadasConsulta medianteusernamelos mismos campos públicos queprofiley añade un objetopersonaescrito por IA con sector, nicho, autenticidad y resumen. - Publicaciones del usuario
user_posts$0.56 por cada 1000 llamadasObtiene publicaciones públicas delusername, con URL, texto, formato y contadores por pieza. - Descubrimiento de contenido
discover$0.56 por cada 1000 llamadasDescubre publicaciones porkeywordy permite elegirresults_type. - Comentarios
comments$0.79 por cada 1000 llamadasLee comentarios de laurlde una publicación, con autor, likes, respuestas y fecha cuando existen. - Reels
reels$1.19 por cada 1000 llamadasConsulta Reels asociados ausernamey devuelve descripción, título, reproducciones, duración y texto cuando está disponible. - Contenido por hashtag
hashtag$0.56 por cada 1000 llamadasBusca contenido delhashtag, aceptando alias compatibles de etiqueta o palabra, y distingue posts de Reels medianteresults_type. - Lista de seguidores
followers_list$0.56 por cada 1000 llamadasEnumera cuentas seguidoras delusernamecon relación y perfil público cuando están disponibles. - Lista de cuentas seguidas
following_list$0.56 por cada 1000 llamadasLista cuentas seguidas por elusername, conservando privacidad y verificación visibles. - Búsqueda de cuentas
user_search$4.81 por cada 1000 llamadasBusca cuentas de Instagram porkeyword, en el orden en que la búsqueda de Instagram las clasifica para esa palabra (rankdesde 1). - Búsqueda de Reels
reels_search$7.19 por cada 1000 llamadasBusca Reels de Instagram porkeyword, por ejemplo coffee. - Cuentas similares
similar_profiles$8.81 por cada 1000 llamadasLista las cuentas que Instagram sugiere como similares a unusername, por ejemplo nasa, ordenadas por seguidores (rankdesde 1). - Publicaciones etiquetadas
tagged_posts$7.44 por cada 1000 llamadasLista publicaciones públicas de otras cuentas que etiquetan a unusername(también vale la URL del perfil o el ID numérico). - Historias
stories$1.5 por cada 1000 llamadasDevuelve las historias que una cuenta de Instagram tiene activas ahora, a partir de su usuario. - Historias destacadas
highlights$1.6 por cada 1000 llamadasLista las historias destacadas de un perfil de Instagram. - Respuestas a comentarios
comment_replies$0.88 por cada 1000 llamadasLee las respuestas a un comentario de una publicación o Reel de Instagram, con el enlace de la publicación y eliddel comentario que devuelvecomments.