Reviews

A keyword can follow the reviews of your app, company or place. Add the review page to the keyword's reviewSources and each new review there becomes a mention, with its star rating. The review doesn't have to mention your name, and most don't ("the app crashes on login"). That's why review sites are not searched by the keyword's term like other platforms.

A keyword can search its term, follow review pages, or both.

A keyword with platforms: [] and no review pages would collect nothing, so it is refused with 400 validation_error.

Reviews go into the same feed as other mentions. You can triage, filter, export and analyse them, and alert rules see them too.

Connect a review pageCopy Anchor Link

Add reviewSources on create or with PATCH /v1/keywords/{id}. Entries are links, or a platform and id pair.

await rumoro.createKeyword({
  body: {
    term: 'Slack',
    kind: 'brand',
    reviewSources: [
      { url: 'https://apps.apple.com/us/app/slack/id618783545', countries: ['us', 'gb'] },
      { url: 'https://play.google.com/store/apps/details?id=com.Slack', language: 'en' },
      { url: 'https://www.trustpilot.com/review/slack.com' },
    ],
  },
});

A keyword can have up to 10 review pages. PATCH replaces the whole list. Sending [] disconnects all pages and keeps the reviews already collected. The keyword's reviewSources shows each page's platform, id, url, countries, language and connectedAt.

You can follow a competitor's app the same way. Create a competitor keyword on their app and add an alert rule with ratings: [1, 2], and you get a daily list of their unhappy users. Send "platforms": [] to collect only the reviews, without posts that mention them.

await rumoro.createKeyword({
  body: {
    term: 'Discord',
    kind: 'competitor',
    platforms: [],
    reviewSources: [{ url: 'https://apps.apple.com/us/app/discord-talk-play-hang-out/id985746746' }],
  },
});

A keyword costs $5 a month either way, and each review is billed like any other mention.

What a review looks likeCopy Anchor Link

A review is a normal mention with an extra review object.

"review": {
  "rating": 2,
  "ratingMax": 5,
  "title": "Notifications stopped working",
  "version": "25.09.10",
  "country": "gb",
  "verified": null,
  "response": null,
  "responseAt": null,
  "app": { "platform": "appstore", "id": "618783545", "url": "https://apps.apple.com/gb/app/id618783545" }
}

review is null for posts that aren't reviews.

• response is the reply from the owner or developer. The App Store feed never includes one.
• title exists on the App Store and Trustpilot, version on both app stores, verified on Trustpilot.
• On the app stores country is the storefront. On Trustpilot it is where the reviewer lives.
• app is the review page, on every platform.

Reviews are scored differently from posts.

Filter reviewsCopy Anchor Link

ratings keeps only reviews with the given star ratings, and notRatings removes them. Both work on GET /v1/mentions, exports, views and alert rules. Posts that aren't reviews never match ratings.

const { data: page } = await rumoro.searchMentions({ query: { platforms: ['appstore', 'googleplay'], ratings: [1, 2] } });

The CSV export adds two columns, rating and app_id (the page's id).

Review reportCopy Anchor Link

GET /v1/analytics/reviews summarises your reviews over a period. It takes the same options as the other analytics reports (range, from and to, timezone, keywordIds, platforms, compare), plus bucket set to day or week.

const { data: report } = await rumoro.getReviewsReport({ query: { range: '30d', compare: true } });

The same report is rumoro analytics:reviews in the CLI, get_reviews_report in MCP, and the Reviews page in the dashboard.

How reviews are collectedCopy Anchor Link

• Once a day for each page (and each storefront on the app stores). Workspaces that follow the same page share the read. Each read also covers the two days before, because Apple lists some reviews late.
• The first 30 days are free. Connecting a page, or adding a storefront or language, brings in its 100 newest reviews from the last 30 days. They are not billed and don't trigger instant alerts, but they show in the feed and digests. This happens once per page per workspace. Disconnecting and reconnecting the page, or deleting the keyword and creating it again, brings no new free reviews. Two keywords on the same page share one free batch.
• After that, each new review is billed like any mention. A review seen in two storefronts counts once, and an edited review isn't counted again.
• Each storefront is separate. A keyword gets reviews from the storefronts it lists. A country added later starts that day, with its own free 30 days.
• A muted keyword stops collecting. When you unmute it, the two-day overlap can bring up to about three days of reviews written in the meantime, billed as new.
• The monthly mention cap applies to new reviews too, which limits the bill for a very busy app. The free reviews don't count toward it. Each page is read up to its 1,000 newest reviews a day.