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 App Store reviews – text, rating, author, and date – from app URLs

Endpoint

POST /api/v1/agents/appstore/reviews/run

Parameters

urls
array
required
List · App Store URLs to scrape reviews from. Format: https://apps.apple.com/us/app/instagram/id389801252. One per line.
country
string
default:"us"
Dropdown · Country’s App Store to pull reviews from. Defaults to the country in the URL, or US if missing.View all 65 options →
maxResults
integer
default:100
Number · Max reviews per app. Use 0 for all.

Response columns

FieldDisplay nameType
appUrlApp URLurl
reviewUrlReview URLurl
reviewTitleReview Titletext
reviewTextReview Texttext
ratingRatingrating
reviewerReviewertext
reviewerUrlReviewer URLurl
postedPostedtext
appVersionApp Versiontext
countryCountrytext

Example

curl -X POST https://api.mindcase.co/api/v1/agents/appstore/reviews/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "appIds": [
      "284882215",
      "408709785"
    ],
    "urls": [
      "https://apps.apple.com/gb/app/instagram/id389801252",
      "https://apps.apple.com/ca/app/tiktok/id835599320"
    ],
    "maxResults": 10,
    "customMapFunction": "(object) => { return {...object} }"
  }
}'

Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "appUrl": "https://apps.apple.com/us/app/id408709785",
      "reviewUrl": "https://itunes.apple.com/us/review?id=408709785&type=Purple%20Software",
      "reviewTitle": "Ringtones",
      "reviewText": "Free ringtones",
      "rating": 5,
      "reviewer": "Alersar7",
      "reviewerUrl": "https://itunes.apple.com/us/reviews/id1717541561",
      "posted": "2026-04-29T23:28:12-07:00",
      "appVersion": "2.3.18",
      "country": "US"
    }
  ]
}