Listings APIListings API
Anmelden

Bewertungen

Bewertungen auflisten, Antworten veröffentlichen und bearbeiten sowie Analysen über client.reviews abrufen.

Alle Methoden für Bewertungen befinden sich unter client.reviews. Bewertungsanalysen befinden sich unter der verschachtelten Unterressource client.reviews.analytics.

Lesemethoden geben ein APIObject (Zugriff per Punktnotation, Zugriff wie auf ein dict, .get(), .to_dict()), eine Liste von APIObject oder ein SyncPage für paginierte Ergebnisse zurück. Schreibmethoden (respond, edit_response, archive_response, edit_settings) lösen ValidationError aus, wenn die Plattform die Änderung ablehnt, auch wenn der HTTP-Status 200 ist. Daher müssen Sie niemals Erfolgsflags im Ergebnis prüfen.

reviews.list

Listen Sie Bewertungen für einen Standort mit optionalen Filtern auf. Gibt ein SyncPage zurück.

Python
client.reviews.list(    location_id: str | int,    *,    first: int | None = None,    after: str | None = None,    before: str | None = None,    last: int | None = None,    site_urls: list[str] | None = None,    start_date: str | None = None,    end_date: str | None = None,    category: str | None = None,    rating_filters: list[int] | None = None,) -> SyncPage
ParameterTypBeschreibung
location_idstr | intStandort, dessen Bewertungen aufgelistet werden sollen, numerisch (16808) oder in base64 ("TG9jYXRpb246MTY4MDg=").
first / lastintSeitengröße, vom Anfang oder Ende der Ergebnismenge aus gezählt.
after / beforestrOpake Paginierungscursor.
site_urlslist[str]Nur Bewertungen von diesen URLs der Bewertungsseiten.
start_date / end_datestrDatumsgrenzen im Format YYYY-MM-DD.
categorystrNach Bewertungskategorie filtern.
rating_filterslist[int]Nur diese Sternebewertungen, e.g. [1, 2].
Python
# Recent reviewspage = client.reviews.list(16808, first=10)for review in page:  print(review.rating, review.authorName) # 1- and 2-star only, this yearpage = client.reviews.list(  16808,  rating_filters=[1, 2],  start_date="2026-01-01",  first=50,) # Auto-paginate all reviewsfor review in client.reviews.list(16808, first=100).auto_paging_iter():  print(review.content)

reviews.details

Rufen Sie detaillierte Informationen zu bestimmten Bewertungen anhand der Interaktions-ID ab. Interaktions-IDs stammen aus dem Feld interactionId der von reviews.list zurückgegebenen Elemente.

Python
client.reviews.details(interaction_ids: list[str]) -> APIObject
Python
details = client.reviews.details(["uuid-1", "uuid-2"])print(details.to_dict())

reviews.respond

Veröffentlichen Sie eine Antwort auf eine Bewertung.

Python
client.reviews.respond(interaction_id: str, content: str) -> APIObject
Python
result = client.reviews.respond(  interaction_id="review-uuid",  content="Thank you for your feedback, we really appreciate it!",)print(result.to_dict())

reviews.edit_response

Bearbeiten Sie eine vorhandene Antwort.

Python
client.reviews.edit_response(    review_id: str,    response_id: str,    content: str,) -> APIObject
Python
client.reviews.edit_response(  review_id="review-uuid",  response_id="response-uuid",  content="Updated reply text.",)

reviews.archive_response

Archivieren Sie eine Antwort (blenden Sie sie aus).

Python
client.reviews.archive_response(response_id: str) -> APIObject
Python
client.reviews.archive_response("response-uuid")

reviews.settings

Rufen Sie die Einstellungen der Bewertungsquellen für einen Standort ab.

Python
client.reviews.settings(location_id: str | int) -> APIObject
Python
settings = client.reviews.settings(16808)print(settings.to_dict())

reviews.edit_settings

Aktualisieren Sie die URLs der Bewertungsquellen für einen Standort. Jeder Eintrag ist ein dict, das eine Bewertungsseite beschreibt.

Python
client.reviews.edit_settings(    location_id: str | int,    site_urls: list[dict],) -> APIObject
Python
client.reviews.edit_settings(16808, site_urls=[  {"url": "https://www.google.com/maps/...", "active": True},])

reviews.site_config

Rufen Sie die für das Konto infrage kommenden Bewertungsportale ab.

Python
client.reviews.site_config() -> list[APIObject]
Python
sites = client.reviews.site_config()for site in sites:  print(site.to_dict())

reviews.phrases

Rufen Sie häufig genannte Formulierungen ab, die aus Bewertungen extrahiert wurden. Übergeben Sie Standort-IDs in base64.

Python
client.reviews.phrases(    location_ids: list[str],    *,    site_urls: list[str] | None = None,    start_date: str | None = None,    end_date: str | None = None,) -> list[APIObject]
Python
phrases = client.reviews.phrases(  ["TG9jYXRpb246MTY4MDg=", "TG9jYXRpb246MTQwMjQ="],  start_date="2026-01-01",  end_date="2026-06-30",)for p in phrases:  print(p.to_dict())

Unterressource für Analysen

reviews.analytics.overview

Rufen Sie die Gesamtstatistik der Bewertungen ab (Gesamtzahlen, durchschnittliche Bewertung, Antwortquote).

Python
client.reviews.analytics.overview(    location_id: str | int,    *,    start_date: str | None = None,    end_date: str | None = None,) -> APIObject
Python
stats = client.reviews.analytics.overview(  16808,  start_date="2026-01-01",  end_date="2026-06-30",)print(stats.to_dict())

reviews.analytics.timeline

Rufen Sie Bewertungsanalysen im Zeitverlauf ab.

Python
client.reviews.analytics.timeline(    location_id: str | int,    *,    start_date: str | None = None,    end_date: str | None = None,) -> APIObject
Python
timeline = client.reviews.analytics.timeline(  16808,  start_date="2026-01-01",  end_date="2026-06-30",)print(timeline.to_dict())

reviews.analytics.sites_stats

Rufen Sie Bewertungsanalysen aufgeschlüsselt nach Plattform (Google, Facebook, Yelp) ab.

Python
client.reviews.analytics.sites_stats(    location_id: str | int,    *,    start_date: str | None = None,    end_date: str | None = None,) -> APIObject
Python
sites = client.reviews.analytics.sites_stats(  16808,  start_date="2026-01-01",  end_date="2026-06-30",)print(sites.to_dict())

Siehe auch

  • Standorte: Standort-IDs abrufen
  • Analysen: Profilkennzahlen für Google, Bing und Facebook
  • Anwendungsfälle: Anleitungen zur Überwachung von Bewertungen und zu automatischen Antworten