{
"description": null,
"favicon": "https://zylalabs.com/favicon.ico",
"image": null,
"siteName": "zylalabs.com",
"title": "Just a moment...",
"url": "https://zylalabs.com/"
}
curl --location --request GET 'https://zylalabs.com/api/13352/link+preview+-+url+unfurl+api/28457/preview?url=https://zylalabs.com' --header 'Authorization: Bearer YOUR_API_KEY'
{
"results": [
{
"description": "Stripe is a financial services platform that helps all types of businesses accept payments, build flexible billing models, and manage money movement.",
"favicon": "https://images.stripeassets.com/fzn2n1nzq965/1hgcBNd12BfT9VLgbId7By/01d91920114b124fb4cf6d448f9f06eb/favicon.svg",
"image": "https://images.stripeassets.com/fzn2n1nzq965/XtX984S1GJVsVOXFC7kMu/01988281e867728dfb09aa7793a6e3b9/Stripe.jpg?q=80",
"siteName": "stripe.com",
"title": "Stripe | Financial Infrastructure to Grow Your Revenue",
"url": "https://stripe.com/"
},
{
"description": "Join the world's most widely adopted, AI-powered developer platform where millions of developers, businesses, and the largest open source community build software that advances humanity.",
"favicon": "https://github.com/fluidicon.png",
"image": "https://images.ctfassets.net/8aevphvgewt8/4pe4eOtUJ0ARpZRE4fNekf/f52b1f9c52f059a33170229883731ed0/GH-Homepage-Universe-img.png",
"siteName": "GitHub",
"title": "GitHub · Change is constant. GitHub keeps you ahead.",
"url": "https://github.com/"
}
]
}
curl --location --request POST 'https://zylalabs.com/api/13352/link+preview+-+url+unfurl+api/28458/preview+batch' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"urls": [
"https://stripe.com",
"https://github.com"
]
}'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Vista previa del enlace - Desenredar URL API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
(Ahorra 2 meses pagando anualmente 🎉)
Empresas líderes confían en nosotros
Ofrece a tu aplicación las vistas previas ricas de enlaces que los usuarios esperan — las tarjetas que Slack, iMessage y Twitter muestran cuando pegas una URL. Envía cualquier URL y recibe de vuelta un JSON limpio con el título de la página, la descripción, la imagen de vista previa, el nombre del sitio y el favicon.
Cómo funciona: la API obtiene la página del lado del servidor y lee primero las etiquetas OpenGraph, luego las etiquetas de Twitter Card, y finalmente recurre a HTML simple (, descripción meta), así que obtienes resultados útiles incluso de páginas sin etiquetas sociales. Las obtenciones son seguras contra SSRF (direcciones privadas/internas bloqueadas), con límites de tamaño y tiempo, y los resultados se pueden almacenar en caché durante una hora.
Puntos finales: GET /preview?url=... para una URL; POST /preview/batch para hasta 10 URLs en una sola llamada. Los errores utilizan JSON estándar de detalles del problema con códigos claros legibles por máquina.
Construido para: aplicaciones de chat y mensajería, CMS, programadores sociales, herramientas de lectura posterior, foros — en cualquier lugar donde un enlace pegado deba convertirse en una tarjeta.
El endpoint GET /preview devuelve una tarjeta de vista previa rica que contiene el título la descripción la imagen el nombre del sitio el favicon y la URL del enlace proporcionado El endpoint POST /preview/batch devuelve datos similares para hasta 10 URLs en un formato estructurado lo que permite el procesamiento por lotes de las vistas previas de enlaces
Los campos clave en los datos de respuesta incluyen "título" "descripción" "imagen" "nombreDelSitio" "favicon" y "url" Estos campos proporcionan información esencial sobre la página vinculada lo que permite a los usuarios crear vistas previas enriquecidas
Los datos de respuesta están organizados en formato JSON Para el endpoint GET devuelve un único objeto con campos para la vista previa del enlace El endpoint POST devuelve un objeto que contiene un array de "resultados" donde cada entrada corresponde a una URL e incluye sus respectivos datos de vista previa
Cada punto final proporciona información como el título de la página la descripción la imagen de vista previa el nombre del sitio el favicon y la URL original Estos datos ayudan a los usuarios a generar vistas previas de enlaces visualmente atractivas para diversas aplicaciones
Los usuarios pueden personalizar sus solicitudes especificando el parámetro de URL en la solicitud GET o proporcionando un array de URLs en la solicitud POST Esta flexibilidad permite a los usuarios recuperar vistas previas para enlaces específicos o múltiples enlaces en una sola llamada
La API obtiene datos de la página web objetivo leyendo etiquetas OpenGraph etiquetas de Twitter Card y descripciones meta en HTML Este enfoque de múltiples fuentes asegura que los usuarios reciban información relevante incluso si faltan algunas etiquetas
Los casos de uso típicos incluyen generar vistas previas de enlaces para aplicaciones de chat y mensajería, sistemas de gestión de contenido, programadores de redes sociales y foros. Esta funcionalidad mejora la experiencia del usuario al proporcionar un contexto visual enriquecido para los enlaces compartidos
Si una URL devuelve resultados parciales o vacíos, la API aún proporcionará los campos disponibles, como el nombre del sitio y el favicon. Los usuarios pueden implementar lógica de respaldo en sus aplicaciones para manejar estos casos de manera elegante, asegurando una experiencia de usuario consistente