Reseñas

Obtén una lista de reseñas, publica y edita respuestas y obtén datos analíticos mediante client.reviews.

Todos los métodos de reseñas se encuentran en client.reviews. Los análisis de reseñas se encuentran en el subrecurso anidado client.reviews.analytics.

Los métodos de lectura devuelven un APIObject (acceso mediante punto, acceso como dict, .get(), .to_dict()), una lista de objetos APIObject o un SyncPage para los resultados paginados. Los métodos de escritura (respond, edit_response, archive_response, edit_settings) lanzan ValidationError si la plataforma rechaza el cambio, incluso cuando el estado HTTP es 200, por lo que nunca necesitas comprobar los indicadores de éxito del resultado.

`reviews.list`

Lista las reseñas de una ubicación con filtros opcionales. Devuelve 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

Parámetro	Tipo	Descripción
`location_id`	`str \| int`	Ubicación cuyas reseñas se van a listar, con un identificador numérico (`16808`) o en base64 (`"TG9jYXRpb246MTY4MDg="`).
`first` / `last`	`int`	Tamaño de página, contado desde el principio o el final del conjunto de resultados.
`after` / `before`	`str`	Cursores de paginación opacos.
`site_urls`	`list[str]`	Solo reseñas de estas URL de páginas de reseñas.
`start_date` / `end_date`	`str`	Límites de fecha en formato `YYYY-MM-DD`.
`category`	`str`	Filtra por categoría de reseña.
`rating_filters`	`list[int]`	Solo estas puntuaciones por estrellas, 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`

Obtén información detallada de reseñas específicas por ID de interacción. Los ID de interacción proceden del campo interactionId de los elementos devueltos por 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`

Publica una respuesta a una reseña.

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`

Edita una respuesta existente.

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`

Archiva (oculta) una respuesta.

Python

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

Python

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

`reviews.settings`

Obtén la configuración de las fuentes de reseñas de una ubicación.

Python

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

Python

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

`reviews.edit_settings`

Actualiza las URL de las fuentes de reseñas de una ubicación. Cada entrada es un dict que describe una página de reseñas.

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`

Obtén los sitios de reseñas que cumplen los requisitos para la cuenta.

Python

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

Python

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

`reviews.phrases`

Obtén las frases que se mencionan con frecuencia, extraídas de las reseñas. Pasa los ID de ubicación 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())

Subrecurso de análisis

`reviews.analytics.overview`

Obtén las estadísticas generales de reseñas (totales, puntuación media, tasa de respuesta).

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`

Obtén los análisis de reseñas a lo largo del tiempo.

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`

Obtén los análisis de reseñas desglosados por sitio (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())

Consulta también

Ubicaciones: obtén los ID de ubicación
Análisis: métricas de los perfiles de Google, Bing y Facebook
Casos de uso: ejemplos prácticos de seguimiento de reseñas y respuestas automáticas