Necesitas obtener detalles confiables del perfil de Instagram rápidamente: nombre de usuario, verificación, conteo de seguidores, estado de privacidad, para que puedas enriquecer los registros de usuarios, potenciar un flujo de registro o validar creadores. Al final de esta guía, podrás obtener datos del perfil en una sola solicitud y saber cómo obtener detalles de publicaciones, reels y destacados cuando los necesites, todo a través de la misma clave API en Zyla API Hub.
Lo que esta API te ofrece
La API de Datos de Perfil y Medios de Instagram devuelve metadatos del perfil (id, nombre de usuario, URL del avatar, conteos de seguidores y seguidos, banderas de verificación y privacidad, total de publicaciones) y te permite obtener detalles de medios para publicaciones, reels y historias destacadas. Los equipos la utilizan para:
- Validar creadores y socios durante la incorporación.
- Enriquecer registros de CRM con conteos de seguidores y estado de verificación.
- Resolver una URL de publicación o reel a estadísticas e información del autor para el seguimiento de campañas.
- Construir selectores de contenido y tuberías de descarga para historias destacadas.
Todo se gestiona a través de Zyla API Hub con una sola suscripción y clave. También puedes llamar a estos endpoints desde agentes de codificación de IA utilizando el endpoint MCP.
Comenzando en Zyla API Hub
Abre la página de la API, suscríbete y obtén tu clave. La primera API en una nueva cuenta generalmente ofrece una prueba de 7 días o 50 solicitudes; consulta la página de la API para las opciones de acceso y precios actuales. La autenticación es a través del encabezado HTTP Authorization: Bearer YOUR_API_KEY. La facturación es por suscripción + cuota, no por llamada.
Comienza la prueba de 7 días en la API de Datos de Perfil y Medios de Instagram
Endpoint: Obtener Detalles del Perfil
Utiliza esto cuando necesites la identidad básica y estadísticas públicas de un usuario de Instagram. Devuelve id, nombre de usuario, URL del avatar, biografía, categoría, conteos de seguidores/seguidos, banderas de privacidad y verificación, total de publicaciones y más donde esté disponible.
- Método: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details
- Parámetro requerido: username (string)
- Auth: Authorization: Bearer YOUR_API_KEY
cURL que puedes pegar
curl -s -X GET "https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details?username=a92_mm" \
-H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta oficial
{
"data": {
"id": "8640409651",
"username": "a92_mm",
"fullName": "",
"avatarUrl": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-19/117330532_764310710994941_3178952573818498232_n.jpg?_nc_cat=105&ig_cache_key=GGRS-gb9R230IrcCALjsQ_iF6B0sbkULAAAB0j-ccb7-5&ccb=7-5&_nc_sid=669407&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy42NTYuQzMifQ%3D%3D&_nc_ohc=UhqRB5XucjcQ7kNvwHzZrZa&_nc_oc=AdqQKMjA1CNJE2cZFGaOKLPAekcrEXjIih5fmtbyZIyBJ-ZZBqfAyZouTn139aCO8yM&_nc_zt=24&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_ss=7b62e&oh=00_AQSK1vbEqHI8iXnKTfwnP4mNcPHclgCyRAq7u5j4Lij_Pg&oe=6AE96358",
"biography": "",
"category": "",
"bioLinks": [],
"linkedFacebookInfo": null,
"followerCount": 5,
"followingCount": 34,
"isPrivateAccount": true,
"isVerified": false,
"totalPosts": 9
}
}
Notas de campo que realmente usarás:
- id: Identificador estable de la cuenta.
- username: Nombre de usuario actual (puede cambiar; almacena tanto id como nombre de usuario).
- avatarUrl: Enlace CDN directo para renderizar.
- followerCount, followingCount: Enteros para seguimiento de crecimiento.
- isPrivateAccount: Si es verdadero, las publicaciones no son accesibles sin permiso; planifica tu UI en consecuencia.
- isVerified: Verificación de insignia para validación de creadores.
- totalPosts: Señal de actividad de alto nivel.
Ejemplo en Python (requests)
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details"
params = {"username": "a92_mm"}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, headers=headers, params=params, timeout=20)
resp.raise_for_status()
data = resp.json()["data"]
print("ID:", data["id"])
print("Username:", data["username"])
print("Verified:", data["isVerified"])
print("Private:", data["isPrivateAccount"])
print("Followers:", data["followerCount"])
print("Following:", data["followingCount"])
print("Total posts:", data["totalPosts"])
print("Avatar URL:", data["avatarUrl"])
Otros endpoints útiles para flujos impulsados por perfiles
Una vez que tengas el perfil de un usuario, a menudo necesitarás profundizar en medios específicos. Estos endpoints te ayudan a obtener páginas de detalles para publicaciones individuales, reels o historias destacadas. Todos utilizan el mismo encabezado de Autorización y devuelven campos específicos de medios; las marcas de tiempo son segundos Unix.
Obtener Detalles de Publicación
- Método: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
- Parámetro requerido: idOrUrl (string), por ejemplo, una URL de publicación como https://www.instagram.com/p/DfALy1PTBSa/
Qué hace: Recupera información detallada sobre una publicación específica utilizando id o url. La respuesta incluye campos como id, código, título, createdAt (segundos Unix), objeto autor (id, nombre de usuario, nombre completo, isVerified, profilePictureUrl), totalMedia, estadísticas (likeCount, commentCount) y elementos de mediaList que incluyen downloadUrl donde esté disponible. Utiliza esto para resolver un enlace compartido a los metadatos del autor y estadísticas de participación.
Obtener Detalles de Reel
- Método: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23421/get-reel-details
- Parámetro requerido: idOrUrl (string), por ejemplo, una URL de reel como https://www.instagram.com/reel/DctYV2qt6S5/
Qué hace: Recupera información detallada sobre un reel específico de Instagram utilizando id o url. La respuesta incluye campos como id, código, createdAt (segundos Unix), título, objeto autor, estadísticas (commentCount, likeCount) y un downloadUrl donde sea aplicable. Ideal para informes de campaña cuando solo tienes un enlace de reel de un creador.
Obtener Detalles de Historia Destacada
- Método: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23422/get-highlight-story-details
- Parámetro requerido: id (string), un ID de destacado como 17910014403011985
Qué hace: Recupera todas las historias dentro de un destacado específico de Instagram utilizando el ID del destacado. La respuesta incluye el id del destacado, título, totalStories y un array de historias con campos como id, mediaType, createdAt (segundos Unix), thumbnailUrl y downloadUrl donde esté disponible. Utiliza esto para renderizar los espectadores de destacados o respaldar un conjunto de destacados.
Notas de integración prácticas que ahorran tiempo
- Autenticación: Siempre envía Authorization: Bearer YOUR_API_KEY.
- Marcas de tiempo: los campos createdAt son segundos Unix. Convierte con las utilidades estándar de tu lenguaje.
- Cuentas privadas: Si isPrivateAccount es verdadero, espera medios faltantes o inaccesibles en otros lugares; maneja con gracia.
- Cacheo: Los conteos de perfil pueden ser almacenados en caché durante minutos para reducir llamadas duplicadas; ajusta a las necesidades de frescura de tu UI.
- IDs vs URLs: Para publicaciones y reels, idOrUrl te permite pasar enlaces compartidos directamente, sin un paso de análisis adicional en tu aplicación.
- Descargas: Los campos downloadUrl de medios apuntan a enlaces CDN. Estos pueden expirar; obtén bajo demanda o actualiza URLs antes de usarlas.
- Cuotas: El acceso es por suscripción + cuota. La primera API en tu cuenta generalmente viene con una prueba de 7 días o 50 solicitudes; confirma en la página de listado antes de realizar pruebas de carga.
Flujos del mundo real
1) Incorporación y verificación de creadores
Cuando un creador ingresa su nombre de usuario de Instagram, llama a Obtener Detalles del Perfil para obtener isVerified, followerCount e isPrivateAccount. Rechaza automáticamente cuentas privadas o de bajo rendimiento o dirígelas a revisión manual. Almacena id junto al nombre de usuario para mantener la resiliencia ante cambios de nombre.
2) Instantáneas del rendimiento de campañas
Los influencers comparten enlaces a publicaciones o reels. Pasa ese enlace a Obtener Detalles de Publicación o Obtener Detalles de Reel a través de idOrUrl, luego registra statistics.likeCount y statistics.commentCount junto con author.username. Vuelve a consultar periódicamente para mantener un historial de rendimiento.
3) Selectores de contenido y descargas de activos
Para portafolios, extrae conjuntos destacados a través de Obtener Detalles de Historia Destacada. Muestra historias con thumbnailUrl y permite a los usuarios descargar activos utilizando downloadUrl si está presente. Recuerda que los enlaces CDN pueden expirar; obtén justo a tiempo o actualiza enlaces antes de renderizar un botón de descarga.
Llamando a la API desde agentes de IA a través de MCP
Si utilizas Claude Code, Cursor, Windsurf o cualquier cliente compatible con MCP, puedes permitir que el agente llame a las APIs de Zyla con tu clave existente a través del endpoint MCP. Proporciona tu clave API y haz que el agente emita las mismas solicitudes GET mostradas arriba; el encabezado de Autorización permanece igual. Esto es útil para automatizar búsquedas de datos o generar código de integración a partir de indicaciones en lenguaje natural.
Referencia: URLs y parámetros de solicitud exactos
- Obtener Detalles del Perfil (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details
- username (string, requerido)
- Obtener Detalles de Publicación (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
- idOrUrl (string, requerido), p. ej., https://www.instagram.com/p/DfALy1PTBSa/
- Obtener Detalles de Reel (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23421/get-reel-details
- idOrUrl (string, requerido), p. ej., https://www.instagram.com/reel/DctYV2qt6S5/
- Obtener Detalles de Historia Destacada (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23422/get-highlight-story-details
- id (string, requerido), p. ej., 17910014403011985
Ejemplos oficiales adicionales que puedes consultar
Ejemplo de Obtener Detalles de Publicación (sin cambios requeridos en los encabezados)
Solicitud:
Respuesta (extracto):
Ejemplo de Obtener Detalles de Reel (sin cambios requeridos en los encabezados)
Solicitud:
Respuesta (extracto):
Ejemplo de Obtener Detalles de Historia Destacada (sin cambios requeridos en los encabezados)
Solicitud:
Respuesta (extracto):
Consejos de solución de problemas
- Errores 401 o 403: Confirma el encabezado de Autorización y que la suscripción esté activa en tu cuenta.
- Campos vacíos: Algunos perfiles tienen biografía/categoría en blanco o campos limitados cuando son privados; maneja nulos y cadenas vacías.
- URLs de medios expiradas: Si un downloadUrl falla, vuelve a obtener los detalles del medio para obtener un enlace fresco.
- URLs mal formadas: Al usar idOrUrl, pasa la URL canónica completa de Instagram; codifica la URL al construir cadenas de consulta.
FAQ
-
¿Cómo autentico las solicitudes?
Envía Authorization: Bearer YOUR_API_KEY en el encabezado para cada solicitud.
-
¿Puedo obtener un perfil por ID en lugar de nombre de usuario?
El endpoint de perfil acepta nombre de usuario. Almacena el id devuelto para claves internas, pero consulta por nombre de usuario como se muestra.
-
¿Qué pasa si solo tengo un enlace compartido a una publicación o reel?
Utiliza idOrUrl con el enlace exacto de Instagram en Obtener Detalles de Publicación o Obtener Detalles de Reel. La API lo resuelve y devuelve campos de autor, estadísticas y medios.
-
¿Las marcas de tiempo vienen en un formato estándar?
Sí. Los campos createdAt son marcas de tiempo Unix en segundos. Convierte a tu zona horaria local en tu aplicación.
-
¿Hay un plan gratuito?
El acceso es por suscripción + cuota. La primera API en tu cuenta generalmente ofrece una prueba de 7 días o 50 solicitudes; consulta la página de la API para las opciones de acceso y precios actuales.
¿Listo para enviar tu integración? Suscríbete y obtén tu clave en la página de la API de Datos de Perfil y Medios de Instagram. Tu prueba de 7 días comienza allí, y puedes llamar a los endpoints de perfil, publicación, reel y destacado con la misma clave: Comienza la prueba de 7 días en la API de Datos de Perfil y Medios de Instagram