POST AI agent ready /v1/url-metadata

API de métadonnées d'URL - Extraire le graphique ouvert, le titre et le favicon

Récupère une URL et extrait le titre, la description, les balises Open Graph, les balises Twitter Card, le favicon, l'URL canonique, la langue, l'auteur, les mots-clés et la couleur du thème. Utile pour les aperçus de liens et le partage social.

Endpoint

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

Générez des aperçus de liens enrichis dans une application de chat

Lorsqu'un utilisateur colle une URL dans un message de discussion, appelez ce point de terminaison pour récupérer le titre, la description et l'image OG. Affichez une carte d'aperçu sous le message, de la même manière que le lien d'affichage Slack ou Discord se déploie.

Validez les balises OG avant de publier du contenu

Avant de partager un article de blog sur les réseaux sociaux, extrayez ses balises OG pour confirmer que le titre, la description et l'image sont corrects. Recherchez les métadonnées manquantes ou tronquées avant leur mise en ligne sur Twitter, LinkedIn ou Facebook.

Créez un gestionnaire de favoris avec des métadonnées automatiques

Lorsqu'un utilisateur enregistre une URL dans sa collection de signets, remplissez automatiquement le titre, la description et la vignette à partir des métadonnées extraites. Évitez à l'utilisateur de saisir manuellement les détails de chaque signet.

Frequently asked questions

Ce point de terminaison suit-il les redirections ?

Oui. Le point de terminaison suit les redirections HTTP et extrait les métadonnées de l'URL de destination finale. Le champ d'état reflète l'état HTTP de la réponse finale.

Quelle est la différence entre les champs og et twitter ?

og contient des balises méta Open Graph (utilisées par Facebook, LinkedIn et autres). Twitter contient des balises Twitter Card. De nombreux sites définissent les deux, mais les balises Twitter Card sont prioritaires sur Twitter/X lorsque les deux sont présentes.

Puis-je extraire des métadonnées d’applications monopage ?

Le point de terminaison récupère la réponse HTML initiale sans exécuter JavaScript. Si un SPA restitue ses balises méta côté client, ces balises n'apparaîtront pas dans la réponse.

Y a-t-il un délai d'attente pour les URL lentes ?

Oui. Le point de terminaison expire après 10 secondes si l'URL cible ne répond pas. Un délai d'attente renvoie une erreur 400 avec un message descriptif.

Que contient le champ canonique ?

Le champ canonique contient la valeur de la balise <link rel="canonical">, qui indique l'URL préférée pour une page. Cela vous aide à dédupliquer les URL qui diffusent le même contenu.

Get your API key

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