Ir al contenido
POST AI agent ready /v1/social-preview/extract

API de vista previa social: extraiga metaetiquetas de tarjetas de Twitter y Open Graph

Obtiene una URL y extrae etiquetas Open Graph (og:title, og:description, og:image, og:type, og:site_name), etiquetas de Twitter Card (twitter:card, twitter:title, twitter:image, twitter:site, twitter:creator) y metadatos HTML generales (título, descripción, canónico, favicon). Devuelve advertencias sobre etiquetas faltantes o con formato incorrecto.

Parameters

stringrequired

URL to extract social preview metadata from.

Code examples

curl -X POST https://api.botoi.com/v1/social-preview/extract \
  -H "Content-Type: application/json" \
  -d '{"url":"https://github.com"}'

When to use this API

Vincular tarjetas de vista previa en plataformas de chat y CMS

Cuando un usuario pega una URL en su aplicación, llame a este punto final para obtener los datos de Open Graph y generar una tarjeta de vista previa de enlace enriquecida con título, descripción e imagen. Funciona para desplegar enlaces estilo Slack.

Auditoría SEO para compartir en redes sociales

Escanee sus páginas para verificar que las etiquetas Open Graph y Twitter Card estén presentes y formateadas correctamente. Descubra las etiquetas og:image faltantes o las descripciones truncadas antes de que se publiquen las campañas para compartir.

Enriquecimiento del sistema de gestión de contenidos

Cuando los editores agregan enlaces externos a los artículos, completan automáticamente el título, la descripción y la miniatura del enlace a partir de los metadatos extraídos. Guarda la entrada de datos manual y mantiene consistentes las tarjetas de vista previa.

Frequently asked questions

¿Qué sucede si la página no tiene etiquetas Open Graph?
La sección og devuelve valores nulos para las etiquetas que faltan. La sección general vuelve a las etiquetas HTML <title> y <meta name="description">. Se agrega una advertencia por cada etiqueta OG que falta.
¿Esto sigue las redirecciones?
Sí. El punto final sigue hasta 5 redirecciones y extrae metadatos de la URL de destino final.
¿Puedo extraer metadatos de páginas que requieren JavaScript?
No. El punto final recupera la respuesta HTML sin formato. Las aplicaciones de una sola página que inyectan etiquetas OG a través de JavaScript devolverán metadatos incompletos. Las páginas renderizadas por el servidor funcionan correctamente.
¿Cuáles son las advertencias comunes que se devuelven?
Las advertencias incluyen og:título faltante, og:imagen faltante, og:descripción de más de 200 caracteres, etiquetas de tarjeta de Twitter faltantes y URL de og:imagen que devuelven tipos de contenido que no son imágenes.
¿Está validada la URL de og:image?
El punto final devuelve la URL og:image tal cual desde el HTML. No busca la imagen para verificar que existe ni comprobar sus dimensiones. Utilice una solicitud HEAD separada para validar la URL de la imagen.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.