> ## Documentation Index
> Fetch the complete documentation index at: https://mindcase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Play Reviews

> Extract Google Play reviews, including reviewer name, rating, publish date, and full text

`$0.1 / 1k reviews`

Extract Google Play reviews, including reviewer name, rating, publish date, and full text

## Endpoint

`POST /api/v1/agents/google/play/reviews/run`

## Parameters

<ParamField body="inputs" type="array" required>
  **List** · Google Play app URLs or package IDs (e.g. org.telegram.messenger). One per line.
</ParamField>

<ParamField body="maxResults" type="integer" default={100}>
  **Number** · Reviews per app. Use 0 for all.
</ParamField>

<ParamField body="country" type="string" default="US">
  **Dropdown** · Country's Google Play store to pull reviews from.

  [View all 53 options →](/agents/google/play/reviews/values#country)
</ParamField>

<ParamField body="language" type="string" default="en">
  **Dropdown** · Language to pull reviews in.

  [View all 54 options →](/agents/google/play/reviews/values#language)
</ParamField>

<ParamField body="sortBy" type="string" default="NEWEST">
  **Dropdown** · Sort order for reviews.

  **Options:** `NEWEST`, `RATING`, `HELPFULNESS`

  *Legend: `NEWEST` = Newest, `RATING` = By Rating, `HELPFULNESS` = Most Helpful*
</ParamField>

## Response columns

| Field            | Display name    | Type   |
| ---------------- | --------------- | ------ |
| `appUrl`         | App URL         | url    |
| `reviewUrl`      | Review URL      | url    |
| `reviewText`     | Review Text     | text   |
| `rating`         | Rating          | rating |
| `ratingText`     | Rating (Text)   | text   |
| `reviewer`       | Reviewer        | text   |
| `posted`         | Posted          | text   |
| `thumbsUp`       | Thumbs Up       | number |
| `replyDate`      | Reply Date      | text   |
| `replyText`      | Reply Text      | text   |
| `appVersion`     | App Version     | text   |
| `appId`          | App ID          | text   |
| `country`        | Country         | text   |
| `language`       | Language        | text   |
| `criteria`       | Criteria        | text   |
| `criteriaRating` | Criteria Rating | rating |
| `reviewerAvatar` | Reviewer Avatar | url    |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/google/play/reviews/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "appIds": [
        "com.instagram.android",
        "com.whatsapp",
        "com.zhiliaoapp.musically"
      ],
      "urls": [
        "https://play.google.com/store/apps/details?id=com.snapchat.android&hl=es&gl=US",
        "https://play.google.com/store/apps/details?id=com.facebook.katana&hl=en&gl=DE",
        "https://play.google.com/store/apps/details?id=org.telegram.messenger&hl=fi&gl=CA"
      ],
      "maxResults": 10,
      "customMapFunction": "(object) => { return {...object} }"
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/google/play/reviews/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "appIds": [
          "com.instagram.android",
          "com.whatsapp",
          "com.zhiliaoapp.musically"
      ],
      "urls": [
          "https://play.google.com/store/apps/details?id=com.snapchat.android&hl=es&gl=US",
          "https://play.google.com/store/apps/details?id=com.facebook.katana&hl=en&gl=DE",
          "https://play.google.com/store/apps/details?id=org.telegram.messenger&hl=fi&gl=CA"
      ],
      "maxResults": 10,
      "customMapFunction": "(object) => { return {...object} }"
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "appUrl": "com.zhiliaoapp.musically",
      "reviewUrl": "https://play.google.com/store/apps/details?id=com.zhiliaoapp.musically&reviewId=dbbded8d-5433-48a8-a9bd-743f2197b950",
      "reviewText": "yosef alemyaheu",
      "rating": 5,
      "ratingText": "5",
      "reviewer": "Tamirate Abara",
      "posted": "2026-04-30T12:47:32.476Z",
      "thumbsUp": 0,
      "replyDate": "2026-04-30T13:00:11.551Z",
      "replyText": "Hi! Thanks for taking the time to share your feedback. Your support is greatly appreciated.",
      "appVersion": null,
      "appId": "com.zhiliaoapp.musically",
      "country": "US",
      "language": "en",
      "criteria": null,
      "criteriaRating": null,
      "reviewerAvatar": "https://play-lh.googleusercontent.com/a/ACg8ocKmc3oMb5X6tkOPCFiarnHLfB8KqlEZOCbdW_JeUTBHYbGvDw=mo"
    }
  ]
}
```