API de Instagram
Consulta perfiles, publicaciones, Reels, hashtags, comentarios y relaciones públicas de Instagram. Distingue URL de contenido, nombre de usuario y etiqueta para evitar mezclar objetos.
Contadores y distintivos son señales visibles, no identidad, ingresos o demografía. Las acciones agregadas de seguidores no equivalen a las listas nominales, que tienen contratos separados.
Disponibilidad de la plataforma
- Salud 24 h
- 75 %
Últimos 30 días
Funciones disponibles
Cada acción de Instagram, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Consultar publicaciones por URLpost | Procesa una o varias URL en urls y devuelve publicaciones de Instagram con autor, texto, tipo de medio y métricas visibles. | $0.56 por 1.000 solicitudes | Normal |
Consultar un perfil de Instagramprofile | Resuelve un username de Instagram y devuelve nombre, biografía, contadores y señales públicas de cuenta. | $0.56 por 1.000 solicitudes | Disponible · salud 70 % |
Revisar la vista pública de una personapersona | Consulta mediante username las mismas señales públicas del perfil para una vista de persona. | $0.56 por 1.000 solicitudes | Normal |
Listar publicaciones de un usuariouser_posts | Obtiene publicaciones públicas del username, con URL, texto, formato y contadores por pieza. | $0.56 por 1.000 solicitudes | Normal |
Descubrir contenido por palabra clavediscover | Descubre publicaciones por keyword y permite elegir results_type. | $0.56 por 1.000 solicitudes | Saludable · salud 100 % |
Leer comentarios de Instagramcomments | Lee comentarios de la url de una publicación, con autor, likes, respuestas y fecha cuando existen. | $0.56 por 1.000 solicitudes | Normal |
Consultar Reels de una cuentareels | Consulta Reels asociados a username y devuelve descripción, título, reproducciones, duración y texto cuando está disponible. | $0.56 por 1.000 solicitudes | Normal |
Buscar contenido por hashtaghashtag | Busca contenido del hashtag, aceptando alias compatibles de etiqueta o palabra, y distingue posts de Reels mediante results_type. | $0.56 por 1.000 solicitudes | Normal |
Revisar métricas agregadas de seguidoresfollowers | Obtiene para username contadores y señales de conexión agregadas. | $0.56 por 1.000 solicitudes | Normal |
Listar seguidoresfollowers_list | Enumera cuentas seguidoras del username con relación y perfil público cuando están disponibles. | $0.56 por 1.000 solicitudes | Normal |
Listar cuentas seguidasfollowing_list | Lista cuentas seguidas por el username, conservando privacidad y verificación visibles. | $0.56 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Instagram?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
postConsultar publicaciones por URL Procesa una o varias URL en | urls | — | Entrega síncrona | El catálogo declara defaultLimit = 11 y maxLimit = 11 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · author_follower_count · hashtags · top_comments |
profileConsultar un perfil de Instagram Resuelve un | username | — | Entrega síncrona | — | $0.56 por 1.000 solicitudes | username · display_name · bio · follower_count · following_count · post_count · is_private · is_verified · is_business · is_professional · category · external_url · avatar_url · recent_posts |
personaRevisar la vista pública de una persona Consulta mediante | username | — | Entrega síncrona | — | $0.56 por 1.000 solicitudes | username · display_name · bio · follower_count · following_count · post_count · is_private · is_verified · is_business · is_professional · category · external_url · avatar_url · recent_posts |
user_postsListar publicaciones de un usuario Obtiene publicaciones públicas del | username | — | Entrega asíncrona | El catálogo declara defaultLimit = 30 y maxLimit = 200 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · author_follower_count · hashtags · top_comments |
discoverDescubrir contenido por palabra clave Descubre publicaciones por | keyword | results_type | Entrega asíncrona | El catálogo declara defaultLimit = 30 y maxLimit = 200 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · author_follower_count · hashtags · top_comments |
commentsLeer comentarios de Instagram Lee comentarios de la | url | — | Entrega síncrona | El catálogo declara defaultLimit = 50 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | id · text · url · like_count · reply_count · author_username · author_name · is_verified · posted_at · post_url · platform |
reelsConsultar Reels de una cuenta Consulta Reels asociados a | username | — | Entrega síncrona | El catálogo declara defaultLimit = 30 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · author_follower_count · hashtags · top_comments · play_count · duration_sec · duration_seconds · transcript · music · platform |
hashtagBuscar contenido por hashtag Busca contenido del | hashtag | results_type, tag | Entrega síncrona | El catálogo declara defaultLimit = 30 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · author_follower_count · hashtags · top_comments · platform |
followersRevisar métricas agregadas de seguidores Obtiene para | username | — | Entrega síncrona | — | $0.56 por 1.000 solicitudes | id · username · url · name · avatar_url · follower_count · following_count · platform |
followers_listListar seguidores Enumera cuentas seguidoras del | username | — | Entrega síncrona | El catálogo declara defaultLimit = 50 y maxLimit = 500 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | id · username · url · name · avatar_url · is_private · is_verified · relation · of_user · platform |
following_listListar cuentas seguidas Lista cuentas seguidas por el | username | — | Entrega síncrona | El catálogo declara defaultLimit = 50 y maxLimit = 500 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | id · username · url · name · avatar_url · is_private · is_verified · relation · of_user · platform |
¿Qué significan los parámetros de Instagram post?
Procesa una o varias URL en urls y devuelve publicaciones de Instagram con autor, texto, tipo de medio y métricas visibles. No descarga contenido privado ni concede derechos sobre fotos o videos.
urlsObligatorio- Array de enlaces completos de publicaciones para
post, por ejemplo/p/<shortcode>/o/reel/<shortcode>/; se factura según la cantidad de enlaces objetivo.commentssolo procesa un únicourl, no apliques directamente la forma de solicitud de múltiples enlaces depost.Instagram: contenido público y posibilidad de inserción — Instagram indica que el contenido de cuentas privadas no puede insertarse y que una cuenta pública puede desactivar la inserción. Que un post sea visible o insertable no concede derechos adicionales ni cambia los parámetros documentados. · Consultada
¿Qué significan los parámetros de Instagram profile?
Resuelve un username de Instagram y devuelve nombre, biografía, contadores y señales públicas de cuenta. is_verified, is_business o is_professional no prueban identidad, ingresos ni actividad comercial actual.
usernameObligatorio- Handle de la cuenta de Instagram, se recomienda sin el
@o la URL completa del perfil.profile/persona/user_posts/reelsconsultan los datos de la cuenta;followerssolo consulta la cantidad de seguidores,followers_list/following_listconsultan la lista de cuentas de seguidores/seguidos.
¿Qué significan los parámetros de Instagram persona?
Consulta mediante username las mismas señales públicas del perfil para una vista de persona. No infiere edad, género, intereses, compradores o rasgos psicológicos que el contrato no devuelve.
usernameObligatorio- Handle de la cuenta de Instagram, se recomienda sin el
@o la URL completa del perfil.profile/persona/user_posts/reelsconsultan los datos de la cuenta;followerssolo consulta la cantidad de seguidores,followers_list/following_listconsultan la lista de cuentas de seguidores/seguidos.
¿Qué significan los parámetros de Instagram user_posts?
Obtiene publicaciones públicas del username, con URL, texto, formato y contadores por pieza. No garantiza todo el historial, Stories privadas ni datos internos de alcance.
usernameObligatorio- Handle de la cuenta de Instagram, se recomienda sin el
@o la URL completa del perfil.profile/persona/user_posts/reelsconsultan los datos de la cuenta;followerssolo consulta la cantidad de seguidores,followers_list/following_listconsultan la lista de cuentas de seguidores/seguidos.
¿Qué significan los parámetros de Instagram discover?
Descubre publicaciones por keyword y permite elegir results_type. La respuesta conserva autor, formato e interacciones observadas; no explica el algoritmo de Explore ni asegura tendencia.
keywordObligatorio- Término de etiqueta de hashtag para
discover, se eliminará el#inicial y luego se consultará elhashtag; no es una búsqueda de palabras clave de texto completo arbitraria. Es diferente del nombre de entrada de la acciónhashtag. results_typeOpcional- Tipo de contenido para
discover/hashtag: si se omite, devuelve publicaciones normales;reeloreelscambian a videos cortos.postsno se puede enviar de forma explícita y cualquier otro valor devuelve 422. No es una selección de formato JSON/CSV.Valores permitidos:reelreels
¿Qué significan los parámetros de Instagram comments?
Lee comentarios de la url de una publicación, con autor, likes, respuestas y fecha cuando existen. No publica, modera ni promete el árbol completo de conversación.
urlObligatorio- Enlace individual de una publicación o Reel de Instagram para
comments; no es el perfil de la cuenta. Aunque enreelshay una rama de compatibilidad para URL, aún debes cumplir con elusernameobligatorio.
¿Qué significan los parámetros de Instagram reels?
Consulta Reels asociados a username y devuelve descripción, título, reproducciones, duración y texto cuando está disponible. No garantiza transcripción para cada video ni métricas privadas.
usernameObligatorio- Handle de la cuenta de Instagram, se recomienda sin el
@o la URL completa del perfil.profile/persona/user_posts/reelsconsultan los datos de la cuenta;followerssolo consulta la cantidad de seguidores,followers_list/following_listconsultan la lista de cuentas de seguidores/seguidos.
¿Qué significan los parámetros de Instagram hashtag?
Busca contenido del hashtag, aceptando alias compatibles de etiqueta o palabra, y distingue posts de Reels mediante results_type. No mide por sí solo el volumen total de la tendencia.
hashtagObligatorio- Etiqueta de hashtag de Instagram, sin el
#, por ejemplocoffee; se usa para listar losposts/reelsbajo esa etiqueta, no es el handle de la cuenta. results_typeOpcional- Tipo de contenido para
discover/hashtag: si se omite, devuelve publicaciones normales;reeloreelscambian a videos cortos.postsno se puede enviar de forma explícita y cualquier otro valor devuelve 422. No es una selección de formato JSON/CSV.Valores permitidos:reelreels tagOpcional- Entrada de compatibilidad para
hashtag, sin el#inicial; si también existehashtag,hashtagtiene prioridad, y las solicitudes públicas aún deben proporcionar elhashtagobligatorio.
¿Qué significan los parámetros de Instagram followers?
Obtiene para username contadores y señales de conexión agregadas. No devuelve en esta acción la identidad de cada seguidor ni un historial de crecimiento.
usernameObligatorio- Handle de la cuenta de Instagram, se recomienda sin el
@o la URL completa del perfil.profile/persona/user_posts/reelsconsultan los datos de la cuenta;followerssolo consulta la cantidad de seguidores,followers_list/following_listconsultan la lista de cuentas de seguidores/seguidos.
¿Qué significan los parámetros de Instagram followers_list?
Enumera cuentas seguidoras del username con relación y perfil público cuando están disponibles. La lista devuelta puede ser parcial y no habilita contacto automatizado.
usernameObligatorio- Handle de la cuenta de Instagram, se recomienda sin el
@o la URL completa del perfil.profile/persona/user_posts/reelsconsultan los datos de la cuenta;followerssolo consulta la cantidad de seguidores,followers_list/following_listconsultan la lista de cuentas de seguidores/seguidos.
¿Qué significan los parámetros de Instagram following_list?
Lista cuentas seguidas por el username, conservando privacidad y verificación visibles. No prueba afinidad, interacción ni que la relación permanezca sin cambios.
usernameObligatorio- Handle de la cuenta de Instagram, se recomienda sin el
@o la URL completa del perfil.profile/persona/user_posts/reelsconsultan los datos de la cuenta;followerssolo consulta la cantidad de seguidores,followers_list/following_listconsultan la lista de cuentas de seguidores/seguidos.
Cómo usar la API de Instagram
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"instagram","action":"post","params":{"urls":"<urls>"}}'
Guías de Instagram
Ejemplos completos y métodos basados en estas acciones. Comprueba primero en esta página las acciones, parámetros y campos actuales; los ejemplos y límites de un artículo no sustituyen al catálogo en vivo.
Realiza una due diligence de datos de creadores sin sustituir la audiencia por seguidores
Los productos de datos de creadores no deben generar puntuaciones opacas de autenticidad. Explora cómo combinar métricas públicas, análisis autorizado, adecuación de marca, requisitos de divulgación, pruebas a pequeña escala y retroalimentación posterior para formar una due diligence verificable.
Leer el artículo →Plan de seguimiento de reputación en múltiples plataformas: registra el alcance de la recolección antes de evaluar cambios negativos.
Diseña un proceso de seguimiento de reputación trazable a partir de listas de objetivos, identidades de comentarios y cursores incrementales; usa muestras locales para demostrar la deduplicación y las brechas de recolección, conserva la revisión manual y evita presentar casos de éxito de clientes.
Leer el artículo →Inicio con la API de datos unificada: del directorio de capacidades al primer resultado disponible
Integra datos multiplataforma usando platform, action y params: comprende el directorio de capacidades, completa una solicitud mínima, gestiona tareas asíncronas, resultados parciales y facturación, y establece registros de datos trazables.
Leer el artículo →Preguntas sobre la API de Instagram
¿Cómo llamo a la API de Instagram?
Envía POST /api/v1/social con platform igual a instagram, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Instagram?
Devuelve JSON estructurado. Por ejemplo, el esquema de post incluye post_id, text, media_type y like_count. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Instagram?
Instagram indica que el contenido de cuentas privadas no puede insertarse y que una cuenta pública puede desactivar la inserción. Que un post sea visible o insertable no concede derechos adicionales ni cambia los parámetros documentados.
¿Qué parámetros son obligatorios?
Depende de la acción. post requiere urls; profile requiere username; persona requiere username; consulta las demás acciones en la lista de funciones.
¿Las acciones de Instagram responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.