Skip to main content

​
Downloads to Top

Estimates the number of daily downloads needed to reach specific chart positions in the App Store.

​
Endpoint

GET /v1/categories/:genreId/downloads-to-top

​
Authentication

Requires X-API-Key header.

​
Path Parameters

ParameterTypeRequiredDescription
genreIdstringYesApple genre ID (e.g. 6014 for Games). Use all for overall chart.

​
Query Parameters

ParameterTypeDefaultDescription
countrystringusTwo-letter ISO country code
chartstringtop-freeChart type: top-free, top-paid, or top-grossing

​
Response

{
  "data": {
    "category": {
      "id": "all",
      "name": "All"
    },
    "country": "us",
    "chartType": "top-free",
    "tiers": [
      {
        "rank": 1,
        "estimatedDailyDownloads": 699297,
        "estimatedMonthlyDownloads": 20978910,
        "app": {
          "appId": "6448311069",
          "name": "ChatGPT",
          "developer": "OpenAI OpCo, LLC",
          "icon": "https://is1-ssl.mzstatic.com/...",
          "rating": 4.8,
          "reviews": 5818679
        }
      },
      {
        "rank": 5,
        "estimatedDailyDownloads": 223626,
        "estimatedMonthlyDownloads": 6708780,
        "app": { "..." : "..." }
      },
      {
        "rank": 10,
        "estimatedDailyDownloads": 77183,
        "estimatedMonthlyDownloads": 2315490,
        "app": { "..." : "..." }
      },
      {
        "rank": 25,
        "estimatedDailyDownloads": 53666,
        "estimatedMonthlyDownloads": 1609980,
        "app": { "..." : "..." }
      },
      {
        "rank": 50,
        "estimatedDailyDownloads": 31910,
        "estimatedMonthlyDownloads": 957300,
        "app": { "..." : "..." }
      },
      {
        "rank": 100,
        "estimatedDailyDownloads": 18974,
        "estimatedMonthlyDownloads": 569220,
        "app": null
      }
    ],
    "disclaimer": "Download estimates use power-law models calibrated per category. Actual downloads may vary significantly based on seasonality, marketing spend, and viral effects."
  }
}

​
Tier Ranks

The endpoint returns download estimates for these chart positions:
RankDescription
#1Top of the chart
#5Top 5
#10Top 10
#25Top 25
#50Top 50
#100Bottom of the visible chart

​
Fields

​
Tier Object

FieldTypeDescription
ranknumberChart position
estimatedDailyDownloadsnumberEstimated daily downloads to reach this rank
estimatedMonthlyDownloadsnumberEstimated monthly downloads (daily × 30)
appobjectThe app currently at this rank, or null

​
App Object

FieldTypeDescription
appIdstringApp Store ID
namestringApp name
developerstringDeveloper name
iconstringIcon URL
ratingnumber | nullAverage rating
reviewsnumber | nullTotal review count

​
Methodology

Download estimates use a power-law model calibrated per category: 
Downloads(rank) = base / rank^exponent
  • Parameters are tuned per genre (Games, Social Networking, Finance, etc.)
  • Paid apps receive ~30× fewer downloads than free apps at the same rank
  • When actual chart data is available, estimates are blended with review-based signals for improved accuracy

​
Examples

​
Top Free — All Categories (US)

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.appeeky.com/v1/categories/all/downloads-to-top?country=us&chart=top-free"

​
Top Free — Games (US)

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.appeeky.com/v1/categories/6014/downloads-to-top?country=us&chart=top-free"

​
Top Paid — All Categories (GB)

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.appeeky.com/v1/categories/all/downloads-to-top?country=gb&chart=top-paid"

​
Credit Cost

2 credits per request.