Reviews summary
Aggregates review statistics for the credential’s scope: totals, average rating, rating distribution, per-channel breakdown, host-response count, and the most frequent positive/negative tags. Accepts the same filters as review search (minus q), so the aggregate can be windowed by review date, bounded by rating, or narrowed to one channel. Requires scope read:reviews.
Authorizations
Authorization: Bearer <token>. Token types resolve to the same scoped credential: a user-generated API key (casa_…, from Account settings — recommended for machines and MCP clients), a WorkOS AuthKit session JWT (the web app; org and role come from verified token claims), or a static token. API keys are group-scoped, optionally pinned to one property at creation. MCP OAuth connector tokens authenticate the MCP server only and are rejected on these REST routes.
Headers
Optional single-property drill-down. When set, narrows the request to this property; it must belong to the caller's group, else 403. A property-pinned API key is already narrowed and ignores this header.
Query Parameters
Channel name (e.g. Booking.com).
Only include reviews with (true) / without (false) a host response.
Response
Aggregate review statistics.
Aggregate review statistics for the requested scope and window.