Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$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

​
inputs
array
required
List · Google Play app URLs or package IDs (e.g. org.telegram.messenger). One per line.
​
maxResults
integer
default:100
Number · Reviews per app. Use 0 for all.
​
country
string
default:"US"
Dropdown · Country’s Google Play store to pull reviews from.View all 53 options →
​
language
string
default:"en"
Dropdown · Language to pull reviews in.View all 54 options →
​
sortBy
string
default:"NEWEST"
Dropdown · Sort order for reviews.Options: NEWEST, RATING, HELPFULNESSLegend: NEWEST = Newest, RATING = By Rating, HELPFULNESS = Most Helpful

​
Response columns

FieldDisplay nameType
appUrlApp URLurl
reviewUrlReview URLurl
reviewTextReview Texttext
ratingRatingrating
ratingTextRating (Text)text
reviewerReviewertext
postedPostedtext
thumbsUpThumbs Upnumber
replyDateReply Datetext
replyTextReply Texttext
appVersionApp Versiontext
appIdApp IDtext
countryCountrytext
languageLanguagetext
criteriaCriteriatext
criteriaRatingCriteria Ratingrating
reviewerAvatarReviewer Avatarurl

​
Example

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} }"
  }
}'

​
Example response

Response
{
  "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"
    }
  ]
}