POST AI agent ready /v1/url-metadata

URL-Metadaten-API – Offenes Diagramm, Titel und Favicon extrahieren

Ruft eine URL ab und extrahiert Titel, Beschreibung, Open Graph-Tags, Twitter Card-Tags, Favicon, kanonische URL, Sprache, Autor, Schlüsselwörter und Designfarbe. Nützlich für Linkvorschauen und Social Sharing.

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

Generieren Sie Rich-Link-Vorschauen in einer Chat-App

Wenn ein Benutzer eine URL in eine Chat-Nachricht einfügt, rufen Sie diesen Endpunkt auf, um den Titel, die Beschreibung und das OG-Bild abzurufen. Rendern Sie eine Vorschaukarte unter der Nachricht, ähnlich wie der Anzeigelink in Slack oder Discord angezeigt wird.

Validieren Sie OG-Tags, bevor Sie Inhalte veröffentlichen

Bevor Sie einen Blog-Beitrag in sozialen Medien teilen, extrahieren Sie dessen OG-Tags, um sicherzustellen, dass Titel, Beschreibung und Bild korrekt sind. Erkennen Sie fehlende oder abgeschnittene Metadaten, bevor sie auf Twitter, LinkedIn oder Facebook live geschaltet werden.

Erstellen Sie einen Lesezeichen-Manager mit automatischen Metadaten

Wenn ein Benutzer eine URL in seiner Lesezeichensammlung speichert, werden Titel, Beschreibung und Miniaturansicht automatisch aus den extrahierten Metadaten ausgefüllt. Ersparen Sie dem Benutzer die manuelle Eingabe von Details für jedes Lesezeichen.

Frequently asked questions

Folgt dieser Endpunkt Weiterleitungen?

Ja. Der Endpunkt folgt HTTP-Weiterleitungen und extrahiert Metadaten aus der endgültigen Ziel-URL. Das Statusfeld spiegelt den HTTP-Status der endgültigen Antwort wider.

Was ist der Unterschied zwischen OG- und Twitter-Feldern?

og enthält Open Graph-Meta-Tags (verwendet von Facebook, LinkedIn und anderen). Twitter enthält Twitter-Card-Tags. Viele Websites legen beide fest, aber Twitter-Karten-Tags haben auf Twitter/X Vorrang, wenn beide vorhanden sind.

Kann ich Metadaten aus Single-Page-Apps extrahieren?

Der Endpunkt ruft die erste HTML-Antwort ab, ohne JavaScript auszuführen. Wenn ein SPA seine Meta-Tags clientseitig rendert, werden diese Tags nicht in der Antwort angezeigt.

Gibt es eine Zeitüberschreitung für langsame URLs?

Ja. Der Endpunkt läuft nach 10 Sekunden ab, wenn die Ziel-URL nicht antwortet. Eine Zeitüberschreitung gibt einen 400-Fehler mit einer beschreibenden Meldung zurück.

Was enthält das kanonische Feld?

Das kanonische Feld enthält den Wert des <link rel="canonical">-Tags, der die bevorzugte URL für eine Seite angibt. Dies hilft Ihnen, URLs zu deduplizieren, die denselben Inhalt bereitstellen.

Get your API key

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