Recensioni

Elenca le recensioni, pubblica e modifica le risposte e recupera i dati analitici tramite client.reviews.

Tutti i metodi per le recensioni si trovano in client.reviews. Le analisi delle recensioni si trovano nella sottorisorsa annidata client.reviews.analytics.

I metodi di lettura restituiscono un APIObject (accesso tramite punto, accesso come dict, .get(), .to_dict()), una lista di APIObject oppure un SyncPage per i risultati paginati. I metodi di scrittura (respond, edit_response, archive_response, edit_settings) sollevano ValidationError se la piattaforma rifiuta la modifica, anche quando lo stato HTTP è 200, quindi non devi mai controllare i flag di successo nel risultato.

`reviews.list`

Elenca le recensioni di una sede con filtri facoltativi. Restituisce un 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

Parametro	Tipo	Descrizione
`location_id`	`str \| int`	Sede di cui elencare le recensioni, identificata da un ID numerico (`16808`) o in base64 (`"TG9jYXRpb246MTY4MDg="`).
`first` / `last`	`int`	Numero di risultati per pagina, conteggiati dall'inizio o dalla fine dell'insieme dei risultati.
`after` / `before`	`str`	Cursori di paginazione opachi.
`site_urls`	`list[str]`	Solo le recensioni provenienti da questi URL di pagine di recensioni.
`start_date` / `end_date`	`str`	Limiti dell'intervallo di date nel formato `YYYY-MM-DD`.
`category`	`str`	Filtra per categoria della recensione.
`rating_filters`	`list[int]`	Solo queste valutazioni in stelle, 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`

Ottieni informazioni dettagliate su recensioni specifiche tramite l'ID dell'interazione. Gli ID delle interazioni provengono dal campo interactionId degli elementi restituiti da 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`

Pubblica una risposta a una recensione.

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`

Modifica una risposta esistente.

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`

Archivia (nascondi) una risposta.

Python

client.reviews.archive_response(response_id: str) -> APIObject

Python

client.reviews.archive_response("response-uuid")

`reviews.settings`

Ottieni le impostazioni delle fonti delle recensioni per una sede.

Python

client.reviews.settings(location_id: str | int) -> APIObject

Python

settings = client.reviews.settings(16808)print(settings.to_dict())

`reviews.edit_settings`

Aggiorna gli URL delle fonti delle recensioni per una sede. Ogni voce è un dict che descrive una pagina di recensioni.

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`

Ottieni i siti di recensioni idonei per l'account.

Python

client.reviews.site_config() -> list[APIObject]

Python

sites = client.reviews.site_config()for site in sites:  print(site.to_dict())

`reviews.phrases`

Ottieni le espressioni ricorrenti estratte dalle recensioni. Passa gli ID delle sedi 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())

Sottorisorsa per le analisi

`reviews.analytics.overview`

Ottieni le statistiche complessive sulle recensioni (totali, valutazione media, tasso di risposta).

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`

Ottieni le analisi delle recensioni nel tempo.

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`

Ottieni le analisi delle recensioni suddivise per sito (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())

Vedi anche

Sedi: recupera gli ID delle sedi
Analisi: metriche dei profili Google, Bing e Facebook
Casi d'uso: esempi pratici per il monitoraggio delle recensioni e le risposte automatiche