Necesitas datos confiables de publicaciones y perfiles de Instagram que puedas integrar en un flujo de trabajo de producción esta semana. Al final de este artículo, podrás obtener detalles a nivel de publicación (dimensiones, URLs de medios, textos de descripción, señales de interacción) y datos a nivel de perfil (nombre de usuario, biografía, verificación, foto, enlaces) utilizando la API de Datos de Instagram en Zyla API Hub, con solicitudes listas para copiar y patrones listos para integrar.
Lo que puedes construir con la API de Datos de Instagram
La API de Datos de Instagram proporciona dos puntos finales de lectura de alta señal que los desarrolladores necesitan rutinariamente para características de redes sociales:
- Información de Publicaciones: busca una publicación por su shortcode para recuperar metadatos de medios (banderas de imagen/video, dimensiones, URLs), texto de descripción, resumen del perfil del propietario y campos de interacción.
- Detalles del Perfil: busca un perfil por nombre de usuario o ID para recuperar estado de verificación, foto de perfil, contexto de seguidores, biografía, enlaces externos y otros descriptores de la cuenta.
Estos puntos finales son útiles para paneles de análisis social, monitoreo de marcas, auditorías de contenido automatizadas, enriquecimiento de enlaces, verificaciones de perfil y tuberías de incrustación de publicaciones donde necesitas atributos de medios deterministas antes de renderizar.
Comenzando en Zyla API Hub
Abre la lista de API en Zyla API Hub y suscríbete para obtener tu clave. El Hub funciona con un modelo de suscripción + cuota (no pago por llamada). Para una primera API, puedes comenzar una prueba de 7 días o 50 solicitudes. Consulta la página de la API para las opciones de acceso y precios actuales.
- Comienza la prueba de 7 días en la API de Datos de Instagram
- Navega más de 10,000 APIs públicas en Zyla API Hub
La autenticación se envía con cada solicitud utilizando el encabezado HTTP Authorization: Bearer YOUR_API_KEY.
Puntos finales que usarás
1) Información de Publicaciones
Método: GET
URL: https://zylalabs.com/api/855/instagram-data-api/37566/post-information
Parámetro de consulta requerido:
- code (string): El shortcode de la publicación de Instagram. Ejemplo: DfI02-LTwkc
Lo que devuelve: información detallada de la publicación de Instagram, incluyendo shortcode, dimensiones de medios, URLs de imágenes, bandera de video, descripción, detalles del perfil del propietario, fecha de publicación, me gusta y comentarios.
Ejemplo oficial de curl:
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/37566/post-information?code=DfI02-LTwkc" \
-H "Authorization: Bearer YOUR_API_KEY"
Ejemplo oficial de respuesta JSON (verbatim):
{
"status": "ok",
"data": {
"post": {
"__typename": "GraphVideo",
"id": "4019695143460210972",
"shortcode": "DfI02-LTwkc",
"dimensions": {
"height": 718,
"width": 1020
},
"display_url": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=100&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7020f&oh=00_AQSFeFgTX4qgUU-VPIinjkrZASMg4NkxlFyIzab67V5zow&oe=6AEB0083",
"is_video": true,
"accessibility_caption": "Video de Tesla el 30 de octubre de 2026. Puede ser una imagen de limusina, minivan, noche y texto.",
"display_resources": [
{
"src": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=100&ig_cache_key=NDAxOTY5NTE0MzQ2MDIxMDk3MjE4NjQ0NTc4MjA0MDA0MTM1.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fdXNlcl9zZWxlY3RlZF90aHVtYm5haWwuQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7060f&oh=00_AQR9wbRhfpvbBzM62jt9275twGnXRdiKlpV7kHlOv-NxBw&oe=6AEB0083",
"config_width": 720,
"config_height": 506
},
{
"src": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=100&ig_cache_key=NDAxOTY5NTE0MzQ2MDIxMDk3MjE4NjQ0NTc4MjA0MDA0MTM1.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fdXNlcl9zZWxlY3RlZF90aHVtYm5haWwuQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7060f&oh=00_AQS1dgCJVbPnKwyP9gf442dDrUD3XTZzXdzz-VZ9sltSKA&oe=6AEB0083",
"config_width": 640,
"config_h…
Campos que comúnmente leerás en la respuesta:
- post.shortcode: el shortcode único de la publicación que consultaste.
- post.is_video: bandera booleana que te indica si debes esperar un activo de video.
- post.dimensions.width/height: usa para dimensionar contenedores o generar marcadores de posición responsivos.
- post.display_url y post.display_resources[i].src: URLs de medios que puedes almacenar o almacenar en caché según sea necesario.
- post.accessibility_caption: útil para texto alternativo o auditoría de contenido.
2) Detalles del Perfil
Método: GET
URL: https://zylalabs.com/api/855/instagram-data-api/37572/profile-details
Parámetro de consulta requerido:
- id_or_username (string): Nombre de usuario de Instagram o ID numérico. Ejemplo: cristiano
Lo que devuelve: información detallada del perfil de Instagram, incluyendo nombre de usuario, biografía, estado de verificación, foto de perfil, conteos de seguidores y seguidos, enlaces externos, destacados de historias y detalles de la cuenta.
Ejemplo oficial de curl:
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/37572/profile-details?id_or_username=cristiano" \
-H "Authorization: Bearer YOUR_API_KEY"
Ejemplo oficial de respuesta JSON (verbatim):
{
"status": "ok",
"data": {
"user": {
"pk": "173560420",
"username": "cristiano",
"profile_pic_url": "https://scontent-fra5-1.cdninstagram.com/v/t51.2885-19/472007201_1142000150877579_994350541752907763_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=YjSGq_4F5PwQ7kNvwGAf5GW&_nc_oc=AdrE9TNJ3DCmDwEYUzm5V1uTncNAl5vdTNunoBb6plzuRC7AMBnUZ4VPbRqG3H4p4dc&_nc_zt=24&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_ss=7060f&oh=00_AQQkDdv_NHNUxezd5SGePgHmJXPwMrXfPk1NrU-e_bz62w&oe=6AEB1EDE",
"is_private": false,
"is_unpublished": false,
"latest_reel_media": 0,
"biography": "",
"full_name": "Cristiano Ronaldo",
"is_verified": true,
"text_post_app_badge_label": null,
"show_text_post_app_badge": false,
"account_badges": [],
"bio_links": [
{
"image_url": "",
"is_pinned": false,
"link_id": "18122242507586533",
"link_type": "external",…
Campos que comúnmente leerás en la respuesta:
- user.username y user.pk: claves canónicas para tu almacenamiento de usuarios.
- user.is_verified y user.is_private: para verificaciones de estado y flujos de acceso.
- user.profile_pic_url: muestra un avatar o almacena para caché CDN.
- user.full_name y user.biography: útiles para tarjetas de autor enriquecidas junto a publicaciones incrustadas.
- user.bio_links: extrae destinos fuera de la plataforma para análisis de enlaces o atribución de socios.
Ejemplos de extremo a extremo que puedes pegar
Python: Obtener Información de Publicaciones y normalizar para renderizado
Este ejemplo de Python llama al punto final de Información de Publicaciones, extrae el tamaño de los medios, texto alternativo y una URL de visualización preferida para tu front-end.
import os
import requests
API_KEY = os.getenv("ZYLA_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()
post = data.get("data", {}).get("post", {})
is_video = post.get("is_video")
dims = post.get("dimensions", {})
width, height = dims.get("width"), dims.get("height")
# Elegir un recurso de visualización: mayor config_width si está disponible, de lo contrario, fallback a display_url
display_resources = post.get("display_resources", []) or []
best = None
if display_resources:
best = max(display_resources, key=lambda r: r.get("config_width", 0))
display_src = (best or {}).get("src") or post.get("display_url")
normalized = {
"shortcode": post.get("shortcode"),
"is_video": is_video,
"width": width,
"height": height,
"src": display_src,
"alt": post.get("accessibility_caption") or "",
}
print(normalized)
JavaScript (Node.js): Obtener Detalles del Perfil por nombre de usuario
Este fragmento de Node.js solicita un perfil público por nombre de usuario y extrae metadatos de verificación y avatar para un componente de insignia de autor.
import fetch from "node-fetch";
const API_KEY = process.env.ZYLA_API_KEY || "YOUR_API_KEY";
const username = "cristiano";
const url = "https://zylalabs.com/api/855/instagram-data-api/37572/profile-details?id_or_username=" + encodeURIComponent(username);
const res = await fetch(url, {
method: "GET",
headers: {
"Authorization": `Bearer ${API_KEY}`
}
});
if (!res.ok) {
throw new Error(`Request failed: ${res.status} ${res.statusText}`);
}
const json = await res.json();
const user = (json.data && json.data.user) || {};
const author = {
username: user.username,
fullName: user.full_name,
verified: user.is_verified === true,
private: user.is_private === true,
avatar: user.profile_pic_url || null
};
console.log(author);
Notas de implementación práctica
- Entrada de shortcode: El punto final de Información de Publicaciones requiere el shortcode de la publicación (no una URL completa). Almacena los shortcodes como tu clave canónica para búsquedas de publicaciones.
- Elegir variantes de imagen: La respuesta incluye display_resources con múltiples tamaños. Elige el mayor config_width que soportes para reducir cambios de diseño.
- Texto alternativo: accessibility_caption es un fuerte valor predeterminado para el texto alternativo. Retrocede de manera elegante si falta.
- Caché: Las URLs de medios pueden cambiar; almacena cargas normalizadas (shortcode → imagen elegida, width/height, alt) e implementa una actualización en un horario adecuado para tu UI.
- Manejo de errores: Siempre verifica la presencia de data.data.post o data.data.user antes de desreferenciar campos.
- Cuotas: Zyla utiliza suscripción + cuota. Monitorea tu uso de solicitudes e implementa cachés locales simples para evitar búsquedas duplicadas en rutas críticas.
Casos de uso comunes en redes sociales que puedes implementar esta semana
1) Tarjetas de vista previa de publicaciones en editores de contenido
Permite que los editores peguen una URL de publicación de Instagram, analicen el shortcode y llamen a Información de Publicaciones para rellenar automáticamente una tarjeta de vista previa con medios, dimensiones y fragmentos de descripción. Almacena la carga normalizada para un renderizado inmediato y evita saltos de diseño utilizando el width/height.
2) Insignias de autor con verificación y avatar
Cuando renderices una publicación o cita de Instagram, llama a Detalles del Perfil con el nombre de usuario para mostrar un avatar preciso, el nombre de visualización y una insignia de verificación condicionalmente en user.is_verified.
3) Tubos de monitoreo de marcas
Mantén una lista de vigilancia de nombres de usuario y actualiza periódicamente Detalles del Perfil para rastrear cambios de verificación, actualizaciones de nombre de usuario o cambios en enlaces de biografía. Las alertas posteriores pueden activarse ante cambios en bio_links o toggles de is_private.
4) Análisis de enlaces enriquecidos
Cuando un socio liste su handle de Instagram, utiliza Detalles del Perfil para confirmar que el handle existe y extraer bio_links para descubrir sus destinos fuera de la plataforma antes de redirigir tráfico o atribuir conversiones.
5) Moderación de contenido y verificaciones de accesibilidad
Utiliza accessibility_caption como una señal para verificaciones automatizadas de etiquetado alternativo. Marca publicaciones que falten contenido similar a texto alternativo en flujos de trabajo donde se requieran estándares de cumplimiento o accesibilidad.
Llamando a la API desde agentes de IA a través de MCP
Puedes conectar los mismos puntos finales a agentes de IA que soportan el Protocolo de Contexto de Modelo (MCP), incluyendo Claude Code, Cursor y Windsurf. Configura tu agente para llamar a la puerta de enlace MCP de Zyla:
- Punto final: MCP
- Clave API: pasa YOUR_API_KEY según lo configurado por tu cliente compatible con MCP
En tiempo de ejecución, tu agente puede solicitar las mismas URLs mostradas arriba. Mantén la autenticación consistente: Authorization: Bearer YOUR_API_KEY.
Consejos operativos para producción
- Normaliza temprano: Convierte las respuestas en una forma interna estable (por ejemplo, Publicación {shortcode, isVideo, w, h, src, alt}). Almacena eso junto con marcas de tiempo para invalidación de caché.
- Política de reintentos: Implementa reintentos breves y limitados en fallos de red 5xx; registra respuestas 4xx para visibilidad y evita bucles.
- Renderizado seguro: Siempre protege campos opcionales (por ejemplo, display_resources puede estar ausente; retrocede a display_url).
- Patrones de agrupamiento: Al enriquecer una cola de nombres de usuario, escalona las llamadas y elimina duplicados dentro de una ventana de tiempo para mantenerte dentro de tu cuota de suscripción.
Referencia: Ejemplos oficiales (como los devueltos por el Hub)
Información de Publicaciones: cURL
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/37566/post-information?code=DfI02-LTwkc" \
-H "Authorization: Bearer YOUR_API_KEY"
Información de Publicaciones: JSON
{
"status": "ok",
"data": {
"post": {
"__typename": "GraphVideo",
"id": "4019695143460210972",
"shortcode": "DfI02-LTwkc",
"dimensions": {
"height": 718,
"width": 1020
},
"display_url": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=100&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7020f&oh=00_AQSFeFgTX4qgUU-VPIinjkrZASMg4NkxlFyIzab67V5zow&oe=6AEB0083",
"is_video": true,
"accessibility_caption": "Video de Tesla el 30 de octubre de 2026. Puede ser una imagen de limusina, minivan, noche y texto.",
"display_resources": [
{
"src": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=100&ig_cache_key=NDAxOTY5NTE0MzQ2MDIxMDk3MjE4NjQ0NTc4MjA0MDA0MTM1.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fdXNlcl9zZWxlY3RlZF90aHVtYm5haWwuQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7060f&oh=00_AQR9wbRhfpvbBzM62jt9275twGnXRdiKlpV7kHlOv-NxBw&oe=6AEB0083",
"config_width": 720,
"config_height": 506
},
{
"src": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=100&ig_cache_key=NDAxOTY5NTE0MzQ2MDIxMDk3MjE4NjQ0NTc4MjA0MDA0MTM1.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fdXNlcl9zZWxlY3RlZF90aHVtYm5haWwuQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7060f&oh=00_AQS1dgCJVbPnKwyP9gf442dDrUD3XTZzXdzz-VZ9sltSKA&oe=6AEB0083",
"config_width": 640,
"config_h…
Detalles del Perfil: cURL
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/37572/profile-details?id_or_username=cristiano" \
-H "Authorization: Bearer YOUR_API_KEY"
Detalles del Perfil: JSON
{
"status": "ok",
"data": {
"user": {
"pk": "173560420",
"username": "cristiano",
"profile_pic_url": "https://scontent-fra5-1.cdninstagram.com/v/t51.2885-19/472007201_1142000150877579_994350541752907763_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=YjSGq_4F5PwQ7kNvwGAf5GW&_nc_oc=AdrE9TNJ3DCmDwEYUzm5V1uTncNAl5vdTNunoBb6plzuRC7AMBnUZ4VPbRqG3H4p4dc&_nc_zt=24&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_ss=7060f&oh=00_AQQkDdv_NHNUxezd5SGePgHmJXPwMrXfPk1NrU-e_bz62w&oe=6AEB1EDE",
"is_private": false,
"is_unpublished": false,
"latest_reel_media": 0,
"biography": "",
"full_name": "Cristiano Ronaldo",
"is_verified": true,
"text_post_app_badge_label": null,
"show_text_post_app_badge": false,
"account_badges": [],
"bio_links": [
{
"image_url": "",
"is_pinned": false,
"link_id": "18122242507586533",
"link_type": "external",…
Pruebas y monitoreo
- Pruebas de humo: Agrega un paso de CI que solicite un shortcode y nombre de usuario conocidos y afirme la presencia de campos requeridos antes de desplegar cambios en la UI.
- Observabilidad: Registra fallos de decodificación con la URL de solicitud original (sin secretos) para depurar problemas de parámetros rápidamente.
- Retroceso: En respuestas no 200 repetidas, retrocede y muestra una alerta en el panel; no hagas bucles.
FAQ
Q: ¿Cómo me autentico?
A: Incluye el encabezado Authorization: Bearer YOUR_API_KEY en cada solicitud.
Q: ¿Dónde obtengo una clave API?
A: Abre la lista del mercado y haz clic en Suscribirse o Comenzar Prueba Gratuita, luego copia tu clave desde el panel.
Q: ¿Qué parámetros son requeridos para cada punto final?
A: Información de Publicaciones requiere code (el shortcode de la publicación). Detalles del Perfil requiere id_or_username (un nombre de usuario o ID numérico).
Q: ¿Puedo llamar a estos puntos finales desde agentes de codificación de IA?
A: Sí. Usa la puerta de enlace MCP de Zyla y configura tu agente para reenviar las mismas URLs y el encabezado de Autorización. Consulta el punto final MCP.
Q: ¿Hay un plan gratuito?
A: No hay un plan gratuito. El Hub utiliza suscripción + cuota, y para una primera API puedes comenzar una prueba de 7 días o 50 solicitudes. Consulta la lista para las opciones de acceso actuales.
¿Listo para implementar tu integración de Instagram? Crea una cuenta, suscríbete y comienza a construir con la API de Datos de Instagram en Zyla API Hub.