List reviews
list_reviewsReviews, newest first, in the same format for every platform. Filter by location(s), platform, dates, stars, a text search or whether they have a reply; filters combine. Use next_cursor for the next page. Each review carries its location_name and location_url; with q, matched_terms lists the names it matched. meta.pending_locations lists locations whose reviews haven't loaded yet (sync_status queued, importing, waiting_for_reads or error): say they are loading, not that they have no reviews. Example, reviews of the Seattle office that mention John: find its id with list_locations, then location_id="loc_abc", q="John,Johnny".
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_reviews"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search the review text and title for whole words, ignoring case and accents. Separate up to 10 terms with commas to match any of them (OR): "John,Johnny". A term with spaces is a phrase ("John Smith"). "Ann" does not match "Annual". | |
| q_in | No | Where q looks, comma separated: text, title, author. Default: text,title. Add author to find reviews written by someone named like q. | |
| limit | No | Page size. 20 here (the REST API defaults to 50). | |
| since | No | Only reviews created on or after this date. | |
| until | No | Only reviews created on or before this date (a date covers that whole day, UTC). | |
| cursor | No | next_cursor from the previous page. | |
| platform | No | ||
| has_reply | No | true: reviews with a reply in any status (a failed one included); false: reviews with no reply at all. For reviews that still need an answer use reply_status "none,failed". | |
| max_rating | No | Only reviews with at most this many stars. | |
| min_rating | No | Only reviews with at least this many stars (reviews with no stars are left out). | |
| location_id | No | Only this location (from list_locations), or several ids separated by commas (up to 500): loc_a,loc_b. | |
| reply_status | No | Comma separated, any of: none, queued, published, failed, unknown. "none,failed" = still needs an answer. | |
| ingested_since | No | Only reviews Prisma stored on or after this time, whenever they were written: to poll for new ones without missing a late import (a newly connected office’s history). | |
| include_deleted | No | true: also reviews Prisma found removed from the platform (they carry deleted_at). |