---
title: "Google Play"
description: "Reviews of the Android apps a keyword names, with their stars, app version and the developer's reply."
canonical: https://docs.mentio.dev/platforms/googleplay
markdown: https://docs.mentio.dev/platforms/googleplay.mdx
---

# Google Play

Reviews of the Android apps a keyword names, with their stars, app version and the developer's reply.

Google Play is a [review platform](/platforms/reviews): a keyword's term is never searched here. Instead a keyword names apps in its `reviewSources`, and every new review of those apps becomes a mention of the keyword, whether or not the review says the app's name.

| `platform`    | `googleplay`                                                                     |
| ------------- | -------------------------------------------------------------------------------- |
| What is found | Every new review of the apps a keyword names, per storefront and review language |
| Freshness     | About once a day per app, storefront and language                                |
| Last 30 days  | Yes, the newest 100 reviews per storefront, free                                 |

## Connect an app

Paste the app's Google Play link; `countries` and `language` are optional:

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

The id is the package name, the `id=` of the link; `{ "platform": "googleplay", "id": "notion.id" }` works too.

**Pick the language.** Google Play answers the reviews written in one language at a time: an app read in `en` never sees its Spanish reviews. The default is the link's `hl`, else `en`. A keyword reads one language per app; to follow two languages, connect the app to two keywords, one per language.

## What a mention carries

* `post.text`: the review's body (Google Play reviews have no title).
* `review.rating` (1 to 5), `review.version`, `review.country`.
* `review.response` and `review.responseAt`: the developer's reply, when there is one.
* `post.engagement.likes`: how many people marked the review helpful.
* `author.name` and `author.avatarUrl`. Google Play gives a reviewer no profile page, so reviewers are grouped by name in the audience.
* Sentiment comes from the stars (4 and 5 positive, 3 neutral, 1 and 2 negative) and relevance from the keyword's kind; the classifier still adds the intent tags.

## Limits

* Storefronts: 52 countries (the common markets), each a two-letter code such as `us`, `gb`, `de`, `br`, `in`. An unsupported country is refused with the code named.
* A very busy app (hundreds of reviews a day) is read up to its newest 1,000 reviews a day per storefront.