API de Análisis de la cuenta de Instagram
Obtén los campos del perfil y un objeto persona escrito por IA con industry, niche, authenticity y summary de una cuenta de Instagram, por $0.56 por cada 1000 llamadas.
- Sin cargo por fallos ni resultados vacíos
- No necesitas iniciar sesión en Instagram
- Campos del perfil 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
1Solicitud
POST /api/v1/social { "platform": "instagram", "action": "persona", "params": { "username": "nasa" } }2Respuesta JSON
{ "results": { "username": "nasa", "display_name": "NASA", "bio": "Making the seemingly impossible, possible. ✨", "follower_count": 104336090, … } }3Campos
username display_name bio follower_count nasa NASA Making the seemingly impossible, possible. ✨ 104336090 4CSV
instagram-persona-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
username y sale un objeto JSON con los campos del perfil y un objeto persona (industry, niche, authenticity, summary), que se muestran como tabla de campos y se pueden 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, incluido el objeto persona escrito por IA.
| 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 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| nasa | NASA | Making the seemingly impossible, possible. ✨ | 104336090 | 89 | 4934 | false | true | false | false | null | https://www.nasa.gov | null | null | null | null | null | [{"post_id":"DdHyaYAifb6","url":"https://www.instagram.com/p/DdHyaYAifb6","text":"Cementing their names in history.\n\nThe Artemis III crew is leaving their mark — literally. The astronauts recently signed their names on the hardware that will be inside their Orion spacecraft during their low Earth orbit mission, launching in 2027.\n\nImage descriptions:\n\n1. The A…","media_type":"image","like_count":0,"comment_count":0,"view_count":0,"author_username":"nasa","posted_at":"2026-09-10T00:00:00+00:00"},{"post_id":"DdWyDLcGiqo","url":"https://www.instagram.com/p/DdWyDLcGiqo","text":"Southern Hemisphere Milky Way galaxy view from the @••• cupola. This 3s exposure series captured two of my favorite cupola views, the particularly dense Milky Way galaxy as seen from the Southern Hemisphere, and the bright, colorful lights of squid fishing boats (here, the brig…","media_type":"image","like_count":0,"comment_count":0,"view_count":0,"author_username":"•••","posted_at":"2026-09-16T00:00:00+00:00"},{"post_id":"DdT_4GMka0z","url":"https://www.instagram.com/p/DdT_4GMka0z","text":"In a class of their own\n\nHidden within this star-forming nebula (captured by our Webb telescope in one of its largest images to date) are strange objects called brown dwarfs. Generally less massive than stars and more massive than planets, they are neither. They form the same way…","media_type":"image","like_count":0,"comment_count":0,"view_count":0,"author_username":"•••","posted_at":"2026-09-15T00:00:00+00:00"}] |
Casos de uso
Filtrar creadores
Pasa una lista de nombres de usuario candidatos y agrúpalos por
industryynicheantes de abrir ningún perfil.Guardar la nota de autenticidad
Guarda la valoración de
authenticitycon su motivo, junto con los contadores de seguidores y publicaciones, para revisarla después.Listas por nicho
Combina
industry,nicheycategorypara aislar las cuentas de un nicho.Notas de filtrado
Pega
summaryen una columna de notas para que quien revise vea a qué se dedica la cuenta sin abrirla.
Instagram Graph API frente a EveryInfra
Tres puntos para comparar la Graph API oficial de Instagram con persona de EveryInfra: datos de la cuenta, demografía de seguidores y cuentas accesibles.
| Aspecto | Instagram Graph API | EveryInfra |
|---|---|---|
| Datos de la cuenta | Insights: "Represents social interaction metrics on your app user’s Instagram business or creator account." | Un objeto persona con industry, niche, authenticity y summary, más los mismos campos de perfil que profile. |
| Demografía de seguidores | "The demographic characteristics of followers, including countries, cities and gender distribution." "Not returned if the IG User has less than 100 followers." | La respuesta no incluye edad, género, intereses, compradores ni otros rasgos, y tampoco los infiere. |
| Qué cuentas | "Note that a permission only allows access to data created by the app user who granted the permission." | La cuenta que indiques en username, como nombre de usuario sin @ o como URL completa del perfil. 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: Instagram Account Insights (actualizada el 2026-06-16) · Instagram Platform overview (actualizada el 2026-10-29)
Límites y detalles a tener en cuenta
usernamees obligatorio: el nombre de usuario sin @ o la URL completa del perfil.personalo escribe una IA a partir del perfil público de la cuenta. No incluye edad, género, intereses, compradores ni otros rasgos.authenticitysuele traer un motivo breve; es una valoración de la IA, no una insignia de la plataforma.follower_count,following_countypost_countvalennullcuando la cuenta no los publica;nullno equivale a 0.categoryusa la taxonomía propia de Instagram, sin normalizar entre plataformas; es una etiqueta distinta deindustry.is_verifiedvalenullcuando no se puede determinar la verificación.
Precios
Pagas $0.000556 por llamada, no por campo, y cada llamada consulta una cuenta, con los campos del perfil y el objeto persona en la misma respuesta. 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
#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": "persona",
"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 persona, 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: Análisis de la cuenta (instagram/persona).
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 persona, 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: username, display_name, bio, follower_count, following_count, post_count, is_private, is_verified, is_business, is_professional, category, external_url; 19 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Las respuestas incluyen además un objeto persona en el nivel superior (industry, niche, authenticity, summary): un perfil de la cuenta escrito por IA, en inglés, que vale null si no se puede generar.
- Cuerpo de solicitud de ejemplo:
{
"platform": "instagram",
"action": "persona",
"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í | persona | 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
#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": "persona", "results": { "username": "nasa", "display_name": "NASA", "bio": "Making the seemingly impossible, possible. ✨", "follower_count": 104336090, "following_count": 89, "post_count": 4934, "is_private": false, "is_verified": true, "is_business": false, "is_professional": false, "external_url": "https://www.nasa.gov", "avatar_url": "https://scontent.cdninstagram.com/•••", "recent_posts": [ { "post_id": "DdHyaYAifb6", "url": "https://www.instagram.com/p/DdHyaYAifb6", "text": "Cementing their names in history.\n\nThe Artemis III crew is leaving their mark — literally. The astronauts recently signed their names on the hardware that will be inside their Orion spacecraft during their low Earth orbit mission, launching in 2027.\n\nImage descriptions:\n\n1. The A…", "media_type": "image", "like_count": 0, "comment_count": 0, "view_count": 0, "author_username": "nasa", "posted_at": "2026-09-10T00:00:00+00:00" }, { "post_id": "DdWyDLcGiqo", "url": "https://www.instagram.com/p/DdWyDLcGiqo", "text": "Southern Hemisphere Milky Way galaxy view from the @••• cupola. This 3s exposure series captured two of my favorite cupola views, the particularly dense Milky Way galaxy as seen from the Southern Hemisphere, and the bright, colorful lights of squid fishing boats (here, the brig…", "media_type": "image", "like_count": 0, "comment_count": 0, "view_count": 0, "author_username": "•••", "posted_at": "2026-09-16T00:00:00+00:00" }, { "post_id": "DdT_4GMka0z", "url": "https://www.instagram.com/p/DdT_4GMka0z", "text": "In a class of their own\n\nHidden within this star-forming nebula (captured by our Webb telescope in one of its largest images to date) are strange objects called brown dwarfs. Generally less massive than stars and more massive than planets, they are neither. They form the same way…", "media_type": "image", "like_count": 0, "comment_count": 0, "view_count": 0, "author_username": "•••", "posted_at": "2026-09-15T00:00:00+00:00" } ] }, "persona": { "industry": …, "niche": …, "authenticity": …, "summary": … }, "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 |
|---|---|
username | Nombre de usuario (@usuario). |
display_name | Nombre visible; puede ser distinto de username. |
bio | Biografía escrita por la cuenta; puede incluir saltos de línea y emoji. |
follower_count | Seguidores. null significa no publicado, no 0. |
following_count | Cuentas seguidas. null significa no publicado, no 0. |
post_count | Total de publicaciones. null significa no publicado, no 0. |
is_private | Conserva el significado de la plataforma |
is_verified | Si la plataforma verificó la cuenta. null significa que no se puede determinar. |
is_business | Conserva el significado de la plataforma |
is_professional | Conserva el significado de la plataforma |
category | Nombre de la categoría según la taxonomía propia de la plataforma, sin normalizar entre plataformas. |
external_url | Conserva el significado de la plataforma |
avatar_url | Enlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar. |
user_id | Identificador único del usuario en la plataforma. |
avatar_hd_url | Conserva el significado de la plataforma |
external_urls | Conserva el significado de la plataforma |
has_reels | Conserva el significado de la plataforma |
highlight_count | Conserva el significado de la plataforma |
recent_posts | Conserva el significado de la plataforma |
La respuesta incluye además un objeto persona en el nivel superior, junto a results, tanto en llamadas síncronas como en tareas asíncronas (mode: async): un perfil de la cuenta escrito por IA a partir de sus datos de perfil y de hasta 6 de sus publicaciones más recientes, en inglés. Vale null si no se puede generar, y results se devuelve igual.
| Campo | Significado |
|---|---|
persona.industry | Sector al que pertenece la cuenta. |
persona.niche | Nicho dentro de ese sector. |
persona.authenticity | Valoración de autenticidad, normalmente con un breve motivo. |
persona.summary | Perfil breve de la cuenta en unas pocas frases. |
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
¿Qué devuelve la API de Instagram de análisis de cuentas?
Devuelve un objeto: los campos del perfil (username, bio, follower_count y otros) más un objeto persona con industry, niche, authenticity y summary.
¿Devuelve la edad y el género de la audiencia?
No. La respuesta no incluye edad, género, intereses, compradores ni otros rasgos, y tampoco los infiere. persona describe la propia cuenta: su sector, su nicho, su autenticidad y un resumen breve.
¿Cuánto cuesta?
Cuesta $0.000556 por llamada, o $0.56 por cada 1000 llamadas, y se factura por llamada, no por campo. 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 profile y persona?
Los campos del perfil son los mismos. persona añade un objeto persona escrito por IA con industry, niche, authenticity y summary. Si solo necesitas valores en bruto, como seguidores y biografía, usa profile.
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. - 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. - Seguidores
followers$0.56 por cada 1000 llamadasObtiene parausernamecontadores y señales de conexión agregadas. - 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.