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

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:

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:

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"
      }
    ]
  }
}