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