Listings APIListings API
Se connecter

Avis

Listez les avis, publiez et modifiez des réponses, et récupérez des données d’analyse via client.reviews.

Toutes les méthodes relatives aux avis se trouvent sous client.reviews. Les analyses des avis se trouvent dans la sous-ressource imbriquée client.reviews.analytics.

Les méthodes de lecture renvoient un objet APIObject (accès par point, accès de type dict, .get(), .to_dict()), une liste d’objets APIObject ou un objet SyncPage pour les résultats paginés. Les méthodes d’écriture (respond, edit_response, archive_response, edit_settings) lèvent l’exception ValidationError si la plateforme rejette la modification, même lorsque le statut HTTP est 200. Vous n’avez donc jamais besoin de vérifier les indicateurs de réussite dans le résultat.

reviews.list

Listez les avis d’un établissement avec des filtres facultatifs. Renvoie un objet 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
ParamètreTypeDescription
location_idstr | intÉtablissement dont vous souhaitez lister les avis, identifié par un identifiant numérique (16808) ou en base64 ("TG9jYXRpb246MTY4MDg=").
first / lastintTaille de la page, comptée à partir du début ou de la fin de l’ensemble des résultats.
after / beforestrCurseurs de pagination opaques.
site_urlslist[str]Uniquement les avis provenant de ces URL de pages d’avis.
start_date / end_datestrBornes de dates au format YYYY-MM-DD.
categorystrFiltrez par catégorie d’avis.
rating_filterslist[int]Uniquement ces notes en étoiles, 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

Obtenez des informations détaillées sur des avis spécifiques à partir de leur identifiant d’interaction. Les identifiants d’interaction proviennent du champ interactionId des éléments renvoyés par 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

Publiez une réponse à un avis.

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

Modifiez une réponse existante.

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

Archivez (masquez) une réponse.

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

reviews.settings

Obtenez les paramètres des sources d’avis d’un établissement.

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

reviews.edit_settings

Mettez à jour les URL des sources d’avis d’un établissement. Chaque entrée est un dict décrivant une page d’avis.

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

Obtenez les sites d’avis admissibles pour le compte.

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

reviews.phrases

Obtenez les expressions fréquemment mentionnées extraites des avis. Fournissez les identifiants des établissements en 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())

Sous-ressource d’analyse

reviews.analytics.overview

Obtenez les statistiques globales des avis (totaux, note moyenne, taux de réponse).

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

Obtenez les analyses des avis au fil du temps.

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

Obtenez les analyses des avis ventilées par site (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())

Voir aussi