Ir al contenido
POST AI agent ready /v1/url-metadata

API de metadatos de URL: extraiga gráficos abiertos, títulos y favicon

Obtiene una URL y extrae título, descripción, etiquetas Open Graph, etiquetas de Twitter Card, favicon, URL canónica, idioma, autor, palabras clave y color del tema. Útil para vistas previas de enlaces y uso compartido en redes sociales.

Parameters

stringrequired

Full URL to fetch and extract metadata from.

Code examples

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

When to use this API

Genere vistas previas de enlaces enriquecidas en una aplicación de chat

Cuando un usuario pega una URL en un mensaje de chat, llame a este punto final para obtener el título, la descripción y la imagen OG. Muestra una tarjeta de vista previa debajo del mensaje, similar a cómo se despliega el enlace de visualización de Slack o Discord.

Valide las etiquetas OG antes de publicar contenido

Antes de compartir una publicación de blog en las redes sociales, extraiga sus etiquetas OG para confirmar que el título, la descripción y la imagen sean correctos. Detecte metadatos faltantes o truncados antes de que se publiquen en Twitter, LinkedIn o Facebook.

Cree un administrador de marcadores con metadatos automáticos

Cuando un usuario guarda una URL en su colección de favoritos, completa automáticamente el título, la descripción y la miniatura de los metadatos extraídos. Evite que el usuario ingrese manualmente detalles para cada marcador.

Frequently asked questions

¿Este punto final sigue redirecciones?
Sí. El punto final sigue las redirecciones HTTP y extrae metadatos de la URL de destino final. El campo de estado refleja el estado HTTP de la respuesta final.
¿Cuál es la diferencia entre los campos og y twitter?
og contiene metaetiquetas Open Graph (utilizadas por Facebook, LinkedIn y otros). Twitter contiene etiquetas de tarjetas de Twitter. Muchos sitios configuran ambas, pero las etiquetas de Twitter Card tienen prioridad en Twitter/X cuando ambas están presentes.
¿Puedo extraer metadatos de aplicaciones de una sola página?
El punto final recupera la respuesta HTML inicial sin ejecutar JavaScript. Si un SPA muestra sus metaetiquetas en el lado del cliente, esas etiquetas no aparecerán en la respuesta.
¿Existe un tiempo de espera para las URL lentas?
Sí. El tiempo de espera del punto final se agota después de 10 segundos si la URL de destino no responde. Un tiempo de espera devuelve un error 400 con un mensaje descriptivo.
¿Qué contiene el campo canónico?
El campo canónico contiene el valor de la etiqueta <link rel="canonical">, que indica la URL preferida para una página. Esto le ayuda a deduplicar las URL que muestran el mismo contenido.

Get your API key

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

Sign up free View full docs