# Sensor Tower (app revenue & rankings)

Gateway provider `sensortower` · call `https://fetchapi.co/api/gw/sensortower/<path>` with header `x-api-key` (get a key at https://fetchapi.co/keys) · MCP: tools `search_endpoints`, `get_endpoint`, `call_endpoint` at https://fetchapi.co/api/mcp · listing: https://sensortower.com/

4 working endpoints, each tested live through this gateway. Endpoints that returned no data in our latest test, write actions and endpoints that need the end user's own login are not listed.

## `sensortower.android_app` — Get a Google Play app's revenue and download estimate, in-app purchases and ratings (Sensor Tower)

`GET /android/apps/{package}` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 216 ms

One call returns one Google Play app's Sensor Tower record: last-month worldwide revenue (worldwide_last_month_revenue.value, in US cents) and downloads (rounded; small apps are floored, so 1,000 downloads or $1,000 means 'under 5k'), every in-app purchase with its price and duration, top countries, rating, rating count and 1-5 star breakdown, version history, release dates, related apps, featured reviews and publisher details.

| param | required | example / default |
|---|---|---|
| `package` | yes | com.ugcroster.app |
| `country` | no | US |

Fields: `app_id` Package name, used to call other endpoints; `name` App title; `rating` Average star rating (0-5); `rating_count` Total number of ratings; `rating_breakdown` [1-star, 2-star, 3-star] counts (5-star implied); `price.value` Price in cents (0 = free); `worldwide_last_month_revenue.value` Revenue in cents; `worldwide_last_month_downloads.value` Download count; `installs` Install range bracket (e.g. '10K - 50K'); `publisher_id` Publisher identifier; `featured_reviews[]` Array of top user reviews with rating and text; `top_in_app_purchases` Price range of in-app purchases by country

```bash
curl "https://fetchapi.co/api/gw/sensortower/android/apps/com.ugcroster.app?country=US" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "os": "android",
 "name": "UGC Roster - Creator Jobs",
 "price": {
  "value": 0,
  "currency": "USD",
  "string_value": "$0.00",
  "subunit_to_unit": 100
 },
 "active": true,
 "app_id": "com.ugcroster.app",
 "rating": 4.381019830028329,
 "country": "US",
 "icon_url": "https://play-lh.googleusercontent.com/UyFWKnwfNIg5GdBHOaH8vUT0_y79GfAUMq8ZsmcXoHQPlx90TSekCE-J20VQ4IkyfsrGFwjH25hLTFoRXWFR5Q=s150",
 "installs": "10K - 50K",
 "language": "EN",
 "versions": [
  {
   "date": 1791158400000,
   "value": "31.0.2"
  },
  {
   "date": 1788825600000,
   "value": "29.0.0"
  },
  {
   "date": 1788134400000,
   "value": "28.0.1"
  }
 ],
 "cohort_id": null,
 "file_size": "Varies with device",
 "categories": [
  {
   "id": "business",
   "name": "Business"
  }
 ],
 "support_url": "https://www.ugcroster.com",
 "website_url": "https://www.ugcroster.com",
 "app_view_url": "/android/us/stacks-studio-holdings-llc/app/ugc-roster-creator-jobs/com.ugcroster.app/",
 "publisher_id": "Stacks+Studio+Holdings+LLC",
 "rating_count": 1412,
 "related_apps": [
  {
   "os": "android",
   "name": "Pocket Prep Nursing School",
   "price": {
    "value": 0,
    "currency": "USD",
    "string_value": "$0.00",
    "subunit_to_unit": 100
   },
   "app_id": "com.pocketprep.android.nursingschool",
   "rating": 4.515714285714286,
   "country": "US",
   "icon_url": "https://play-lh.googleusercontent.com/PCSCBcApmP1PeFNstfyyrmNBIr4XkaA77yFPhcsZfaA-YKO209qzw6Nvc4-ySXumc0F5CYAn_LeLGl4R9TgfrQ=s150",
   "app_view_url": 
…
```

## `sensortower.android_top_charts` — List a Google Play category's top free, paid and grossing apps with rank movement and revenue (Sensor Tower)

`GET /android/category_rankings` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 234 ms

One call returns three ranked lists (free, paid, grossing) of top 25 Google Play apps for a category, country, 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.

| param | required | example / default |
|---|---|---|
| `category` | yes | all |
| `country` | yes | US |
| `date` | yes | 2026-10-07 |
| `limit` | no | 25 |
| `offset` | no | 0 |

Fields: `data.free[]` Top free apps; `data.paid[]` Top paid apps; `data.grossing[]` Top revenue-generating apps; `data.free[].app_id` Package name; `data.free[].rank` Current position in chart; `data.free[].previous_rank` Prior position (any depth); `data.free[].humanized_worldwide_last_month_revenue.revenue` Revenue in cents; `data.free[].humanized_worldwide_last_month_downloads.downloads` Download count; `date` Chart date; `limit` Items per list requested

```bash
curl "https://fetchapi.co/api/gw/sensortower/android/category_rankings?date=2026-10-07&limit=25&offset=0&country=US&category=all" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "data": {
  "free": [
   {
    "os": "android",
    "name": "Muse from Meta",
    "rank": 1,
    "price": {
     "value": 0,
     "currency": "USD",
     "string_value": "$0.00",
     "subunit_to_unit": 100
    },
    "app_id": "com.facebook.aura",
    "rating": 4.66207,
    "icon_url": "https://play-lh.googleusercontent.com/qDQUfohqN-eZh_a_YuWYlTsBPwjgrayoh2-Nf9o49kzN5Yjwk4yTyNUIFRI3o3PYks5lVAgEPrEPvFRYqxLP=s150",
    "show_to_bot": false,
    "publisher_id": "Meta+Platforms,+Inc.",
    "rating_count": 64725,
    "previous_rank": 1,
    "publisher_name": "Meta Platforms, Inc.",
    "app_overview_url": "https://app.sensortower.com/overview/com.facebook.aura?country=US",
    "in_app_purchases": true,
    "humanized_worldwide_last_month_revenue": {
     "units": "k",
     "prefix": "$",
     "string": "$50k",
     "revenue": 50000,
     "revenue_rounded": 50
    },
    "humanized_worldwide_last_month_downloads": {
     "units": "m",
     "prefix": null,
     "string": "2m",
     "downloads": 2000000,
     "downloads_rounded": 2
    }
   },
   {
    "os": "android",
    "name": "ChatGPT",
    "rank": 2,
    "price": {
     "value": 0,
     "currency": "USD",
     "string_value": "$0.00",
     "subunit_to_unit": 100
    },
    "app_id": "com.openai.chatgpt",
    "rating": 4.7800183,
    "icon_url": "https://play-lh.googleusercontent.com/T9J8e9oxxPd600j_KPM4KK2GHfNpUpGBdTy8lHPXBXpOUfGusRuZXj0UMgFNrP8we6LVt9V-AibEgcLootE6VK4=s150",
    "show_to_bot": true,
    "publisher_id": "O
…
```

## `sensortower.ios_app` — Get an iOS app's revenue and download estimate, in-app purchases and ratings (Sensor Tower)

`GET /ios/apps/{app_id}` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 227 ms

One call returns one iOS app's Sensor Tower record: last-month worldwide revenue (worldwide_last_month_revenue.value, in US cents) and downloads (rounded; small apps are floored, so 1,000 downloads or $1,000 means 'under 5k'), every in-app purchase with its price and duration, top countries, rating, rating count and 1-5 star breakdown, version history, release dates, related apps, featured reviews and publisher details.

| param | required | example / default |
|---|---|---|
| `app_id` | yes | 6760748069 |
| `country` | no | US |

Fields: `app_id` App Store ID, used to call other endpoints; `name` App title; `rating` Average star rating (0-5); `rating_count` Total number of ratings; `rating_breakdown` [1-star, 2-star, 3-star] counts (5-star implied); `price.value` Price in cents (0 = free); `worldwide_last_month_revenue.value` Revenue in cents; `worldwide_last_month_downloads.value` Download count; `publisher_id` Publisher identifier; `featured_reviews[]` Array of top user reviews with rating and text; `top_in_app_purchases` In-app purchase names, prices, and durations by country

```bash
curl "https://fetchapi.co/api/gw/sensortower/ios/apps/6760748069?country=US" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "os": "ios",
 "name": "UGC Roster - Creator Jobs",
 "price": {
  "value": 0,
  "currency": "USD",
  "string_value": "$0.00",
  "subunit_to_unit": 100
 },
 "active": true,
 "app_id": 6760748069,
 "rating": 4.741732283464567,
 "country": "US",
 "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/67/ce/6b/67ce6b34-7310-a425-5db7-2e8fde9db73b/AppIcon-0-0-1x_U007epad-0-1-85-220.png/150x150bb.jpg",
 "installs": null,
 "language": "EN",
 "versions": [
  {
   "date": 1791244800000,
   "value": "32.0.0"
  },
  {
   "date": 1789430400000,
   "value": "31.0.1"
  },
  {
   "date": 1788998400000,
   "value": "31.0.0"
  }
 ],
 "cohort_id": null,
 "file_size": 146919424,
 "categories": [
  {
   "id": 6000,
   "name": "Business"
  },
  {
   "id": 6012,
   "name": "Lifestyle"
  }
 ],
 "support_url": "https://www.ugcroster.com/contact",
 "website_url": null,
 "app_view_url": "/ios/us/stacks-studio-holdings-llc/app/ugc-roster-creator-jobs/6760748069/",
 "publisher_id": 1840500163,
 "rating_count": 635,
 "related_apps": [
  {
   "os": "ios",
   "name": "Billo Creator - Sell Content",
   "price": {
    "value": 0,
    "currency": "USD",
    "string_value": "$0.00",
    "subunit_to_unit": 100
   },
   "app_id": 1499355971,
   "rating": 4.692841880341881,
   "country": "US",
   "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/59/49/05/5949056e-4793-7e78-0826-8f55f8b55273/AppIcon-0-0-1x_U007emarketing-0-11-0-85-220.png/150x150bb.jpg",
   "app_view_url": "/ios/us/b
…
```

## `sensortower.ios_top_charts` — List an iOS category's top free, paid and grossing apps with rank movement and revenue (Sensor Tower)

`GET /ios/category_rankings` · ✓ working (tested 2026-10-08) · sampled 2026-10-08, 146 ms

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.

| param | required | example / default |
|---|---|---|
| `category` | yes | 0 |
| `country` | yes | US |
| `date` | yes | 2026-10-07 |
| `limit` | no | 25 |
| `offset` | no | 0 |
| `device` | yes | iphone |

Fields: `data.free[]` Top free apps; `data.paid[]` Top paid apps; `data.grossing[]` Top revenue-generating apps; `data.free[].app_id` App Store ID; `data.free[].rank` Current position in chart; `data.free[].previous_rank` Prior position (any depth); `data.free[].humanized_worldwide_last_month_revenue.revenue` Revenue in cents; `data.free[].humanized_worldwide_last_month_downloads.downloads` Download count; `date` Chart date; `limit` Items per list requested

```bash
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: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "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/HatchAppIconPublic-0-0-1x_U007epad-0-1-0-sRGB-0-85-220.png/150x150bb.jpg",
    "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,
    "humanized_worldwide_last_month_revenue": {
     "units": "k",
     "prefix": "$",
     "string": "$200k",
     "revenue": 200000,
     "revenue_rounded": 200
    },
    "humanized_worldwide_last_month_downloads": {
     "units": "m",
     "prefix": null,
     "string": "3m",
     "downloads": 3000000,
     "downloads_rounded": 3
    }
   },
   {
    "os": "ios",
    "name": "Vinted: Pre-loved marketplace",
    "rank": 2,
    "price": {
     "value": 0,
     "currency": "USD",
     "string_value": "$0.00",
     "subunit_to_unit": 100
    },
    "app_id": 632064380,
    "rating": 4.87263,
    "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/25/49/a6/2549a64c-ef50-324f-6884-254ff5c1963b/VintedAppIcon-0-0-1x_U007epad-0-1-85-220.png/150x150bb.jpg
…
```