# vmarktAPI

# 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
<?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:

<p class="callout success">{  
 `success`: true,  
 `data`: {  
 //Objekt mit den Ergebnis-Daten  
 `bezeichnung`: `wert‘,  
 //usw.  
 }  
}</p>

##### Fehlerfall

Rückgabewerte im Fehlerfall:

<p class="callout warning">{  
 `success`: false,  
 `error`: \[  
 "Fehlermeldung als String"  
 \]  
}</p>

# 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

<p class="callout warning">Hinweis: Seit Oktober 2025 wird **ClipDealer** nicht mehr unterstützt.</p>

#### 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

<table border="1" id="bkmrk-api-name-loading-scr" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>**API Name**  
</td><td>license  
</td></tr><tr><td>**API Type** </td><td>*Name der Bildagentur*  
</td></tr></tbody></table>

#### Eingabeparameter

<table border="1" id="bkmrk-parameter-format-pfl" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 26.4519%;"></col><col style="width: 16.0689%;"></col><col style="width: 8.043%;"></col><col style="width: 49.5578%;"></col></colgroup><tbody><tr><td>**Parameter**  
</td><td>**Format** </td><td>**Pflicht**  
</td><td>**Erläuterung**  
</td></tr><tr><td>makler  
</td><td>Integer  
</td><td>Ja  
</td><td>Ihre Makler-ID bei versicherungsmarkt.de  
</td></tr><tr><td>filenumber  
</td><td>String  
</td><td>Ja  
</td><td>Die Bildnummer, die Sie abfragen möchten  
</td></tr></tbody></table>

#### Ausgabeparameter

<table border="1" id="bkmrk-parameter-format-fal" style="border-collapse: collapse; width: 100%; height: 522.6px;"><colgroup><col style="width: 32.3857%;"></col><col style="width: 19.9011%;"></col><col style="width: 47.7132%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="height: 29.8px;">**Parameter**  
</td><td style="height: 29.8px;">**Format** </td><td style="height: 29.8px;">**Erläuterung**  
</td></tr><tr style="height: 29.8px;"><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt; height: 29.8px;" valign="top" width="135">date

</td><td style="height: 29.8px;">Timestamp  
</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt; height: 29.8px;" valign="top" width="287">Datum, wann diese Bildnummer erstmals über die API erfragt wurde

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">filenumber

</td><td>Text  
</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Bildnummer

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">dealer

</td><td>Text  
</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Bildagentur

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">title

</td><td>Text  
</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Name des Fotos

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">creator

</td><td>Text  
</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Name des Urhebers

</td></tr></tbody></table>

#### Beispiel-Aufruf

<p class="callout info">https://api.versicherungsmarkt.de/license/AdobeStock?filenumber=670402021</p>

#### Beispiel-Antwort

```json
{
  "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

<table border="1" id="bkmrk-api-name-loading-scr" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>**API Name**  
</td><td>smtp</td></tr><tr><td>**API Type** </td><td>credentials</td></tr></tbody></table>

#### Eingabeparameter

<table border="1" id="bkmrk-parameter-format-pfl" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 26.4519%;"></col><col style="width: 16.0689%;"></col><col style="width: 8.043%;"></col><col style="width: 49.5578%;"></col></colgroup><tbody><tr><td>**Parameter**  
</td><td>**Format** </td><td>**Pflicht**  
</td><td>**Erläuterung**  
</td></tr><tr><td>makler  
</td><td>Integer  
</td><td>Ja  
</td><td>Ihre Makler-ID bei versicherungsmarkt.de  
</td></tr></tbody></table>

#### Ausgabeparameter

<table border="1" id="bkmrk-parameter-format-fal" style="border-collapse: collapse; width: 100%; height: 522.6px;"><colgroup><col style="width: 32.3857%;"></col><col style="width: 19.9011%;"></col><col style="width: 47.7132%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="height: 29.8px;">**Parameter**  
</td><td style="height: 29.8px;">**Format** </td><td style="height: 29.8px;">**Erläuterung**  
</td></tr><tr style="height: 29.8px;"><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt; height: 29.8px;" valign="top" width="135">email

</td><td style="height: 29.8px;">Text</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt; height: 29.8px;" valign="top" width="287">E-Mail-Adresse (noreply)

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">host

</td><td>Text  
</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Hostname

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">port

</td><td>Text  
</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Portnummer

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">encryption

</td><td>Text  
</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Verschlüsselungsmethode

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">username

</td><td>Text  
</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Benutzername

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">passsword

</td><td>Text</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Passwort

</td></tr></tbody></table>

#### Beispiel-Aufruf

<p class="callout info">https://api.versicherungsmarkt.de/smtp/credentials</p>

#### Beispiel-Antwort

```json
{
  "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

<table border="1" id="bkmrk-api-name-loading-scr" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>**API Name**  
</td><td>qrcode</td></tr><tr><td>**API Type** </td><td>"svg" oder "png"</td></tr></tbody></table>

#### Eingabeparameter

<table border="1" id="bkmrk-parameter-format-pfl" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 26.4519%;"></col><col style="width: 16.0689%;"></col><col style="width: 8.043%;"></col><col style="width: 49.5578%;"></col></colgroup><tbody><tr><td>**Parameter**  
</td><td>**Format** </td><td>**Pflicht**  
</td><td>**Erläuterung**  
</td></tr><tr><td>url</td><td>String</td><td>Ja  
</td><td>Angabe der Ziel-URL</td></tr><tr><td>image</td><td>String</td><td>Nein</td><td>Pfad zu einer Bilddatei für den QR-Code (Logo in der Mitte)</td></tr><tr><td>label</td><td>String</td><td>Nein</td><td>Text unterhalb des QR-Codes</td></tr></tbody></table>

#### Ausgabeparameter

<table border="1" id="bkmrk-parameter-format-fal" style="border-collapse: collapse; width: 100%; height: 522.6px;"><colgroup><col style="width: 32.3857%;"></col><col style="width: 19.9011%;"></col><col style="width: 47.7132%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="height: 29.8px;">**Parameter**  
</td><td style="height: 29.8px;">**Format** </td><td style="height: 29.8px;">**Erläuterung**  
</td></tr><tr style="height: 29.8px;"><td style="width: 101.4pt; padding: 0cm 5.4pt; height: 29.8px;" valign="top" width="135">base64

</td><td style="height: 29.8px;">Text</td><td style="width: 215.35pt; padding: 0cm 5.4pt; height: 29.8px;" valign="top" width="287">Base64-Daten des QR-Codes (Bilddatei)

</td></tr></tbody></table>

#### Beispiel-Aufruf

<p class="callout info">https://api.versicherungsmarkt.de/qrcode/svg</p>

#### Beispiel-Antwort

```json
{
  "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:**

<table border="1" id="bkmrk-api-name-loading-scr" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>**Quelle**</td><td>**Kurzbezeichnung**</td></tr><tr><td>Google Maps</td><td>google</td></tr><tr><td>versicherungsmarkt rating</td><td>vmarkt</td></tr></tbody></table>

#### 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.

<p class="callout info">Für den Abruf der Bewertungen von externen Quellen (nicht vmarkt rating), müssen Sie uns vorab Ihre Profil-URL zukommen lassen.</p>

#### Aufruf

<table border="1" id="bkmrk-api-name-review-api-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>**API Name**  
</td><td>review</td></tr><tr><td>**API Type** </td><td>*Name der Quelle, unterstützt sind:*

- *all*
- *google*
- *vmarkt*

</td></tr></tbody></table>

#### Eingabeparameter

<table border="1" id="bkmrk-parameter-format-pfl" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 26.4519%;"></col><col style="width: 16.0689%;"></col><col style="width: 8.043%;"></col><col style="width: 49.5578%;"></col></colgroup><tbody><tr><td>**Parameter**  
</td><td>**Format** </td><td>**Pflicht**  
</td><td>**Erläuterung**  
</td></tr><tr><td>makler  
</td><td>Integer  
</td><td>Ja  
</td><td>Ihre Makler-ID bei versicherungsmarkt.de  
</td></tr></tbody></table>

#### Ausgabeparameter

<table border="1" id="bkmrk-parameter-format-fal" style="border-collapse: collapse; width: 100%; height: 522.6px;"><colgroup><col style="width: 32.3857%;"></col><col style="width: 19.9011%;"></col><col style="width: 47.7132%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="height: 29.8px;">**Parameter**  
</td><td style="height: 29.8px;">**Format** </td><td style="height: 29.8px;">**Erläuterung**  
</td></tr><tr style="height: 29.8px;"><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt; height: 29.8px;" valign="top" width="135">last\_update

</td><td style="height: 29.8px;">Timestamp  
</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt; height: 29.8px;" valign="top" width="287">Datum, wann die Bewertungen zuletzt aktualisiert wurden

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">totalScore

</td><td>Float</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Gesamtdurchschnitt aller Bewertungen

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">reviewsCount

</td><td>Integer</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Gesamtanzahl aller Bewertungen

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">reviews

</td><td>Objekt</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Array mit allen gefundenen Bewertungen

</td></tr></tbody></table>

#### Beispiel-Aufruf

<p class="callout info">https://api.versicherungsmarkt.de/reviews/google</p>

#### Beispiel-Antwort

```json
{
  "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"
      }
    ]
  }
}
```