API reference · Market

Top charts

The stores’ top free charts, read live (held for 30 minutes): rank, title, developer, rating and genre. Narrow by store, country and genre.

GET/api/v1/charts

Costs: Free
MCP tool: top_charts
Answers: At once (200)

curl "https://appleak.app/api/v1/charts?store=apple&country=us&limit=25&appleGenre=6013" \
  -H "Authorization: Bearer $APPLEAK_KEY"

Response200 OK

{
  "country": "us",
  "apps": [
    {
      "store": "apple",
      "appId": "1234567890",
      "title": "Example Meditation",
      "developer": "Example Labs Ltd",
      "icon": "https://is1-ssl.mzstatic.com/image/thumb/example/512x512bb.jpg",
      "score": 4.7,
      "ratingsTotal": 182340,
      "genre": "Health & Fitness",
      "free": true,
      "rank": 1
    }
  ],
  "errors": []
}

#Parameters

Query parameters

store"apple" | "play" | "both"optionaldefault "both"
countrystringoptionaldefault "us"
Two-letter storefront code, e.g. us, gb, de.
limitintegeroptionaldefault 50
How many places, 10–100. 10–100
appleGenrestringoptional
An App Store genre id, e.g. 6013 for Health & Fitness. 0–10 characters
playCategorystringoptional
A Google Play category, e.g. HEALTH_AND_FITNESS. 0–40 characters

#Returns

The answer as JSON, beside. Free, and does not count against your credits.

MCP: top_charts — Read the App Store and Google Play top free charts for a country, optionally one genre: rank, app, developer, rating. Free.