API para información de publicaciones

Necesitas datos confiables a nivel de publicaciones de Instagram y los necesitas esta semana. Al final de esta guía, podrás obtener información rica sobre publicaciones de Instagram (código corto, dimensiones de medios, indicadores de imagen/video, descripciones y más) con una sola solicitud HTTP GET en Zyla API Hub, analizar el JSON y agregarlo a tu pipeline o producto.

Lo que puedes construir con un verdadero endpoint de datos de publicaciones de Instagram

La API de Datos de Instagram en Zyla API Hub proporciona acceso rápido y estructurado al contenido de Instagram sin necesidad de crear scrapers. Tú proporcionas:

• Un enlace de publicación para obtener datos de la publicación.
• Un nombre de usuario para obtener datos de la cuenta.
• Un código corto para obtener información detallada de la publicación, incluyendo medios, descripción, detalles del perfil del propietario, fecha de publicación, me gusta y metadatos de comentarios.

Los equipos utilizan esto para enriquecer entradas de CMS, potenciar la expansión de enlaces, automatizar informes y dirigir flujos de trabajo de moderación. Debido a que está en Zyla API Hub, obtienes una cuenta, una clave API y un modelo de suscripción + cuota a través de miles de APIs, sin facturación por llamada.

Comenzando en Zyla API Hub

Abre la lista de la API de Datos de Instagram en Zyla API Hub y comienza una prueba para obtener una clave API. La autenticación es a través del encabezado HTTP Authorization: Bearer YOUR_API_KEY. El mercado funciona con suscripción + cuota (no pago por llamada). Consulta la página de la API para las opciones de acceso y precios actuales; puedes Iniciar prueba de 7 días en la API de Datos de Instagram directamente desde la página del ítem.

Endpoints que utilizarás

1) Obtener Datos de Publicación

Proporciona una URL pública de una publicación de Instagram para recuperar los datos de la publicación.

• Método: GET
• URL: https://zylalabs.com/api/855/instagram-data-api/630/get-post-data
• Parámetro de consulta requerido:
  • link (string): la URL de la publicación de Instagram (codificada en URL). Ejemplo: https://www.instagram.com/p/BsOGulcndj-

Copia y pega 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"

Respuesta JSON de 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…

Lo que realmente usarás aquí:

• status: indica una búsqueda exitosa.
• shortcode: el código único que puedes usar en otros lugares.
• dimensions: tamaño del activo de medios (píxeles).
• display_url: la URL directa de la imagen para vistas previas o almacenamiento en caché.
• display_resources: URLs de variantes de tamaño si necesitas diferentes resoluciones.

2) Obtener Datos de Cuenta

Proporciona un nombre de usuario público de Instagram para recuperar los datos de la cuenta.

• Método: GET
• URL: https://zylalabs.com/api/855/instagram-data-api/631/get-account-data
• Parámetro de consulta requerido:
  • username (string): por ejemplo, cristiano

Copia y pega cURL:

La respuesta incluye metadatos del perfil y enlaces externos. Úsalo para hidratar la información del autor para las publicaciones que obtengas, o para validar que un identificador existe antes de poner en cola el rastreo de publicaciones.

3) Información de Publicación

Recupera datos detallados de publicaciones de Instagram usando el código corto.

• Método: GET
• URL: https://zylalabs.com/api/855/instagram-data-api/37566/post-information
• Parámetro de consulta requerido:
  • code (string): por ejemplo, DfI02-LTwkc

Copia y pega cURL:

Ejemplo de respuesta (abreviado a los campos mostrados en la lista):

Lo que realmente usarás aquí:

• __typename: te dice si es una imagen, video, etc.
• is_video: booleano para ramificar el comportamiento de tu renderizador y CDN.
• display_url y display_resources: URLs para obtener o almacenar en caché medios.
• accessibility_caption: texto útil para texto alternativo o resúmenes.
• dimensions: guía para el manejo de la relación de aspecto en tu interfaz de usuario.

Un ejemplo funcional en Python

Este fragmento de Python llama al endpoint de Información de Publicación usando un código corto y extrae los campos que probablemente mapearás en tus modelos.

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
SHORTCODE = "DfI02-LTwkc"

url = "https://zylalabs.com/api/855/instagram-data-api/37566/post-information"
params = {"code": SHORTCODE}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()

if data.get("status") == "ok" and "data" in data and "post" in data["data"]:
post = data["data"]["post"]
out = {
"id": post.get("id"),
"shortcode": post.get("shortcode"),
"type": post.get("__typename"),
"is_video": post.get("is_video"),
"width": (post.get("dimensions") or {}).get("width"),
"height": (post.get("dimensions") or {}).get("height"),
"display_url": post.get("display_url"),
"accessibility_caption": post.get("accessibility_caption"),
}
print(out)
else:
print("Búsqueda fallida o sin carga útil de publicación:", data)

Notas:

• El encabezado de autorización es requerido: Bearer YOUR_API_KEY.
• Usa tiempos de espera en clientes HTTP. Almacena en caché las respuestas de tu lado para evitar volver a obtener publicaciones estáticas.
• Los códigos cortos son cadenas opacas; no asumas un formato más allá de lo que recibes.

Detalles de implementación práctica que ahorran tiempo

• Codificación de URL: Al usar Obtener Datos de Publicación, codifica el parámetro de enlace. El cURL oficial muestra un valor de URL codificado.
• Variantes de medios: display_resources puede incluir múltiples tamaños. Elige el tamaño más cercano a tu visualización objetivo para reducir el ancho de banda.
• Accesibilidad: accessibility_caption puede servir como texto alternativo y mejorar el soporte para lectores de pantalla.
• Rama por tipo: Usa __typename e is_video para decidir si renderizar un componente de imagen, un reproductor de video o lógica de carrusel en tu aplicación.
• Estabilidad: Los metadatos a nivel de publicación son relativamente estables para publicaciones públicas. Implementa un almacenamiento en caché básico con una expiración apropiada para tu producto (por ejemplo, horas a días) y solo actualiza si detectas cambios que te importan.
• Cuotas y acceso: Las APIs de Zyla funcionan con suscripción + cuota. Consulta la página de listado para tus límites actuales. El primer paso es la prueba de 7 días en la página del ítem.

De extremo a extremo: eligiendo el endpoint correcto para tu flujo

• Si comienzas con una URL completa de Instagram: usa Obtener Datos de Publicación. Recibirás el código corto y las URLs de medios directamente del enlace.
• Si comienzas solo con un código corto: llama a Información de Publicación. Obtendrás detalles de publicación más ricos adecuados para renderización y análisis.
• Si necesitas contexto del autor: llama a Obtener Datos de Cuenta con el nombre de usuario para obtener metadatos del perfil y enlaces para atribución o tarjetas de perfil.

Casos de uso en el mundo real

• Expansión de enlaces en herramientas de chat/soporte: Al pegar una URL de Instagram, llama a Obtener Datos de Publicación, captura display_url y dimensiones, y renderiza una vista previa compacta con texto alternativo de accessibility_caption.
• Pipelines editoriales: Cuando los editores agregan un código corto a tu CMS, usa Información de Publicación para obtener medios canónicos, tipo y descripciones; almacena ancho/alto para diseño responsivo.
• Analítica de creadores: Combina Información de Publicación con tus métricas internas para informar sobre la mezcla de contenido (imagen vs. video) y mantener un archivo de medios con el tamaño adecuado.
• Moderación: Usa Información de Publicación para obtener rápidamente los metadatos de medios y descripciones de una publicación y dirigirla para revisión sin cargar la página web completa.

Llamando a la API desde agentes de IA a través de MCP

Puedes invocar APIs en Zyla a través de un cliente compatible con MCP (por ejemplo, Claude Code, Cursor, Windsurf). Configura tu cliente con el endpoint MCP y tu clave; las llamadas se dirigen usando tus credenciales de API de Zyla.

• Endpoint MCP: MCP
• Clave API: usa la misma credencial Authorization: Bearer YOUR_API_KEY que obtuviste de la lista de la API de Datos de Instagram.

Desde allí, instruye a tu agente para que solicite los endpoints de la API de Datos de Instagram documentados arriba proporcionando los parámetros de consulta requeridos (enlace, nombre de usuario o código). Esto te permite encadenar tareas de recuperación y transformación dentro del agente con un código mínimo de unión.

Lista de verificación operativa

• Autenticación: Siempre envía Authorization: Bearer YOUR_API_KEY.
• Codificación: Codifica en URL el parámetro de enlace para Obtener Datos de Publicación.
• Tiempos de espera y reintentos: Usa tiempos de espera en el cliente; implementa reintentos con retroceso en problemas de red transitorios.
• Almacenamiento en caché: Almacena en caché los resultados de publicaciones estáticas para reducir la latencia y el uso de cuotas.
• Monitoreo: Registra la ruta del endpoint, valores de consulta (menos secretos), estado y latencia para detectar regresiones temprano.

Por qué implementar en Zyla API Hub

• Una cuenta y una clave API a través de más de 10,000 APIs públicas en categorías como social, finanzas, enriquecimiento, IA, geolocalización y utilidades.
• Modelo de suscripción + cuota en lugar de pago por llamada.
• Endpoint MCP para flujos de trabajo impulsados por agentes.

Puedes comenzar directamente desde la lista de la API de Datos de Instagram: Iniciar prueba de 7 días en la API de Datos de Instagram.

FAQ

¿Qué autenticación utiliza esta API?
Envía el encabezado HTTP Authorization: Bearer YOUR_API_KEY con cada solicitud.

¿Qué endpoint debo usar si solo tengo la URL de Instagram?
Usa GET https://zylalabs.com/api/855/instagram-data-api/630/get-post-data con el parámetro de consulta link. Asegúrate de que la URL esté codificada en URL.

¿Cómo obtengo detalles de medios más ricos una vez que tengo un código corto?
Llama a GET https://zylalabs.com/api/855/instagram-data-api/37566/post-information con code configurado al código corto. Recibirás campos como __typename, is_video, dimensions, display_url, accessibility_caption y más.

¿Puedo buscar información de cuenta para un nombre de usuario?
Sí. Usa GET https://zylalabs.com/api/855/instagram-data-api/631/get-account-data con username configurado al identificador.

¿Hay un plan gratuito?
El acceso funciona con un modelo de suscripción + cuota. Consulta la página de la API para las opciones de acceso actuales; una prueba de 7 días comienza desde la página del ítem.

¿Listo para implementar tu integración? Obtén tu clave y comienza a llamar a los endpoints desde la lista de la API de Datos de Instagram: Iniciar prueba de 7 días en la API de Datos de Instagram.