Synup
Schlüssel erstellen
v1Ressourcen/Reviews/getReviews auflisten

Reviews auflisten

Liefert Bewertungen für einen Standort. Sowohl locationId als auch clientId sind erforderlich.

get/api/v1/reviews
reviews:read
Query-Parameter
locationIdstringerforderlich
Der abzurufende Standort.
clientIdstringerforderlich
Der Kunde des Standorts.
sitesstringoptional
Kommagetrennte Bewertungsplattformen (z. B. google,facebook).
ratingsstringoptional
Kommagetrennte Sternebewertungen (z. B. 1,2).
sentimentstringoptional
Kommagetrennte Stimmungen (positive, neutral, negative).
statusstring (responded | unreplied)optional
Nach Antwortstatus filtern: responded oder unreplied.
keywordstringoptional
Freitextsuche im Bewertungstext und Autor.
fromstringoptional
Fensterbeginn (ISO-Datum).
tostringoptional
Fensterende (ISO-Datum).
sortstring (newest | oldest | lowest | highest)optional
Sortierreihenfolge: newest, oldest, lowest oder highest.
deletedstring (1)optional
1 übergeben, um entfernte/nicht mehr vorhandene statt aktueller Bewertungen anzuzeigen.
cursorstringoptional
Paginierungs-Cursor aus dem nextCursor einer vorherigen Antwort.
limitintegeroptional
Bewertungen pro Seite, 1-100. Standard 30.
Antwort
dataobjectoptional
foundbooleanoptional
Ob der Standort gefunden und für diesen Schlüssel zugänglich war.
reviewsarray of objectoptional
Die Bewertungen selbst.
idstringoptional
Eindeutige Kennung der Bewertung.
authorstringoptional
Name des Rezensenten, oder null, falls von der Quelle nicht angegeben.
ratingnumberoptional
Sternebewertung, oder null.
bodystringoptional
Der Bewertungstext.
reviewDatestringoptional
Zeitpunkt der Veröffentlichung der Bewertung, als ISO-8601-Zeitstempel, oder null.
platformstringoptional
Quellplattform, z. B. google, facebook.
platformLabelstringoptional
Anzeigename der Quellplattform, oder null.
sentimentstringoptional
Erkannte Stimmung der Bewertung, oder null.
replyobjectoptional
Die Antwort des Unternehmens, falls vorhanden, sonst null.
authorstringoptional
bodystringoptional
datestringoptional
reviewUrlstringoptional
Link zur Bewertung auf der Quellplattform, oder null.
respondablebooleanoptional
Ob auf diese Bewertung noch geantwortet werden kann.
nextCursorstringoptional
Paginierungs-Cursor für die nächste Seite, oder null, wenn keine weiteren Ergebnisse vorliegen.
totalnumberoptional
Gesamtzahl der zur Anfrage passenden Bewertungen.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/reviews
Ihr API-Schlüssel
locationId *
clientId *
sites
ratings
sentiment
status
keyword
from
to
sort
deleted
cursor
limit
{
  "data": {
    "found": true,
    "reviews": [
      {
        "id": "rev_1",
        "author": "Jane D.",
        "rating": 5,
        "body": "Great service!",
        "reviewDate": "2026-02-01T12:00:00.000Z",
        "platform": "google",
        "platformLabel": "Google",
        "sentiment": "positive",
        "reply": null,
        "reviewUrl": "https://google.com/...",
        "respondable": true
      }
    ],
    "nextCursor": null,
    "total": 1
  }
}

Anleitungen, die diesen Endpunkt verwenden