List the apps this Rivioo user saved: their own apps and competitors, each with store, app_id and default country (for Google Play the default country picks the review languages). Use it to look up an app the user names before calling rivioo_review_stats, rivioo_search_reviews or rivioo_get_reviews. Free; delivers no reviews.
Takes no parameters.
rivioo_find_app
Find an app
Search the App Store and Google Play for apps by name in one storefront country (for Google Play the country later picks the review languages). Returns each match's app_id per store, developer, rating and store links. Use it for apps that are not in rivioo_my_apps; ask the user for the country if it is unknown. Omit store to search both stores. Free; delivers no reviews.
Parametersqueryrequiredstorecountryrequired
rivioo_review_stats
Review stats
Exact rating distribution for one app over a window: total reviews, average rating, reviews per star and developer replies, also by app version (newest first, then other and unknown) and by week (weeks start Monday, UTC). Counts are the reviews Rivioo holds in the window, not users or every review ever written. 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). Use it for ratings, versions and weekly trends, and before reading reviews to see when ratings changed. Free; returns no review text. Collects newer reviews automatically when held reviews are older than max_age_hours.
Parametersdaysstorerequiredapp_idrequiredcountryapp_versionposted_frommax_age_hoursposted_before
rivioo_search_reviews
Search reviews
Exact 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.
Parametersdayslimitstorerequiredall_ofany_ofapp_idrequiredcursorcountryratingsapp_versionposted_frommax_age_hours+2 more
rivioo_get_reviews
Get reviews
Returns a page of full reviews of one app: reviews, not counts. To count how many reviews mention a theme, use rivioo_search_reviews. Every review has a review_id, and a url when the store has one (App Store reviews have no per-review link), to cite when quoting. 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). Pass review_ids (from rivioo_search_reviews) to read those reviews, or a window with filters to read reviews newest first. response_format concise returns id, rating, date, version, title, body and url; detailed adds language and developer reply. Each review uses one review of quota the first time it reaches this account in 30 days; reading it again in that time is free. Pass next_cursor with the same arguments for the next page.
Parametersdayslimitstorerequiredapp_idrequiredcursorcountryratingsreview_idsapp_versionposted_frommax_age_hoursposted_before+2 more