Abrufen von Bewertungen

Beschreibung

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

Unterstützt werden aktuell die folgenden Profile:

Google Maps
vmarkt ~~reting~~rating

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

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
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",
    "reviews": [
      {
        "id": "1",
        "makler": "6198",
        "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"
      },
      {
        "id": "2",
        "makler": "6198",
        "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"
      },
      {
        "id": "3",
        "makler": "6198",
        "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"
      }
    ]
  }
}