Listings APIListings API
Oturum aç

Yorumlar

client.reviews aracılığıyla yorumları listeleyin, yanıt yayınlayın ve düzenleyin, analiz verilerini alın.

Tüm yorum metotları client.reviews altında yer alır. Yorum analizleri, bunun altındaki client.reviews.analytics alt kaynağında yer alır.

Okuma metotları bir APIObject (nokta gösterimiyle erişim, dict erişimi, .get(), .to_dict()), APIObject nesnelerinden oluşan bir liste veya sayfalanmış sonuçlar için bir SyncPage döndürür. Yazma metotları (respond, edit_response, archive_response, edit_settings), platform değişikliği reddederse HTTP durum kodu 200 olsa bile ValidationError istisnasını yükseltir; bu nedenle sonuçtaki başarı bayraklarını kontrol etmeniz gerekmez.

reviews.list

İsteğe bağlı filtrelerle bir konumun yorumlarını listeleyin. Bir SyncPage döndürür.

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
ParametreTürAçıklama
location_idstr | intYorumları listelenecek konum; sayısal (16808) veya base64 ("TG9jYXRpb246MTY4MDg=") biçiminde.
first / lastintSonuç kümesinin başından veya sonundan sayılan sayfa boyutu.
after / beforestrOpak sayfalama imleçleri.
site_urlslist[str]Yalnızca bu yorum sayfası URL'lerinden gelen yorumlar.
start_date / end_datestrYYYY-MM-DD biçiminde tarih sınırları.
categorystrYorum kategorisine göre filtreleyin.
rating_filterslist[int]Yalnızca şu yıldız puanları: 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

Belirli yorumların ayrıntılı bilgilerini etkileşim kimliğine göre alın. Etkileşim kimlikleri, reviews.list tarafından döndürülen öğelerin interactionId alanından alınır.

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

reviews.respond

Bir yoruma yanıt yayımlayın.

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

Mevcut bir yanıtı düzenleyin.

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

Bir yanıtı arşivleyin (gizleyin).

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

reviews.settings

Bir konumun yorum kaynağı ayarlarını alın.

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

reviews.edit_settings

Bir konumun yorum kaynağı URL'lerini güncelleyin. Her öğe, bir yorum sayfasını tanımlayan bir dict nesnesidir.

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

Hesap için uygun yorum sitelerini alın.

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

reviews.phrases

Yorumlardan çıkarılan, sık geçen ifadeleri alın. Konum kimliklerini base64 biçiminde iletin.

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())

Analiz alt kaynağı

reviews.analytics.overview

Genel yorum istatistiklerini (toplamlar, ortalama puan, yanıt oranı) alın.

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

Zamana göre yorum analizlerini alın.

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

Siteye (Google, Facebook, Yelp) göre ayrılmış yorum analizlerini alın.

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())

Ayrıca bakınız