Service 02

OpenGraph / Link Preview API

Die OpenGraph API liest Metadaten einer Webseite aus und baut daraus eine verwendbare Link-Preview. Neben OpenGraph werden auch HTML-Titel, Meta Description, Twitter Cards, Canonical-URL, Favicon und JSON-LD-Blöcke berücksichtigt.

Endpoint

GET /api/v1/opengraph?url=https://example.com

Beispiel-Request

curl -H "X-API-Key: dein-api-hub-key" "https://cyber.zap.cloud/api/v1/opengraph?url=https%3A%2F%2Fexample.com"

Beispiel-Response

{"ok":true,"data":{"url":"https://example.com","title":"Example Domain","description":"...","type":"website","canonical":"https://example.com/","favicon":"https://example.com/favicon.ico","quality":{"score":80,"missing":["og:image"]}}}

Parameter

NameTypPflichtBeschreibung
url string ja Vollständige Ziel-URL inklusive http:// oder https://.
refresh boolean nein Mit refresh=1 wird ein neuer Abruf erzwungen und ein vorhandener Cache ignoriert.