Listings APIListings API
Masuk

Ulasan

Tampilkan daftar ulasan, kirim dan edit tanggapan, serta ambil data analitik melalui client.reviews.

Semua metode ulasan berada di client.reviews. Analitik ulasan berada di sub-resource bertingkat client.reviews.analytics.

Metode baca mengembalikan APIObject (akses dengan titik, akses dict, .get(), .to_dict()), daftar objek APIObject, atau SyncPage untuk hasil dengan paginasi. Metode tulis (respond, edit_response, archive_response, edit_settings) memunculkan ValidationError jika platform menolak perubahan, bahkan ketika status HTTP adalah 200, sehingga Anda tidak perlu memeriksa penanda keberhasilan pada hasil.

reviews.list

Ambil daftar ulasan untuk suatu lokasi dengan filter opsional. Mengembalikan SyncPage.

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
ParameterTipeDeskripsi
location_idstr | intLokasi yang akan diambil daftar ulasannya, dalam bentuk numerik (16808) atau base64 ("TG9jYXRpb246MTY4MDg=").
first / lastintUkuran halaman, dihitung dari awal atau akhir kumpulan hasil.
after / beforestrKursor paginasi yang nilainya tidak perlu diinterpretasikan.
site_urlslist[str]Hanya ulasan dari URL halaman ulasan ini.
start_date / end_datestrBatas tanggal dalam format YYYY-MM-DD.
categorystrFilter berdasarkan kategori ulasan.
rating_filterslist[int]Hanya peringkat bintang ini, 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

Ambil informasi terperinci untuk ulasan tertentu berdasarkan ID interaksi. ID interaksi berasal dari field interactionId pada item yang dikembalikan oleh reviews.list.

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

reviews.respond

Kirim balasan untuk ulasan.

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

Edit balasan yang sudah ada.

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

Arsipkan (sembunyikan) balasan.

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

reviews.settings

Ambil pengaturan sumber ulasan untuk suatu lokasi.

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

reviews.edit_settings

Perbarui URL sumber ulasan untuk suatu lokasi. Setiap entri berupa dict yang mendeskripsikan satu halaman ulasan.

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

Ambil situs ulasan yang memenuhi syarat untuk akun tersebut.

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

reviews.phrases

Ambil frasa yang sering disebutkan dan diekstrak dari ulasan. Berikan ID lokasi dalam format 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())

Sub-resource analitik

reviews.analytics.overview

Ambil statistik ulasan secara keseluruhan (jumlah total, peringkat rata-rata, persentase balasan).

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

Ambil analitik ulasan dari waktu ke waktu.

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

Ambil analitik ulasan yang dirinci berdasarkan situs (Google, Facebook, Yelp).

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

Lihat juga