docs / app-store

App Store

App details, rankings, ratings and reviews.

base /app-store/v15 endpoints

post/app-store/v1/reviews1 credit

unified Apple + Play reviews for one or more apps

Parameter	Required
apps	optional
appleAppId	optional
googlePlayPackage	optional
appName	optional
stores	optional
countries	optional
maxReviews	optional

Try in playground →

post/app-store/v1/search1 credit

ranked app search results

Parameter	Required
query	required
stores	optional
country	optional
count	optional

Try in playground →

post/app-store/v1/topCharts1 credit

ranked chart/category apps

Parameter	Required
stores	optional
country	optional
category	optional
count	optional

Try in playground →

post/app-store/v1/appDetails1 credit

full app profile

Parameter	Required
appId	optional
appleAppId	optional
googlePlayPackage	optional
stores	optional
country	optional
includeSimilarApps	optional

Try in playground →

Example request · reviews

curl -X POST https://api.reefapi.com/app-store/v1/reviews \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"apps":[{"name":"WhatsApp","apple":"310633997"}],"stores":["apple"],"countries":["us"],"maxReviews":100}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}