API de Perfiles en lote de Instagram

Consulta varias cuentas de Instagram a la vez con usernames: cada fila trae username, bio, follower_count e input, por $0.56 por cada 1000 llamadas.

  • Cada cuenta de usernames cuenta como una llamada
  • input une cada fila con el elemento que enviaste
  • Las cuentas no encontradas salen en missed

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": "profiles_batch",
      "params": {
        "usernames": [
          "natgeo",
          "nasa"
        ]
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "username": string,
          "display_name": string,
          "bio": string,
          "follower_count": number
        },
        …
      ]
    }
  3. 3Filas

    usernamedisplay_namebiofollower_count
    stringstringstringnumber
  4. 4CSV

    instagram-profiles_batch-sample.csv username,display_name,bio,follower_count,following_count,post_count,is_private,is_verified,is_business,is_professional,category,external_url,avatar_url,user_id,avatar_hd_url,external_urls,has_reels,highlight_count,recent_posts,url,reels_count,business_email,business_phone,threads_username,fbid,is_memorialized,is_joined_recently,account_type,emails,phones,pronouns,bio_links_detail,messaging_ids,business_address,platform,input

La solicitud lleva un array usernames y devuelve una fila de perfil por cuenta; input une cada fila con el elemento que enviaste. Las cuentas no encontradas salen en missed en la respuesta. Las filas llegan como tabla de campos o CSV.

Qué datos obtienes

Cada fila es una cuenta. La tabla enumera los campos que devuelve cada fila, con su tipo y su significado, y no muestra ningún valor.

CampoTipoSignificado
usernamestringNombre de usuario (@usuario).
display_namestringNombre visible; puede ser distinto de username.
biostringBiografía escrita por la cuenta; puede incluir saltos de línea y emoji.
follower_countnumberSeguidores. null significa no publicado, no 0.
following_countnumberCuentas seguidas. null significa no publicado, no 0.
post_countnumberTotal de publicaciones. null significa no publicado, no 0.
is_privatebooleanSi la cuenta es privada.
is_verifiedbooleanSi la plataforma verificó la cuenta. null significa que no se puede determinar.
is_businessbooleanSi la cuenta es una cuenta comercial.
is_professionalbooleanSi la cuenta es profesional (comercial o de creador).
categorystringNombre de la categoría según la taxonomía propia de la plataforma, sin normalizar entre plataformas.
external_urlstringEnlace externo del perfil.
avatar_urlstringEnlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar.
user_idstringIdentificador único del usuario en la plataforma.
avatar_hd_urlstringURL del avatar en alta resolución (avatar_url es la imagen pequeña).
external_urlsarrayTodos los enlaces externos de la biografía: url, title (external_url es solo el primero).
has_reelsbooleanSi la cuenta ha publicado Reels.
highlight_countnumberCantidad de destacados (Highlights).
recent_postsarrayÚltimas publicaciones del perfil (incluidas las fijadas), en un arreglo; cada elemento es una publicación con los mismos campos que una fila de user_posts (un campo aparece solo si tiene valor). No aparece si la cuenta es privada o no tiene publicaciones.
urlstringEnlace al registro en la plataforma.
reels_countnumberCantidad de Reels que ha publicado la cuenta (entero).
business_email—Correo electrónico que la cuenta comercial hace público en el botón "Contact" de su perfil. No aparece si no hay.
business_phone—Teléfono que la cuenta comercial hace público en el botón "Contact" de su perfil. No aparece si no hay.
threads_usernamestringNombre que muestra la insignia de Threads en el perfil; normalmente es el nombre de usuario de la persona en Threads.
fbidstringOtro identificador numérico que Meta asigna a la cuenta; no es el mismo número que user_id.
is_memorialized—La cuenta es conmemorativa (el estado que Instagram asigna a una cuenta cuando su titular ha fallecido). Solo aparece en cuentas conmemorativas, con el valor true.
is_joined_recently—El perfil tiene la marca "Joined recently". Solo aparece cuando existe esa marca, con el valor true.
account_typestringTipo de cuenta: personal (individual), business (comercial) o creator (creador).
emails—Correos de contacto (un registro puede tener varios), tal como los da la plataforma y sin duplicados.
phones—Números de teléfono que la persona escribió públicamente en la biografía, en un arreglo. Solo se incluyen los que empiezan con + o 00, o que van después de una etiqueta como WhatsApp o Teléfono. No aparece si no hay.
pronouns—Pronombres indicados en el perfil, en un arreglo.
bio_links_detailarrayCada enlace de la sección de biografía, una entrada por enlace: url (la dirección real, sin la capa de redirección con que Instagram envuelve el enlace), title (título del enlace, solo algunos lo tienen), type (tipo de enlace que da Instagram, como external). external_urls contiene el url y el title de esos mismos enlaces.
messaging_ids—Cuentas de mensajería escritas públicamente en la biografía, una entrada por cuenta con la forma {app, id}; app es un valor como wechat, line, telegram, kakao, skype o signal.
business_address—Dirección que la cuenta comercial hace pública, como objeto: street, city, zip, lat, lng; cada uno aparece solo si está disponible.
platformstringIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
input—(profiles_batch) Entrada de usernames a la que responde esta fila, devuelta tal como la enviaste. Úsala para emparejar cada fila con tu entrada; username puede venir escrito distinto, por ejemplo si enviaste un enlace de perfil.

Casos de uso

  • Consulta una lista en una sola solicitud

    Pon las cuentas de una lista en usernames y recibe su follower_count y su post_count en una sola solicitud.

  • Une las filas con tu lista mediante `input`

    input es el elemento que enviaste, devuelto tal como lo escribiste. Une las filas con tu lista aunque mezcles nombres de usuario y enlaces de perfil.

  • Encuentra las cuentas no encontradas

    Lee missed en la respuesta para ver qué cuentas no se encontraron. No se cobran.

  • Clasifica cuentas privadas y de empresa

    Agrupa por is_private, is_business y category para clasificar las cuentas de tu lista.

Instagram Graph API frente a EveryInfra

Comparación entre la Graph API oficial de Instagram y profiles_batch de EveryInfra: qué cuentas puedes leer y acceso.

AspectoInstagram Graph APIEveryInfra
Qué cuentas"Get fields and edges on an Instagram Business or Creator Account."Cada cuenta de usernames, como nombre de usuario o enlace de perfil. Cada fila incluye las señales is_private, is_business e is_professional.
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 (página IG User), comprobadas el 2026-11-22. Fuentes oficiales: IG User (actualizada el 2026-04-22)

Límites y detalles a tener en cuenta

  • usernames es un array, no una cadena separada por comas. El número máximo de elementos está en la referencia de parámetros.
  • Cada elemento es un nombre de usuario o un enlace de perfil. Una cuenta solo puede aparecer una vez, y las mayúsculas distintas cuentan como la misma cuenta.
  • Se cobra por cuenta. Las cuentas no encontradas no se cobran y salen en missed en la respuesta.
  • El input de cada fila es el elemento que enviaste. El username devuelto puede diferir de lo que escribiste, por ejemplo si enviaste un enlace de perfil.
  • En una cuenta privada, is_private es verdadero y no aparece recent_posts.
  • Solo se admiten llamadas síncronas.

Precios

Se cobra por cuenta: cada cuenta de usernames cuenta como una llamada de $0.000556. Las cuentas no encontradas no se cobran y salen en missed. 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 usan 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": "profiles_batch",
  "params": {
    "usernames": [
      "natgeo",
      "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 profiles_batch, y copia la página o ábrela como Markdown para 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: Perfiles en lote (instagram/profiles_batch).

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 profiles_batch, y los parámetros dentro de params.
- Parámetros obligatorios:
  - usernames: Cuentas de Instagram para profiles_batch, en una lista de hasta 20 entradas; no se admite texto separado por comas. Cada entrada es un nombre de usuario, como natgeo (se quita la @ inicial), o un enlace de perfil.
- Parámetros opcionales:
  - limit: Número máximo de filas que devuelve esta llamada, un entero de 1 o más. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas.
- Devuelve una lista de registros. Campos principales de cada registro: username, display_name, bio, follower_count, following_count, post_count, is_private (Si la cuenta es privada), is_verified, is_business (Si la cuenta es una cuenta comercial), is_professional (Si la cuenta es profesional (comercial…), category, external_url (Enlace externo del perfil); 35 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "instagram",
  "action": "profiles_batch",
  "params": {
    "usernames": [
      "natgeo",
      "nasa"
    ]
  }
}
- Precio: $0.56 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Este endpoint solo funciona en modo síncrono; no añadas "mode": "async" al cuerpo.
- 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íprofiles_batchIdentificador de la capacidad, valor fijo.
usernamesbody.paramsarraySí-Cuentas de Instagram para profiles_batch, en una lista de hasta 20 entradas; no se admite texto separado por comas. Cada entrada es un nombre de usuario, como natgeo (se quita la @ inicial), o un enlace de perfil. Cada cuenta solo puede aparecer una vez, aunque cambien las mayúsculas. Si hay una entrada no reconocida, una repetida o más de 20, la petición se rechaza con un 422 antes de cobrar. Se cobra por cuenta; las no encontradas no se cobran y se listan en missed.
limitbody.paramsinteger (1–)No-Número máximo de filas que devuelve esta llamada, un entero de 1 o más. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas.

Ejemplo de respuesta

#
Todavía no hay una muestra real para estos parámetros de ejemplo: se muestra la estructura de la respuesta y sus campos según la definición de la API, con … como marcadores. No es el resultado de una llamada real.
json
{  "id": "req_…",  "platform": "instagram",  "action": "profiles_batch",  "results": [    {      "username": …,      "display_name": …,      "bio": …,      "follower_count": …,      "following_count": …,      "post_count": …,      "is_private": …,      "is_verified": …,      "is_business": …,      "is_professional": …,      "category": …,      "external_url": …,      "avatar_url": …,      "user_id": …,      "avatar_hd_url": …,      "external_urls": …,      "has_reels": …,      "highlight_count": …,      "recent_posts": …,      "url": …,      "reels_count": …,      "business_email": …,      "business_phone": …,      "threads_username": …,      "fbid": …,      "is_memorialized": …,      "is_joined_recently": …,      "account_type": …,      "emails": …,      "phones": …,      "pronouns": …,      "bio_links_detail": …,      "messaging_ids": …,      "business_address": …,      "platform": …,      "input": …    }  ],  "count": …,  "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
usernameNombre de usuario (@usuario).
display_nameNombre visible; puede ser distinto de username.
bioBiografía escrita por la cuenta; puede incluir saltos de línea y emoji.
follower_countSeguidores. null significa no publicado, no 0.
following_countCuentas seguidas. null significa no publicado, no 0.
post_countTotal de publicaciones. null significa no publicado, no 0.
is_privateSi la cuenta es privada.
is_verifiedSi la plataforma verificó la cuenta. null significa que no se puede determinar.
is_businessSi la cuenta es una cuenta comercial.
is_professionalSi la cuenta es profesional (comercial o de creador).
categoryNombre de la categoría según la taxonomía propia de la plataforma, sin normalizar entre plataformas.
external_urlEnlace externo del perfil.
avatar_urlEnlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar.
user_idIdentificador único del usuario en la plataforma.
avatar_hd_urlURL del avatar en alta resolución (avatar_url es la imagen pequeña).
external_urlsTodos los enlaces externos de la biografía: url, title (external_url es solo el primero).
has_reelsSi la cuenta ha publicado Reels.
highlight_countCantidad de destacados (Highlights).
recent_postsÚltimas publicaciones del perfil (incluidas las fijadas), en un arreglo; cada elemento es una publicación con los mismos campos que una fila de user_posts (un campo aparece solo si tiene valor). No aparece si la cuenta es privada o no tiene publicaciones.
urlEnlace al registro en la plataforma.
reels_countCantidad de Reels que ha publicado la cuenta (entero).
business_emailCorreo electrónico que la cuenta comercial hace público en el botón "Contact" de su perfil. No aparece si no hay.
business_phoneTeléfono que la cuenta comercial hace público en el botón "Contact" de su perfil. No aparece si no hay.
threads_usernameNombre que muestra la insignia de Threads en el perfil; normalmente es el nombre de usuario de la persona en Threads.
fbidOtro identificador numérico que Meta asigna a la cuenta; no es el mismo número que user_id.
is_memorializedLa cuenta es conmemorativa (el estado que Instagram asigna a una cuenta cuando su titular ha fallecido). Solo aparece en cuentas conmemorativas, con el valor true.
is_joined_recentlyEl perfil tiene la marca "Joined recently". Solo aparece cuando existe esa marca, con el valor true.
account_typeTipo de cuenta: personal (individual), business (comercial) o creator (creador).
emailsCorreos de contacto (un registro puede tener varios), tal como los da la plataforma y sin duplicados.
phonesNúmeros de teléfono que la persona escribió públicamente en la biografía, en un arreglo. Solo se incluyen los que empiezan con + o 00, o que van después de una etiqueta como WhatsApp o Teléfono. No aparece si no hay.
pronounsPronombres indicados en el perfil, en un arreglo.
bio_links_detailCada enlace de la sección de biografía, una entrada por enlace: url (la dirección real, sin la capa de redirección con que Instagram envuelve el enlace), title (título del enlace, solo algunos lo tienen), type (tipo de enlace que da Instagram, como external). external_urls contiene el url y el title de esos mismos enlaces.
messaging_idsCuentas de mensajería escritas públicamente en la biografía, una entrada por cuenta con la forma {app, id}; app es un valor como wechat, line, telegram, kakao, skype o signal.
business_addressDirección que la cuenta comercial hace pública, como objeto: street, city, zip, lat, lng; cada uno aparece solo si está disponible.
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
input(profiles_batch) Entrada de usernames a la que responde esta fila, devuelta tal como la enviaste. Úsala para emparejar cada fila con tu entrada; username puede venir escrito distinto, por ejemplo si enviaste un enlace de perfil.

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 el endpoint de perfiles por lotes de Instagram?

Una fila por cuenta: username, display_name, bio, follower_count, following_count, post_count, is_private, is_verified, category, external_url, input y más.

¿Cómo se cobra una consulta por lotes?

Cada cuenta de usernames cuenta como una llamada: $0.000556 cada una, o $0.56 por cada 1000 llamadas. Las cuentas no encontradas no se cobran. Las llamadas fallidas y los resultados vacíos no se cobran.

¿Cómo sé qué cuentas no se encontraron?

Lee missed en la respuesta. Las cuentas no encontradas salen ahí.

¿Tengo que iniciar sesión en Instagram para consultar cuentas por lotes?

No. Pon tu clave de API de EveryInfra en la cabecera Authorization: Bearer; no necesitas iniciar sesión en Instagram ni un token de acceso.

¿En qué se diferencian profiles_batch y profile?

profile lee una cuenta a partir de username. profiles_batch lee las cuentas de usernames, y input en cada fila la une con el elemento que enviaste.

La misma clave de API de EveryInfra sirve para las demás capacidades de Instagram, por ejemplo profile, que lee una sola cuenta.

Google Analytics solo si aceptas. Privacidad