Für Entwickler
Eine API, die aussieht wie erwartet.
Template plus Modifications — dasselbe Muster, das Sie von Bannerbear kennen. Die Antwort ist synchron, das Bild liegt nach rund 0,3 Sekunden bereit, und abgerechnet wird pro Objekt statt pro Bild: Jedes weitere Format kostet nichts.
Das Wichtigste in Sätzen
- Ein POST auf
/v1/imagesmit Vorlage und Modifications gibt synchron die URL der fertigen Grafik zurück. - Abgerechnet wird pro Objekt, nicht pro Bild — 6 Formate je Objekt kosten so viel wie eines.
- Preis, Fläche und Ort werden als echter Text gesetzt, nicht von einem Bildmodell gemalt; eine Ziffer kann darum nicht abweichen.
- Passt der Text nicht, wird in einer festgelegten Reihenfolge reduziert, und die Antwort sagt, welche Stufe griff.
- Jedes Rendering gibt es als PNG zum Hochladen und als SVG mit Schrift in Pfaden, für Druck und jede Größe.
Ein Aufruf
# Objektdaten rein, Bild raus curl -X POST https://api.listing-shot.com/v1/images \ -H "Authorization: Bearer ls_live_…" \ -H "Content-Type: application/json" \ -d '{ "template": "ig-post", "modifications": [ { "name": "title", "text": "Altbauwohnung mit Balkon" }, { "name": "price", "text": "€ 685.000" }, { "name": "location", "text": "Leipzig-Südvorstadt" }, { "name": "photo", "image_url": "https://…/objekt.jpg" }, { "name": "brand_color", "color": "#0B5D4E" } ] }' # → { "status": "completed", "image_url": "/images/…png", # "render_ms": 312, "usage": { "images_this_month": 12 } }
Endpunkte
| Methode | Pfad | Wofür |
|---|---|---|
| POST | /v1/images | Eine Grafik rendern. Synchron, Antwort enthält die Bild-URL. |
| POST | /v1/ingest | Exposé-Text, PDF oder Foto einlesen und die Felder erkennen. |
| POST | /v1/imports | Massenimport aus CSV oder einer Objektliste, über eine Warteschlange. |
| GET | /v1/templates | Die 6 Formate mit Maßen und Feldern. |
| POST | /v1/arrangements | Dieselben Angaben in jeder Anordnung, gemessen und sortiert. |
| POST | /v1/styles/derive | Farben, Formensprache und Anordnung aus einem Referenzbild lesen. |
| GET | /v1/account | Guthaben und Verbrauch. |
Was Sie herunterladen
Jedes Rendering entsteht zweimal: als Rasterbild und als Vektor. Nicht als Konvertierung des einen ins andere — beide kommen aus demselben Satz, mit denselben Maßen und derselben Zeile Text an derselben Stelle.
| Datei | Wofür | Größe, gemessen |
|---|---|---|
| .png | Zum Hochladen bei Instagram, Facebook, WhatsApp. Verlustfrei, überall akzeptiert. | 1,1 MB · 1080×1080 |
| .svg | Für Druck und jede Größe. Die Schrift liegt als Pfad vor, also scharf, ohne dass eine Schriftart installiert sein muss. Der Grund, warum ein A4-Aushang als Format überhaupt Sinn ergibt. | 308 KB · beliebig skalierbar |
Die Antwort auf /v1/images nennt beide:
image_url für das PNG, svg_url für den Vektor.
Abrechnung
Die Einheit ist das Objekt, nicht die Datei. Ein Inserat braucht 6 Formate; wer pro Bild abrechnet, macht das vierte davon zu einer Entscheidung — und die fällt regelmäßig gegen das Format aus. Was das in Zahlen bedeutet, steht im Beitrag Was kostet ein Bild?
- 5 ct je Objekt aus Exposé, PDF oder Link
- 1 ct je Objekt aus strukturierten Daten
- kostenlos jedes Rendering, in jedem Format, beliebig oft
- Kein Abo, keine Grundgebühr, Guthaben verfällt nicht
Was die API nicht tut
Sie erzeugt keine Fotos. Das Bild kommt von Ihnen oder aus Ihrem Datensatz; wir setzen es zusammen mit den Angaben. Und sie erzeugt keine Videos — dafür gibt es Anbieter in dieser Kategorie, wir sind keiner davon. Warum die Trennung zwischen erzeugtem Bild und gesetztem Text die tragende ist, steht im Beitrag KI schreibt gute Anzeigen und schlechte Zahlen.
Häufige Fragen
Wie funktioniert die ListingShot-API?
Ein POST auf /v1/images mit einer Vorlagen-Kennung und einer Liste von Modifications — je Feld ein Name und ein Wert. Die Antwort kommt synchron und enthält die URL des fertigen Bildes. Das ist dasselbe Muster, das Bannerbear und ähnliche Dienste verwenden; ein Wechsel ist ein Nachmittag, kein Projekt.
Wird pro Bild oder pro Objekt abgerechnet?
Pro Objekt. Ein Objekt aus Exposé, PDF oder Link kostet 5 ct, ein Objekt aus strukturierten Daten 1 ct. Jedes Rendering ist kostenlos, in allen 6 Formaten und beliebig oft. Wer pro Bild abrechnet, macht jedes weitere Format zu einer Kaufentscheidung — bei uns ist es ein Häkchen.
Wie schnell antwortet die API?
Ein einzelnes Rendering dauert etwa 0,3 Sekunden — gemessen zwischen 0,18 und 0,36 Sekunden über achtzehn Grafiken in sechs Formaten. Es fällt keine Bilderzeugung und keine GPU an: die Grafik wird gesetzt, nicht generiert. Eine vollständige Kampagne aus drei Formaten ist typischerweise in unter zwei Sekunden fertig.
Was passiert bei einem zu langen Titel?
Die Grafik wird in einer festgelegten Reihenfolge reduziert: erst das unwichtigste Detail weggelassen, dann die Details verkleinert bis zu einer Untergrenze, zuletzt die Überschrift gekürzt. Die Antwort sagt, welche Stufe gegriffen hat. Kein Text läuft aus dem Bild, und keine Grafik wird stillschweigend unbrauchbar.
Gibt es einen Massenimport?
Ja. Ein POST auf /v1/imports nimmt eine CSV oder eine Liste von Objekten entgegen und arbeitet sie über eine Warteschlange ab; der Status ist über /v1/imports/{id} abrufbar. Vierhundert Zeilen sind ein Aufruf, kein Skript mit vierhundert Aufrufen.
In welchen Dateiformaten bekomme ich die Grafiken?
Als PNG und als SVG, aus demselben Satz erzeugt statt ineinander umgerechnet. Das PNG laden Sie bei Instagram oder Facebook hoch — ein Post mit 1080×1080 wiegt rund 1,1 MB. Das SVG trägt die Schrift als Pfade, ist damit in jeder Größe scharf und braucht keine installierte Schriftart; deshalb ergibt der A4-Aushang als Format überhaupt Sinn. Die Antwort auf /v1/images nennt beide URLs.
Wie erhalte ich einen API-Schlüssel?
Über das Zugangsformular. Sie erhalten einen Schlüssel und Startguthaben; es gibt kein Abonnement und keine Grundgebühr. Die API ist derzeit für angemeldete Konten freigeschaltet.