vmarktAPI

Hier finden Sie alle Schnittstellenbeschreibungen unserer öffentlichen APIs. Teilweise können die APIs nur unter bestimmten Voraussetzungen angesprochen werden. Die Einschränkungen finden Sie in der jeweiligen Schnittstellenbeschreibung.

Allgemeine Informationen
Abrufen von Bildinformationen
Abrufen von SMTP-Zugangsdaten
QR-Code Generierung
Abrufen von Bewertungen
Generierung Bildbeschreibungen (ALT-Texte)

Allgemeine Informationen

Adresse

Sämtliche Schnittstellen sind unter folgender URL erreichbar:

https://api.versicherungsmarkt.de/{API-NAME}/{API-Type}?optionale_parameter=xyz

Im Header sind zudem je nach API folgende Angaben mitzusenden:

Apikey (erhalten Sie von versicherungsmarkt.de)
Makler (Ihre Makler-ID bei versicherungsmarkt.de)

Beispiel-Aufruf in PHP

Wir empfehlen zum Abruf der API eine serverseitige Lösung mit PHP.
Ein Beispiel-Skript könnte wie folgt aussehen:

<?php
//Angaben im Header
$header = array(
  'Apikey: ' . $MEIN_API_KEY,
  'makler: ' . $MEINE_MAKLER_ID,
);
//Zusätzliche Parameter
$parameter = array(
  'optionaler_parameter' => 'optionaler_wert'
);

// Connect API
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.versicherungsmrkt.de/NAME_DER_API/TYPE_DES_AUFRUFS");
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($parameter));
$result = curl_exec($ch);
$result = json_decode($result, true);
curl_close($ch);
?>

Antwort

Alle Schnittstellen liefern stets eine Antwort im JSON-Format.
Die Antworten unterscheiden sich im Erfolgs- bzw. Fehlerfall.

Erfolgsfall

Rückgabewerte im Erfolgsfall:

{
`success`: true,
`data`: {
//Objekt mit den Ergebnis-Daten
`bezeichnung`: `wert‘,
//usw.
}
}

Fehlerfall

Rückgabewerte im Fehlerfall:

{
`success`: false,
`error`: [
"Fehlermeldung als String"
]
}

Abrufen von Bildinformationen

Beschreibung

Diese Schnittstelle liefert Ihnen Informationen zu Stock-Photos. Zurückgegeben werden die Bildnummer, der Bildtitel und der Urheber des Fotos.

Unterstützt werden aktuell die folgenden Bildagenturen:

AdobeStock
iStockPhoto
Pixabay

Hinweis: Seit Oktober 2025 wird ClipDealer nicht mehr unterstützt.

Einsatzzweck

Diese API kann Sie dabei unterstützen die notwendigen Angaben zu erworbenen Bildlizenzen automatisch zu erstellen.

Voraussetzungen/Einschränkungen

Diese API kann nur von unseren Kunden mit einem gültigen Content- und Wartungsvertrag verwendet werden.
Der Zugriff ist nur von authorisierten Domains zugelassen.

Aufruf

API Name	license
API Type	Name der Bildagentur

Eingabeparameter

Parameter	Format	Pflicht	Erläuterung
makler	Integer	Ja	Ihre Makler-ID bei versicherungsmarkt.de
filenumber	String	Ja	Die Bildnummer, die Sie abfragen möchten

Ausgabeparameter

Parameter	Format	Erläuterung
date	Timestamp	Datum, wann diese Bildnummer erstmals über die API erfragt wurde
filenumber	Text	Bildnummer
dealer	Text	Bildagentur
title	Text	Name des Fotos
creator	Text	Name des Urhebers

Beispiel-Aufruf

https://api.versicherungsmarkt.de/license/AdobeStock?filenumber=670402021

Beispiel-Antwort

{
  "success": true,
  "data": {
    "date": "2024-11-19 10:05:00",
    "bildnr": "670402021",
    "dealer": "AdobeStock",
    "title": "Newspaper Advertising Banner on Magazine, Brochure Mockup 3D Rendering",
    "creator": "Khaled"
  }
}

Abrufen von SMTP-Zugangsdaten

Beschreibung

Diese Schnittstelle liefert Ihnen die SMTP-Zugangsdaten zum zentralen noreply-Postfach für den automatischen Versand von Formularen.

Einsatzzweck

Automatischer Versand von Kontaktformularen.

Voraussetzungen/Einschränkungen

Diese API kann nur von unseren Kunden mit einem gültigen Content- und Wartungsvertrag verwendet werden.
Der Zugriff ist nur von authorisierten Domains zugelassen.

Aufruf

API Name	smtp
API Type	credentials

Eingabeparameter

Parameter	Format	Pflicht	Erläuterung
makler	Integer	Ja	Ihre Makler-ID bei versicherungsmarkt.de

Ausgabeparameter

Parameter	Format	Erläuterung
email	Text	E-Mail-Adresse (noreply)
host	Text	Hostname
port	Text	Portnummer
encryption	Text	Verschlüsselungsmethode
username	Text	Benutzername
passsword	Text	Passwort

Beispiel-Aufruf

https://api.versicherungsmarkt.de/smtp/credentials

Beispiel-Antwort

{
  "success": true,
  "data": {
    "email": "noreply@versicherungsmarkt.de",
    "host": ".....",
    "port": "587",
    "encryption": "tls",
    "username": ".....",
    "password": "....."
  }
}

QR-Code Generierung

Beschreibung

Diese Schnittstelle erzeugt einen QR-Code zu den angebenen Optionen.

Voraussetzungen/Einschränkungen

Diese API kann nur von unseren Kunden mit einem gültigen Content- und Wartungsvertrag verwendet werden.
Der Zugriff ist nur von authorisierten Domains zugelassen.

Aufruf

API Name	qrcode
API Type	"svg" oder "png"

Eingabeparameter

Parameter	Format	Pflicht	Erläuterung
url	String	Ja	Angabe der Ziel-URL
image	String	Nein	Pfad zu einer Bilddatei für den QR-Code (Logo in der Mitte)
label	String	Nein	Text unterhalb des QR-Codes

Ausgabeparameter

Parameter	Format	Erläuterung
base64	Text	Base64-Daten des QR-Codes (Bilddatei)

Beispiel-Aufruf

https://api.versicherungsmarkt.de/qrcode/svg

Beispiel-Antwort

{
  "success": true,
  "data": {
    "base64": "..."
  }
}

Abrufen von Bewertungen

Beschreibung

Diese Schnittstelle liefert Ihnen alle abgegebene Bewertungen zu Ihren Online-Profilen.

Unterstützt werden aktuell die folgenden Profile/Quellen:

Quelle	Kurzbezeichnung
Google Maps	google
versicherungsmarkt rating	vmarkt

Einsatzzweck

Um Bewertungen direkt auf Ihrer Homepage anzeigen zu lassen, ohne dabei Verbindungen zu externen Diensten herstellen zu müssen.

Voraussetzungen/Einschränkungen

Diese API kann nur von unseren Kunden mit einem gültigen Content- und Wartungsvertrag verwendet werden.
Der Zugriff ist nur von authorisierten Domains zugelassen.

Für den Abruf der Bewertungen von externen Quellen (nicht vmarkt rating), müssen Sie uns vorab Ihre Profil-URL zukommen lassen.

Aufruf

API Name

review

API Type

Name der Quelle, unterstützt sind:

all
google
vmarkt

Eingabeparameter

Parameter	Format	Pflicht	Erläuterung
makler	Integer	Ja	Ihre Makler-ID bei versicherungsmarkt.de

Ausgabeparameter

Parameter	Format	Erläuterung
last_update	Timestamp	Datum, wann die Bewertungen zuletzt aktualisiert wurden
totalScore	Float	Gesamtdurchschnitt aller Bewertungen
reviewsCount	Integer	Gesamtanzahl aller Bewertungen
reviews	Objekt	Array mit allen gefundenen Bewertungen

Beispiel-Aufruf

https://api.versicherungsmarkt.de/reviews/google

Beispiel-Antwort

{
  "success": true,
  "data": {
    "last_update": "2026-01-14 15:36:20",
    "totalScore": 5,
    "reviewsCount": 3,
    "reviews": [
      {
        "source": "google",
        "reviewId": "ChZDSUhNMG9nS0VJQ0FnTUNRMVoyUkJBEAE",
        "author": "HuntingGang",
        "rating": "5",
        "text": "Top Firma, macht weiter so!",
        "published": "2025-03-06 10:58:31",
        "reviewUrl": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChZDSUhNMG9nS0VJQ0FnTUNRMVoyUkJBEAE!2m1!1s0x0:0x7beb94b9828fef4!3m1!1s2@1:CIHM0ogKEICAgMCQ1Z2RBA%7CCgwI1_-lvgYQ4LWEiwI%7C?hl=de"
      },
      {
        "source": "google",
        "reviewId": "ChZDSUhNMG9nS0VJQ0FnTUNRNmZfQ0xBEAE",
        "author": "Armstorf",
        "rating": "5",
        "text": "",
        "published": "2025-03-05 17:01:07",
        "reviewUrl": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChZDSUhNMG9nS0VJQ0FnTUNRNmZfQ0xBEAE!2m1!1s0x0:0x7beb94b9828fef4!3m1!1s2@1:CIHM0ogKEICAgMCQ6f_CLA%7CCgwI04aivgYQ4Oj-sAI%7C?hl=de"
      },
      {
        "source": "google",
        "reviewId": "ChZDSUhNMG9nS0VJQ0FnSUN3bFplOWV3EAE",
        "author": "Torsten Bauer",
        "rating": "5",
        "text": "",
        "published": "2023-12-13 18:26:43",
        "reviewUrl": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChZDSUhNMG9nS0VJQ0FnSUN3bFplOWV3EAE!2m1!1s0x0:0x7beb94b9828fef4!3m1!1s2@1:CIHM0ogKEICAgICwlZe9ew%7CCgsI4-7nqwYQ-JSbGg%7C?hl=de"
      }
    ]
  }
}

Generierung Bildbeschreibungen (ALT-Texte)

Beschreibung

Diese Schnittstelle erstellt automatisiert einen deutschen, SEO-konformen ALT-Text für ein übergebenes Bild.

Der ALT-Text beschreibt konkret, was auf dem Bild sichtbar ist, und wird auf maximal 125 Zeichen begrenzt.

Einsatzzweck

Diese API kann Sie dabei unterstützen, Bilder automatisiert mit passenden ALT-Texten zu versehen. Dies verbessert die Barrierefreiheit und kann die Suchmaschinenoptimierung von Webseiten unterstützen.

Voraussetzungen/Einschränkungen

Diese API kann nur von unseren Kunden mit einem gültigen Content- und Wartungsvertrag verwendet werden.
Der Zugriff ist nur von authorisierten Domains zugelassen.

Der ALT-Text wird automatisiert KI-gestützt erstellt. Die Ausgabe sollte bei sensiblen oder rechtlich relevanten Inhalten geprüft werden.

Aufruf

API Name	alttext
API Type	image
HTTP-Methode	POST

Header-Parameter

Parameter	Format	Pflicht	Erläuterung
makler	Integer	Ja	Ihre Makler-ID bei versicherungsmarkt.de
Apikey	String	Ja	Ihr API-Schlüssel für den Zugriff auf die Schnittstelle
Content-Type	String	Ja	Muss auf `application/json` gesetzt werden

Eingabeparameter im POST-Body

Parameter	Format	Pflicht	Erläuterung
image	String	Ja	Das Bild als Data-URL im Format `data:image/...;base64,...`

Ausgabeparameter

Parameter	Format	Erläuterung
altText	Text	Der generierte deutsche ALT-Text für das übergebene Bild.

Beispiel-Aufruf

https://api.versicherungsmarkt.de/alttext/image

Beispiel-Header

makler: 7661
Apikey: XXXXXXXXX
Content-Type: application/json

Beispiel-POST-Body

{
  "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD..."
}

Beispiel-Antwort

{
  "success": true,
  "data": {
    "altText": "Roter Kleinwagen vor Einfamilienhaus mit gepflegtem Vorgarten"
  }
}

Beispiel-Fehlerantwort

{
  "success": false,
  "error": [
    "Kein Bild übergeben"
  ]
}