List top iOS apps with rank change and revenue estimates API

One call returns three ranked lists (free, paid, grossing) of top 25 iOS apps for a category, country, device, and date. One item is an app with its current rank, previous rank, and last-month revenue/downloads. The answer held 25 items per list (75 total) with no pagination shown.

1 live route on App Store, from $0.00 per call. Every route below answered our last live test on 2026-10-08; the gateway re-tests them daily.

Get a key See it in the catalog Use it from MCP

Price per call, by route

The upstream price you are metered at, cheapest first. A route without a published price says so.

Provider	Endpoint	Price	Tested
Sensor Tower	List an iOS category's top free, paid and grossing apps with rank movement and revenue (Sensor Tower)`GET ios/category_rankings`	$0.00$0.0e+00 / 1k calls	✓ 2026-10-08pricing ↗

What it returns

From a real call to the route: Sensor Tower.

data.free[]Top free appsdata.paid[]Top paid appsdata.grossing[]Top revenue-generating appsdata.free[].app_idApp Store IDdata.free[].rankCurrent position in chartdata.free[].previous_rankPrior position (any depth)data.free[].humanized_worldwide_last_month_revenue.revenueRevenue in centsdata.free[].humanized_worldwide_last_month_downloads.downloadsDownload countdateChart datelimitItems per list requested

Call it

HTTP with your key in x-api-key, or the call_endpoint tool of our MCP server.

GET /api/gw/sensortower/ios/category_rankings$0.00 / call✓ working · tested 2026-10-080.15 s latency

Parameters

Parameter	Type		Notes
category	string · query	required	Store category id: iOS 0 = all apps, 6000 Business, 6014 Games, 6012 Lifestyle ...; Android 'all' or a category key.e.g. `0`
country	string · query	required	Two-letter store country. · default US
date	string · query	required	Chart day, YYYY-MM-DD (yesterday is the latest full day). Required: without it Sensor Tower answers 422.e.g. `2026-10-07`
limit	integer · query	optional	Rows per chart; 25 is the maximum. · default 25e.g. `25`
offset	integer · query	optional	Always 0: deeper pages are not public. · default 0e.g. `0`
device	string · query	required	Chart device. · one of iphone, ipad · default iphone

HTTP

curl "https://fetchapi.co/api/gw/sensortower/ios/category_rankings?date=2026-10-07&limit=25&device=iphone&offset=0&country=US&category=0" \
  -H "x-api-key: YOUR_KEY"

MCP

call_endpoint("sensortower.ios_top_charts", {"date": "2026-10-07", "limit": "25", "device": "iphone", "offset": "0", "country": "US", "category": "0"})

Real example answer (trimmed) · 2026-10-08

{
  "data": {
    "free": [
      {
        "os": "ios",
        "name": "Muse from Meta",
        "rank": 1,
        "price": {
          "value": 0,
          "currency": "USD",
          "string_value": "$0.00",
          "subunit_to_unit": 100
        },
        "app_id": 6760173601,
        "rating": 4.86019,
        "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/cc/3c/d9/cc3cd96a-4cd8-52ce-9c12-e695ddff9294/…",
        "show_to_bot": false,
        "publisher_id": 284882218,
        "rating_count": 177302,
        "previous_rank": 1,
        "publisher_name": "Meta Platforms, Inc.",
        "app_overview_url": "https://app.sensortower.com/overview/6760173601?country=US",
        "in_app_purchases": false,
        "…": "2 more fields"
      },
      "… 2 more"
    ],
    "paid": [
      {
        "os": "ios",
        "name": "Minecraft: Play with Friends!",
        "rank": 1,
        "price": {
          "value": 699,
          "currency": "USD",
          "string_value": "$6.99",
          "subunit_to_unit": 100
        },
        "app_id": 479516143,
        "rating": 4.50711,
        "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/3b/b7/24/3bb724be-0244-933a-af48-ad2195689877/…",
        "show_to_bot": true,
        "publisher_id": 479516146,
        "rating_count": 842096,
        "previous_rank": 1,
        "publisher_name": "Mojang",
        "app_overview_url": "https://app.sensortower.com/overview/479516143?country=US",
        "in_app_purchases": true,
        "…": "2 more fields"
      },
      "… 2 more"
    ],
    "grossing": [
      {
        "os": "ios",
        "name": "ChatGPT",
        "rank": 1,
        "price": {
          "value": 0,
          "currency": "USD",
          "string_value": "$0.00",
          "subunit_to_unit": 100
        },
        "app_id": 6448311069,
        "rating": 4.82639,
        "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/c7/79/89/c77989be-de98-6c64-b2e0-425d52fa86bc/…",
        "show_to_bot": true,
        "publisher_id": 1684349733,
        "rating_count": 11079400,
        "previous_rank": 1,
        "publisher_name": "OpenAI OpCo, LLC",
        "app_overview_url": "https://app.sensortower.com/overview/6448311069?country=US",
        "in_app_purchases": true,
        "…": "2 more fields"
      },
      "… 2 more"
    ]
  },
  "date": "2026-10-07",
  "limit": 25,
  "offset": 0,
  "total_count": 25
}

Related App Store APIs

All 4 App Store jobs →

Estimate an Android app's monthly revenue and downloadsfrom $0.00
Estimate an iOS app's monthly revenue and downloadsfrom $0.00
List top Android apps with rank change and revenue estimatesfrom $0.00

One key for every API on this page.

Call it over HTTP or from any MCP client. Each key has a rate limit and a monthly cap; calls are metered at the upstream price.

Get a key Set up MCP Browse the catalog