Tu equipo necesita metadatos de publicaciones, reels y cuentas de Instagram en un formato que puedas enviar a producción esta semana—cuentas, imágenes, dimensiones e información del autor—sin necesidad de ingeniería inversa de HTML o manejar múltiples bibliotecas. Al final de esta guía, podrás llamar a la API de Datos de Instagram desde Zyla API Hub para obtener datos públicos de publicaciones por URL, datos de cuentas por nombre de usuario y métricas de reels por shortcode, e integrarlo en tu servicio o agente de IA.
Lo que puedes construir con la API de Datos de Instagram
La API de Datos de Instagram en Zyla devuelve información estructurada para recursos públicos de Instagram, por lo que puedes integrar contenido social en tu producto sin hacer scraping. Soporta:
- Datos de publicación por URL, incluyendo dimensiones de medios, URLs de visualización y metadatos relacionados.
- Datos de cuenta por nombre de usuario, incluyendo biografía y enlaces de biografía.
- Datos de reels por shortcode, incluyendo like_count, comment_count y video_view_count.
Los casos de uso típicos incluyen widgets de prueba social, paneles de análisis, moderación y enriquecimiento de UGC, y tuberías de ingestión de contenido para informes de marketing.
Zyla API Hub es un mercado de una sola cuenta y una sola clave API con un modelo de suscripción + cuota (no pago por llamada) y un catálogo de más de 10,000 APIs públicas en redes sociales y otras categorías. Puedes explorar el mercado en zylalabs.com y suscribirte a APIs individuales según sea necesario.
Comenzando en Zyla API Hub
Para integrar, abre la página de la API de Datos de Instagram, haz clic en Suscribirse o Comenzar Prueba Gratuita (cuando esté disponible), y copia tu clave API. Cada solicitud utiliza el encabezado de Autorización: Bearer YOUR_API_KEY.
Comienza aquí: Comienza prueba de 7 días en la API de Datos de Instagram. La primera API 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.
Resumen de endpoints
1) Obtener Datos de Publicación
Devuelve datos de publicación de Instagram para una URL de publicación pública.
- Método: GET
- URL: https://zylalabs.com/api/855/instagram-data-api/630/get-post-data
- Parámetro de consulta requerido:
- link (string): URL de publicación de Instagram. Ejemplo: https://www.instagram.com/p/BsOGulcndj-
Ejemplo de cURL:
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/630/get-post-data?link=https%3A%2F%2Fwww.instagram.com%2Fp%2FBsOGulcndj-" \
-H "Authorization: Bearer YOUR_API_KEY"Ejemplo de respuesta (muestra oficial):
{
"status": true,
"__typename": "GraphImage",
"id": "1949525278281554174",
"shortcode": "BsOGulcndj-",
"dimensions": {
"height": 584,
"width": 584
},
"gating_info": null,
"fact_check_overall_rating": null,
"fact_check_information": null,
"sensitivity_friction_info": null,
"sharing_friction_info": {
"should_have_sharing_friction": false,
"bloks_app_url": null
},
"media_overlay_info": null,
"media_preview": null,
"display_url": "https://instagram.fbcn2-1.fna.fbcdn.net/v/t51.82787-15/625727639_18338153224242257_3827527793310630488_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=instagram.fbcn2-1.fna.fbcdn.net&_nc_cat=105&_nc_oc=Q6cZ2gHBlHY2RHKNTgCNzMelAyz56Toi4DI7VUNsrK7XJAsoGT6ka4w7PVJ6IEqS7PD9Ulw&_nc_ohc=jwkKyc7eqGAQ7kNvwHmuCEW&_nc_gid=BiA9YpCodvi1HtqMj6W-Vg&edm=AOmX9WgBAAAA&ccb=7-5&ig_cache_key=MTk0OTUyNTI3ODI4MTU1NDE3NA%3D%3D.3-ccb7-5&oh=00_AQONRzWv-s9IPALJK9qeJ5FVyMcHbwpYaGsJhb7fdlV1nA&oe=6ACE9A40&_nc_sid=bfaa47",
"display_resources": [
{
"src": "https://instagram.fbcn2-1.fna.fbcdn.net/v/t51.82787-15/625727639_18338153224242257_3827527793310630488_n.jpg?stp=dst-jpg_e35_s360x360_sh2.08_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ig_cache_key=MTk0OTUyNTI3ODI4MTU1NDE3NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuNTg0LnNkci5yZWd1bGFyX3Bob3RvLkMzIn0%3D&_nc_ohc=53XaOqCZWBYQ7kNvwFfkQTV&_nc_oc=AdprbrBLkElSfmNNOrQHEYQuCIz8F8lIlYN7TENXKNGCcZVnybmvx0uXH6fzElyfwak&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=instagram.fbcn2-1.fna&_nc_gid=BiA9YpCodvi1HtqMj6W-Vg&_nc_ss=7a3ba&oh=00_AQNBRrpvxf3JGSktIaicSqaD4UtCuDo9I8feI6acpRs9Eg&oe=6ACE9A40",
"config_width": 360,
"config_height": 360
},
{
"src": "https://instagram.fbcn2-1.fna.fbcdn.net/v/t51.82787-15/625727639_18338153224242257_3827527793310630488_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ig_cache_key=MTk0OTUyNTI3ODI4MTU1NDE3NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuNTg0LnNkci5yZWd1bGFyX3Bob3RvLkMzIn0%3D&_nc_ohc=53XaOqCZWBYQ7kNvwFfkQTV&_nc_oc=AdprbrBLkElSfmNNOrQHEYQuCIz8F8lIlYN7TENXKNGCcZVnybmvx0uXH6fzElyfwak&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=instagram.fbcn2-1.fna&_nc_gid=BiA9YpCodvi1HtqMj6W-Vg&_nc_ss=7a3ba&oh=00_AQMhFQizLfIe4bAcskLHhT2nCDcjFGyldOq2Cp7IMLuVxg&oe=6ACE9A40",
"config_width": 584,
"config_height": 584
}
],
"accessibility_caption…Campos clave que normalmente usarás:
- id y shortcode: identificadores estables para deduplicación y vinculación.
- dimensions: altura y ancho del medio.
- display_url y display_resources: URLs a activos de medios en diferentes tamaños.
- __typename: pista del tipo de medio (por ejemplo, GraphImage).
2) Obtener Datos de Cuenta
Devuelve datos públicos de cuentas de Instagram por nombre de usuario.
- Método: GET
- URL: https://zylalabs.com/api/855/instagram-data-api/631/get-account-data
- Parámetro de consulta requerido:
- username (string): nombre de usuario de Instagram. Ejemplo: leomessi
Ejemplo de cURL:
La respuesta devuelve metadatos de la cuenta, como la biografía y los enlaces de biografía para el nombre de usuario especificado.
3) Obtener Datos de Reel
Devuelve métricas de reels/publicaciones de Instagram públicas por shortcode. Incluye conteos de likes, comentarios y vistas.
- Método: GET
- URL: https://zylalabs.com/api/855/instagram-data-api/32007/get-reel-data
- Parámetro de consulta requerido:
- shortcode (string): shortcode de Instagram para la publicación/reel. Ejemplo: DctYV2qt6S5
Ejemplo de cURL:
Ejemplo de respuesta (muestra oficial):
Campos clave que normalmente usarás:
- like_count y comment_count: métricas de compromiso para paneles y alertas.
- video_view_count (y play_count): seguimiento del rendimiento del reel.
- code: eco del shortcode solicitado para correlación.
Ejemplo de extremo a extremo en Python
El fragmento a continuación obtiene métricas de reels por shortcode e imprime KPIs de compromiso. Utiliza el mismo endpoint y parámetros mostrados en el ejemplo de cURL anterior.
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
SHORTCODE = "DctYV2qt6S5"
url = "https://zylalabs.com/api/855/instagram-data-api/32007/get-reel-data"
params = {"shortcode": SHORTCODE}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=15)
resp.raise_for_status()
data = resp.json()
# Extraer los campos que tu aplicación probablemente necesita
like_count = data.get("like_count")
comment_count = data.get("comment_count")
views = data.get("video_view_count")
print({
"shortcode": data.get("code"),
"likes": like_count,
"comments": comment_count,
"views": views
})JSON que puedes esperar (como se muestra arriba):
Notas de implementación que ahorran tiempo
- Encabezado de autorización: Siempre incluye Authorization: Bearer YOUR_API_KEY. No envíes la clave en parámetros de consulta.
- Codificación de URL: Para Obtener Datos de Publicación, el parámetro link debe estar codificado en URL. El cURL proporcionado muestra la forma correcta.
- Solo datos públicos: Estos endpoints devuelven información para recursos públicos de Instagram.
- Cacheo: Los números de compromiso en reels pueden cambiar rápidamente. Si estás haciendo polling, almacena respuestas brevemente (por ejemplo, 30–120 segundos) para evitar llamadas redundantes mientras mantienes los paneles actualizados.
- Manejo de errores: Maneja errores no 200 y errores de análisis de JSON. El retroceso exponencial ayuda si agrupas actualizaciones.
- Cuotas: Las APIs de Zyla utilizan suscripción + cuota. La primera API generalmente incluye una prueba de 7 días o 50 solicitudes; consulta la lista para los límites actuales antes de realizar grandes cargas.
Casos de uso en el mundo real
- Incrustar publicaciones con metadatos verificados: Resuelve una URL de publicación a dimensiones y un display_url, almacena el shortcode y renderiza con una interfaz de usuario consistente.
- Páginas de creadores y marcas: Usa Obtener Datos de Cuenta para mostrar la biografía de una cuenta y enlaces salientes adyacentes a campañas o páginas de productos.
- Seguimiento del rendimiento de reels: Realiza polling a Obtener Datos de Reel para shortcodes de alta prioridad cada minuto y envía deltas (likes, comentarios, video_view_count) a tu almacén de métricas.
- QA automatizado en UGC: Valida que una URL de Instagram enviada realmente resuelva a una imagen o reel y cumpla con tus requisitos de tamaño a través de dimensiones.
Llamando a la API desde agentes de IA (MCP)
Puedes llamar a las APIs de Zyla desde clientes compatibles con MCP a través del endpoint MCP en https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY. Esto es útil para prototipos con herramientas de codificación de IA o para integrar verificaciones en libros de trabajo de IA. Consulta MCP para más detalles.
Colección de solicitudes lista para copiar
Usa estas solicitudes exactas con tu clave insertada en el encabezado de Autorización.
Obtener Datos de Publicación (por URL)
Obtener Datos de Cuenta (por nombre de usuario)
Obtener Datos de Reel (por shortcode)
Lista de verificación operativa
- Claves en env: Almacena YOUR_API_KEY en tu gestor de secretos o variable de entorno.
- Monitoreo: Rastrea errores no 200 y timeouts; reintenta fallos transitorios.
- Modelo de datos: Persiste el shortcode para publicaciones/reels para evitar duplicados y habilitar actualizaciones específicas.
- Tasa de cambio: Los reels se actualizan con frecuencia; programa ventanas de polling más ajustadas para elementos prioritarios y ventanas más largas para el resto.
- Gestión del mercado: Usa tu panel de Zyla para monitorear el uso de cuotas. Siempre puedes explorar APIs adicionales de Redes Sociales y Networking en zylalabs.com al expandir características.
FAQ
Q: ¿Cómo autentico las solicitudes?
A: Incluye el encabezado Authorization: Bearer YOUR_API_KEY en cada solicitud.
Q: ¿Qué entrada debo pasar a Obtener Datos de Publicación?
A: Proporciona una URL codificada de Instagram a través del parámetro link, por ejemplo link=https%3A%2F%2Fwww.instagram.com%2Fp%2FBsOGulcndj-.
Q: ¿Qué entrada debo pasar a Obtener Datos de Reel?
A: Proporciona el valor del shortcode del reel/publicación objetivo utilizando el parámetro de consulta shortcode.
Q: ¿La API devuelve conteos de likes y vistas?
A: Sí, Obtener Datos de Reel devuelve like_count, comment_count, play_count y video_view_count.
Q: ¿Hay un plan gratuito?
A: Zyla utiliza suscripción + cuota. La primera API generalmente incluye una prueba de 7 días o 50 solicitudes; consulta la lista para las opciones de acceso y precios actuales.
¿Listo para integrar esto en tu pipeline? Crea tu cuenta y comienza la prueba de 7 días directamente en la lista: Comienza prueba de 7 días en la API de Datos de Instagram. Tu única clave API de Zyla funciona en cualquier otra API que agregues más tarde.
