---
title: "Google Play"
description: "New Google Play reviews of your apps, per country and language, with their star rating."
canonical: https://docs.rumoro.dev/platforms/googleplay
markdown: https://docs.rumoro.dev/platforms/googleplay.mdx
---

# Google Play

New Google Play reviews of your apps, per country and language, with their star rating.

Google Play is a [review site](/platforms/reviews), so Rumoro doesn't search it for your term. You add apps to a keyword's `reviewSources`, and every new review of those apps becomes a mention, even if it doesn't name the app.

| `platform` | `googleplay` |
| --- | --- |
| Finds | Every new review of the apps you add, per storefront and language |
| Checked | Once a day for each app, storefront and language |
| New page | The 100 newest reviews per storefront, free |

## Add an app

Use the Google Play link of the app. You may add `countries` and `language`.

```ts tab="TypeScript"
await rumoro.updateKeyword({
  path: { id: 'kw_...' },
  body: { reviewSources: [{ url: 'https://play.google.com/store/apps/details?id=com.Slack', countries: ['us'], language: 'en' }] },
});
```

```python tab="Python"
rumoro.keywords.update(
    "kw_...",
    reviewSources=[{"url": "https://play.google.com/store/apps/details?id=com.Slack", "countries": ["us"], "language": "en"}],
)
```

```bash tab="curl"
curl -X PATCH https://api.rumoro.dev/v1/keywords/kw_... \
  -H "Authorization: Bearer $RUMORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reviewSources": [
        { "url": "https://play.google.com/store/apps/details?id=com.Slack", "countries": ["us"], "language": "en" }
      ] }'
```

You can also send the package name from the link's `id=`, as `{ "platform": "googleplay", "id": "com.Slack" }`.

### Choose a language

Google Play returns reviews in one language at a time. An app read in `en` never shows its Spanish reviews. Without `language`, Rumoro uses the link's `hl`, or `en`. To follow two languages, add the app to two keywords, one for each language.

## What you get

| Field | Holds |
| --- | --- |
| `post.text` | The review. Google Play reviews have no title. |
| `review.rating` | 1 to 5 |
| `review.version`, `review.country` | App version and country |
| `review.response`, `review.responseAt` | The developer's reply and its time, if any |
| `post.engagement.likes` | Helpful votes |
| `author` | Name and avatar. Google Play has no reviewer profiles, so every review has its own author. |

Sentiment comes from the stars and relevance from the keyword's kind. Intents are still read from the text.

## Limits

- 52 storefronts are supported, each a two-letter code like `us`, `gb`, `de`, `br` or `in`. Other codes are refused, and the error names them.
- Each day reads at most an app's 1,000 newest reviews per storefront.