Search reviews
rivioo_search_reviewsExact counts of the reviews of one app that mention specific words, plus snippets with review IDs. It is the tool for "how many reviews mention X" questions and for sizing themes found while reading reviews with rivioo_get_reviews. App Store results are per country. Google Play results are per language, from all countries: the country picks the languages (English plus its main language). any_of matches reviews containing at least one term; all_of requires every term; both can be combined. Matching is literal and case-insensitive on word starts: "crash" finds crashes and crashed, "ad" does not find "bad". A term with spaces matches those words in sequence. Chinese, Japanese, Korean and Thai terms match anywhere. Terms are not translated, so reviews in another language match only terms in that language. Returns the reviews in the window, the matching reviews, counts per term and per star, and up to limit snippets newest first, each with review_id and url when the store has one. Counts are free; each snippet uses one review of quota the first time that review reaches this account in 30 days. Pass next_cursor with the same arguments for more snippets.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Window of this many days ending now. Defaults to 30. Use posted_from instead for exact dates. | |
| limit | No | Snippets to return, newest first. Default 15. | |
| store | Yes | 'ios' for the App Store or 'android' for Google Play. | |
| all_of | No | Match only reviews containing every one of these terms. | |
| any_of | No | Match reviews containing at least one of these terms, such as ["crash", "freeze"]. | |
| app_id | Yes | Numeric App Store id (such as 324684580) or Google Play package name (such as com.spotify.music), from rivioo_my_apps or rivioo_find_app. | |
| cursor | No | next_cursor from the previous call, with the same arguments, for the next page. | |
| country | No | Two-letter storefront country such as us or gb. For the App Store it picks the country's reviews; for Google Play it picks the review languages (English plus the country's main language), read from all countries. Optional for saved apps, which use the user's default country. | |
| ratings | No | Only these star ratings, such as [1, 2]. | |
| app_version | No | Only reviews of this exact app version. | |
| posted_from | No | Window start, inclusive, in UTC unless an offset is given. Use instead of days. | |
| max_age_hours | No | Reuse reviews collected within this many hours; older data is collected again automatically (newest reviews only). Default 24. | |
| posted_before | No | Window end, exclusive. Defaults to now. | |
| has_developer_reply | No | true for reviews the developer replied to, false for reviews without a reply. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | Yes | ||
| notes | Yes | Short facts about this result: what the reviews cover, whether the sample is small, what the counts mean and how reviews are identified. | |
| query | Yes | ||
| quota | Yes | ||
| cached | Yes | true when the results come from reviews collected before this call. | |
| status | Yes | fresh: collected during this call. cached: held reviews within max_age_hours. collecting: a collection is still running and results are partial. stale: older than max_age_hours. collection_failed: the latest collection failed. | |
| window | Yes | ||
| results | Yes | ||
| coverage | Yes | ||
| warnings | Yes | ||
| collection | Yes | ||
| next_cursor | Yes | ||
| term_counts | Yes | Reviews in the window containing each term on its own. | |
| collected_at | Yes | When the held reviews were last collected, UTC. | |
| max_age_hours | Yes | ||
| reviews_in_window | Yes | Reviews held in the window after filters, matching or not. | |
| matching_by_rating | Yes | ||
| total_matching_reviews | Yes | Reviews in the window matching the terms and filters. Not users. |