POST AI agent ready /v1/social-preview/extract

API Social Preview - Extraire les balises méta du graphique ouvert et de la carte Twitter

Récupère une URL et extrait les balises Open Graph (og:title, og:description, og:image, og:type, og:site_name), les balises Twitter Card (twitter:card, twitter:title, twitter:image, twitter:site, twitter:creator) et les métadonnées HTML générales (titre, description, canonique, favicon). Renvoie des avertissements pour les balises manquantes ou mal formées.

Endpoint

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

Lier les cartes d'aperçu dans les plateformes de chat et CMS

Lorsqu'un utilisateur colle une URL dans votre application, appelez ce point de terminaison pour récupérer les données Open Graph et afficher une carte d'aperçu de lien enrichi avec titre, description et image. Fonctionne pour le déploiement de liens de style Slack.

Audit SEO pour le partage social

Scannez vos pages pour vérifier que les balises Open Graph et Twitter Card sont présentes et correctement formatées. Repérez les balises og:image manquantes ou les descriptions tronquées avant la mise en ligne des campagnes de partage.

Enrichissement du système de gestion de contenu

Lorsque les éditeurs ajoutent des liens externes aux articles, remplissez automatiquement le titre, la description et la vignette du lien à partir des métadonnées extraites. Enregistre la saisie manuelle des données et maintient la cohérence des cartes d'aperçu.

Frequently asked questions

Que se passe-t-il si la page ne contient aucune balise Open Graph ?

La section og renvoie des valeurs nulles pour les balises manquantes. La section générale revient aux balises HTML <title> et <meta name="description">. Un avertissement est ajouté pour chaque balise OG manquante.

Est-ce que cela suit les redirections ?

Oui. Le point de terminaison suit jusqu'à 5 redirections et extrait les métadonnées de l'URL de destination finale.

Puis-je extraire des métadonnées de pages nécessitant JavaScript ?

Non. Le point de terminaison récupère la réponse HTML brute. Les applications d'une seule page qui injectent des balises OG via JavaScript renverront des métadonnées incomplètes. Les pages rendues par le serveur fonctionnent correctement.

Quels sont les avertissements courants renvoyés ?

Les avertissements incluent og:title manquant, og:image manquant, og:description de plus de 200 caractères, balises de carte Twitter manquantes et URL og:image qui renvoient des types de contenu non-image.

L'URL og:image est-elle validée ?

Le point de terminaison renvoie l'URL og:image telle quelle à partir du code HTML. Il ne récupère pas l'image pour vérifier qu'elle existe ou vérifier ses dimensions. Utilisez une requête HEAD distincte pour valider l’URL de l’image.

Get your API key

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