Search reviews
search_reviewsFind an app's reviews in a storefront by text, star rating, version or date range, newest first, and see whether more matched than the row limit returned.
Instructions
Search one app's reviews in one storefront by text, star rating, app version and date range, newest first — up to 1,000 rows from the full review archive within your plan's review window. total is the match count; truncated tells you when more rows matched than you asked for.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"appId": "<appId>"
},
"name": "search_reviews"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | text to find in the review title or body | |
| to | No | last day, YYYY-MM-DD | |
| from | No | first day, YYYY-MM-DD | |
| appId | Yes | app id from list_apps | |
| limit | No | rows, up to 1000 (default 100) | |
| rating | No | star ratings, comma separated, e.g. 1,2 | |
| country | No | country code, e.g. tr, us (defaults to the app's first country) | |
| version | No | app version the review was written on, e.g. 2.4.0 | |
| platform | No | defaults to ios |