OG-Image API
Die Link-Vorschau, die den Preis kennt.
Jede Produkt- und Objektseite hat ein OG-Image, ob sie will oder nicht — leer, wenn niemand eines gesetzt hat. ListingShot setzt es aus denselben Daten wie den Instagram-Post: 1200 × 630, Titel, Preis und Angaben als Text, in Ihrer Markenfarbe. Drei Wege, je nachdem, woher die Daten kommen.
Das Wichtigste in Sätzen
- Das Format heißt og-wide, misst 1200 × 630 und entsteht aus demselben Datensatz wie alle anderen Formate.
- Drei Wege: ein Aufruf an die API, die feste Adresse einer Zeile Ihres Bestands, oder eine signierte Adresse ohne Schlüssel.
- Die feste Adresse ändert sich nie; die Grafik dahinter folgt jeder Prüfung des Bestands.
- Die Grafik kostet nichts. Bezahlt wird der Datensatz, wenn wir ihn zuordnen oder auslesen.
Weg 1: ein Aufruf
Die Felder rein, die Bild-Adresse raus. Für eine Produktseite mit dem eingebauten Produktformular:
POST https://api.listing-shot.com/v1/images Authorization: Bearer ls_live_… { "template": "og-wide", "form": "product", "values": { "title": "Wanderschuh Alpin Pro GTX", "price": "199,95 €", "brand": "Nordwerk", "photo": "https://…/schuh.jpg" } } # → { "image_url": "/images/….png", "svg_url": "/images/….svg", "render_ms": 290 }
Weg 2: die feste Adresse eines Bestands
Ist Ihr Bestand angeschlossen, hat jede Zeile je Format eine Adresse, die sich nie ändert. Sie steht einmal im Kopf Ihrer Seite und muss nie wieder angefasst werden:
<meta property="og:image"
content="https://listing-shot.com/b/feed_…/NW-0451/og-wide.png">
# Ändert sich der Preis in Ihrer Liste, liegt nach der nächsten Prüfung
# die neue Grafik hinter derselben Adresse — mit neuem ETag. Weg 3: die signierte Adresse
Für Seiten ohne Bestand: die Felder stehen in der Adresse, eine Signatur mit Ihrem Geheimnis macht sie gültig, kein Schlüssel wandert in die Seite. Beim ersten Abruf wird gerendert, danach ist es eine Datei.
https://listing-shot.com/s/acc_…/og-wide.png ?form=product&title=Wanderschuh%20Alpin%20Pro%20GTX&price=199%2C95%20%E2%82%AC &sig=…64 Hex-Zeichen… # Das Rezept für die Signatur steht unter /api#signierte-adresse.
Häufige Fragen
Welche Größe hat ein OG-Image?
1200 × 630 Pixel, Seitenverhältnis 1,91 : 1. Das ist die Größe, die Facebook, LinkedIn, WhatsApp, Slack und die meisten Messenger für die Link-Vorschau lesen; ListingShot setzt genau diese Größe als Format og-wide, mit Preis und Angaben als Text.
Darf auf dem OG-Image Text stehen?
Ja. Die Link-Vorschau gehört zu Ihrer eigenen Seite, und die Regeln für Anzeigenbilder und Portalfotos gelten dort nicht. Preis, Titel und Ort auf der Vorschau sind das, was den Klick bringt. Wo Text auf Bildern nicht erlaubt ist, steht mit Quelle unter listing-shot.com/text-auf-bildern.
Ändert sich das Bild, wenn sich der Preis ändert?
Über die feste Adresse eines angeschlossenen Bestands ja: die Adresse bleibt, dahinter liegt nach jeder Prüfung die neueste Grafik, mit neuem ETag. Eine signierte Adresse ist dagegen eine bestimmte Grafik: andere Felder, andere Adresse. Die Plattformen halten Vorschauen eine Weile im Cache; das ist ihr Verhalten, nicht unseres.
Was kostet ein OG-Image?
Die Grafik nichts, wie jede Grafik. Bezahlt wird nur ein Datensatz, den wir für Sie zuordnen oder auslesen: 4 ct aus strukturierten Daten, 20 ct aus Text oder Link. Ein Aufruf an /v1/images mit fertigen Feldern kostet nichts.