Sensor Tower

App · 21 actions

Read Sensor Tower's app market data: download and revenue estimates, active users, store rankings, reviews, and the ads apps run.

Actions

ActionWhat it does
Find new apps in a categoryGet the ids of apps in a store category released, or updated, on or after a date.
Get active usersGet Sensor Tower's estimates of apps' daily, weekly or monthly active users, by country.
Get ad network ranksGet where apps rank among advertisers on each ad network, by country and day or week.
Get ad share of voiceGet each app's share of ad impressions by ad network, country and day, week or month.
Get an app's adsGet the ads apps have run on chosen ad networks and countries, with each ad's images or videos and its share of the apps' impressions.
Get API usageGet how many API requests your organisation and this token have used in a month, and how many are left.
Get app detailsGet the store details of up to 100 apps: name, publisher, categories, rating, price, release date and description.
Get audience demographicsGet the gender and age of apps' users, for all time or by quarter, worldwide or in one country or region.
Get download sourcesGet how many of apps' downloads were organic, from paid ads or from a browser, by day or month.
Get downloads and revenueGet Sensor Tower's estimates of apps' downloads and revenue by country and day, week, month or quarter.
Get ranking historyGet where apps stood on a category's top charts each day, by chart and country.
Get reviewsGet an app's store reviews in one country, filtered by stars, words or dates.
Get top adsGet the top ads on one ad network in a category and country over a week, month or quarter.
Get top advertisersRank the apps (or the publishers showing ads) with the biggest share of ad impressions in a category and country over a period.
Get top apps by active usersRank apps in a category by estimated daily, weekly or monthly active users in a period, or by how much that grew.
Get top apps by downloads or revenueRank apps in a category by estimated downloads or revenue in a week, month or other period, or by how much they grew.
Get top chartGet the apps on one App Store or Google Play top chart, such as Top Free in Games, in a country, top first.
Get top publishersRank publishers in a category by estimated downloads or revenue in a period, with their apps that count.
List a publisher's appsList a publisher's apps on one store, or every app of a publisher across both stores.
Match apps across storesGet the App Store and Google Play versions of each app under its unified id, from either store's ids or unified ids.
Search apps and publishersFind apps or publishers by name, or by words in their store listing, and get the Sensor Tower ids the other steps take.

Find new apps in a category

Get the ids of apps in a store category released, or updated, on or after a date. Use 'Get app details' to read them.

Inputs

PlatformplatformtextRequired
Which store: the App Store or Google Play.One of: ios (App Store (iOS)), android (Google Play (Android)).
CategorycategorytextRequired
The store category.One of: 0 (App Store: Overall), 6000 (App Store: Business), 6001 (App Store: Weather), 6002 (App Store: Utilities), 6003 (App Store: Travel), 6004 (App Store: Sports), 6005 (App Store: Social Networking), 6006 (App Store: Reference), 6007 (App Store: Productivity), 6008 (App Store: Photo & Video), and 98 more.
Released on or afterreleased_on_or_afterdate
Only apps released on or after this day.
Updated on or afterupdated_on_or_afterdate
Only apps updated on or after this day.
How manylimitnumber
How many to return, up to 10000. Sensor Tower's default is 1000.From 1 to 10000.
Skipoffsetnumber
How many to skip, to get the next page after an earlier one.At least 0.

Outputs

app_idslist
The apps' ids, oldest release first
countnumber
How many are in this answer
date_rangelist
When the first and the last of these apps were released
Example output
{
  "app_ids": [
    "6761237642",
    "6789403315"
  ],
  "count": 2,
  "date_range": [
    "2026-11-01T00:00:00Z",
    "2026-11-01T00:00:00Z"
  ]
}

Get active users

Get Sensor Tower's estimates of apps' daily, weekly or monthly active users, by country.

Inputs

PlatformplatformtextRequired
Which store's data: the App Store, Google Play or both.One of: ios (App Store (iOS)), android (Google Play (Android)), unified (Both stores, combined (unified)).
Appsapp_idslistRequired
The apps, by their Sensor Tower ids (unified ids for both stores combined). Up to 500.
Measuretime_periodtext
Daily (the default), weekly or monthly active users.One of: day (Daily active users), week (Weekly active users), month (Monthly active users).
Countriescountrieslist
Which countries, or Worldwide on its own. Leave empty for every country.One or more of: WW (Worldwide), AE (United Arab Emirates), AO (Angola), AR (Argentina), AT (Austria), AU (Australia), AZ (Azerbaijan), BD (Bangladesh), BE (Belgium), BF (Burkina Faso), and 103 more.
Fromstart_datedateRequired
The first day to include.
Toend_datedateRequired
The last day to include.

Outputs

active_userslist
The figures
countnumber
How many are in this answer
Example output
{
  "active_users": [
    {
      "app_id": "284882215",
      "country": "US",
      "date": "2026-11-01",
      "raw": {
        "app_id": 284882215,
        "country": "US",
        "date": "2026-11-01T00:00:00Z",
        "ipad_users": 121456,
        "iphone_users": 1536760
      },
      "users": 1658216
    }
  ],
  "count": 1
}

Get ad network ranks

Get where apps rank among advertisers on each ad network, by country and day or week.

Inputs

Platformplatformtext
Which store's ads: the App Store, Google Play, or both combined (the default, which takes unified app ids).One of: ios (App Store (iOS)), android (Google Play (Android)), unified (Both stores, combined (unified)).
Appsapp_idslistRequired
The apps, by their Sensor Tower ids: 284882215 for an App Store app, com.facebook.katana for a Google Play app, or a unified id. Find them with 'Search apps and publishers'.
Fromstart_datedateRequired
The first day to include.
Toend_datedateRequired
The last day to include.
Byperiodtext
Day (the default) or week.One of: day, week.
Ad networksnetworkslist
Which ad networks. Leave empty for all of them.One or more of: Adcolony, Admob, Applovin, BidMachine, Chartboost, Digital Turbine, Facebook, InMobi, Instagram, Line, and 16 more.
Countriescountrieslist
Which countries. Leave empty for all of them.One or more of: AE (United Arab Emirates), AO (Angola), AR (Argentina), AT (Austria), AU (Australia), AZ (Azerbaijan), BD (Bangladesh), BE (Belgium), BF (Burkina Faso), BG (Bulgaria), and 102 more.

Outputs

countnumber
How many are in this answer
rankslist
The ranks
Example output
{
  "count": 1,
  "ranks": [
    {
      "app_id": "55d3a1a802ac64350a000d9d",
      "country": "US",
      "date": "2026-11-01",
      "network": "Admob",
      "rank": 127
    }
  ]
}

Get ad share of voice

Get each app's share of ad impressions by ad network, country and day, week or month.

Inputs

Platformplatformtext
Which store's ads: the App Store, Google Play, or both combined (the default, which takes unified app ids).One of: ios (App Store (iOS)), android (Google Play (Android)), unified (Both stores, combined (unified)).
Appsapp_idslistRequired
The apps, by their Sensor Tower ids: 284882215 for an App Store app, com.facebook.katana for a Google Play app, or a unified id. Find them with 'Search apps and publishers'.
Fromstart_datedateRequired
The first day to include.
Toend_datedateRequired
The last day to include.
Byperiodtext
Day (the default), week or month.One of: day, week, month.
Ad networksnetworkslist
Which ad networks. Leave empty for all of them.One or more of: Adcolony, Admob, Applovin, BidMachine, Chartboost, Digital Turbine, Facebook, InMobi, Instagram, Line, and 16 more.
Countriescountrieslist
Which countries. Leave empty for all of them.One or more of: AE (United Arab Emirates), AO (Angola), AR (Argentina), AT (Austria), AU (Australia), AZ (Azerbaijan), BD (Bangladesh), BE (Belgium), BF (Burkina Faso), BG (Bulgaria), and 102 more.

Outputs

countnumber
How many are in this answer
share_of_voicelist
The figures
Example output
{
  "count": 1,
  "share_of_voice": [
    {
      "app_id": "55d3a1a802ac64350a000d9d",
      "country": "US",
      "date": "2026-11-01",
      "network": "Applovin",
      "sov": 0.04
    }
  ]
}

Get an app's ads

Get the ads apps have run on chosen ad networks and countries, with each ad's images or videos and its share of the apps' impressions.

Inputs

Platformplatformtext
Which store's ads: the App Store, Google Play, or both combined (the default, which takes unified app ids).One of: ios (App Store (iOS)), android (Google Play (Android)), unified (Both stores, combined (unified)).
Appsapp_idslistRequired
The advertising apps, by unified id unless Platform is one store.
Fromstart_datedateRequired
The first day to include.
Toend_datedate
The last day. Defaults to today.
CountriescountrieslistRequired
Which countries.One or more of: AE (United Arab Emirates), AO (Angola), AR (Argentina), AT (Austria), AU (Australia), AZ (Azerbaijan), BD (Bangladesh), BE (Belgium), BF (Burkina Faso), BG (Bulgaria), and 102 more.
Ad networksnetworkslistRequired
Which ad networks.One or more of: Adcolony, Admob, Applovin, BidMachine, Chartboost, Digital Turbine, Facebook, InMobi, Instagram, Line, and 16 more.
Ad typesad_typeslistRequired
Which kinds of ad to include, such as video or playable.One or more of: image (Image (all)), image-banner (Image banner), image-interstitial (Image interstitial), image-other (Other image), banner, full_screen (Full screen), video (Video (all)), video-rewarded (Rewarded video), video-interstitial (Video interstitial), video-other (Other video), and 4 more.
Only new adsnew_onlytrue/false
Only ads first seen in the period asked about.
How manylimittext
How many to return. Sensor Tower's default is 10.One of: 10, 50, 100.
Pagepagenumber
Which page of results, starting at 1.At least 1.

Outputs

ad_unitslist
The ads
available_networkslist
The networks Sensor Tower has ads from
countnumber
How many ads match, on every page
Example output
{
  "ad_units": [
    {
      "ad_type": "video",
      "app_id": "5f16a8019f7b275235017614",
      "creatives": [
        {
          "button_text": "Install",
          "creative_url": "https://x-ad-assets.s3.amazonaws.com/media_asset/1/media",
          "height": 1920,
          "id": "6431a2b9a1f2b30001c1d2e3",
          "message": "Match three and win!",
          "thumb_url": "https://x-ad-assets.s3.amazonaws.com/media_asset/1/thumb",
          "width": 1080
        }
      ],
      "first_seen_at": "2026-10-02T00:00:00Z",
      "id": "6431a2b9a1f2b30001c1d2e0",
      "last_seen_at": "2026-11-14T00:00:00Z",
      "network": "TikTok",
      "share": 0.12
    }
  ],
  "available_networks": [
    "TikTok",
    "Admob"
  ],
  "count": 1
}

Get API usage

Get how many API requests your organisation and this token have used in a month, and how many are left.

Inputs

Monthmonthdate
Any day in the month to report on. Leave empty for this month.

Outputs

monthtext
The month, as YYYY-MM
organizationobject
Your organisation's use
remainingnumber
Requests left in the month
userobject
This token's use
Example output
{
  "month": "2026-11",
  "organization": {
    "limit": 100000,
    "tier": "",
    "usage": 2310
  },
  "remaining": 97690,
  "user": {
    "usage": 412
  }
}

Get app details

Get the store details of up to 100 apps: name, publisher, categories, rating, price, release date and description.

Inputs

PlatformplatformtextRequired
Which store: the App Store or Google Play.One of: ios (App Store (iOS)), android (Google Play (Android)).
Appsapp_idslistRequired
The apps, by their Sensor Tower ids: 284882215 for an App Store app, com.facebook.katana for a Google Play app, or a unified id. Find them with 'Search apps and publishers'.
Countrycountrytext
Whose store listing to read. Defaults to the United States.One of: AE (United Arab Emirates), AO (Angola), AR (Argentina), AT (Austria), AU (Australia), AZ (Azerbaijan), BD (Bangladesh), BE (Belgium), BF (Burkina Faso), BG (Bulgaria), and 102 more.

Outputs

appslist
The apps
countnumber
How many are in this answer
Example output
{
  "apps": [
    {
      "app_id": "284882215",
      "categories": [
        6005
      ],
      "description": "Where real people propel your curiosity.",
      "global_rating_count": 4793919,
      "icon_url": "https://is2-ssl.mzstatic.com/image/thumb/facebook/150x150bb.png",
      "name": "Facebook",
      "os": "ios",
      "price": 0,
      "publisher_id": "284882218",
      "publisher_name": "Facebook, Inc.",
      "rating": 2.2044,
      "rating_count": 1122455,
      "release_date": "2008-07-11T07:00:00Z",
      "unified_app_id": "55c5022302ac64f9c0001f86",
      "updated_date": "2021-09-09T00:00:00Z",
      "url": "https://apps.apple.com/US/app/id284882215?l=en",
      "version": "335.0"
    }
  ],
  "count": 1
}

Get audience demographics

Get the gender and age of apps' users, for all time or by quarter, worldwide or in one country or region.

Inputs

PlatformplatformtextRequired
Which store: the App Store or Google Play.One of: ios (App Store (iOS)), android (Google Play (Android)).
Appsapp_idslistRequired
The apps, by their store ids, such as 284882215 or com.facebook.katana. Up to 500.
Overdate_granularitytext
All time (the default) or each quarter.One of: all_time (All time), quarterly.
Country or regioncountrytext
Where. Leave empty for worldwide.One of: ASIA, CARIB (The Caribbean), CENTR_AM (Central America), EUR_UN (European Union), EUROPE, LATIN_AM (Latin America), MID_EAST (Middle East), NORTH_AM (North America), OCEANIA, SE_ASIA (Southeast Asia), and 113 more.
Fromstart_datedateRequired
The first day to include.
Toend_datedate
The last day to include.

Outputs

appslist
Each app's audience
baselineobject
The audience of every app together, to compare with, by gender and age band
countnumber
How many are in this answer
disabled_app_idslist
Apps asked about that have too few users for an estimate
Example output
{
  "apps": [
    {
      "app_id": "284882215",
      "average_age_total": 34.6439,
      "confidence": 11,
      "country": "WW",
      "date": "2015-08-01",
      "date_granularity": "all_time",
      "female": 0.4588,
      "male": 0.5412,
      "normalized_demographics": {
        "female_18": 0.0842,
        "male_25": 0.1961
      }
    }
  ],
  "baseline": {
    "female_18": 0.1156,
    "male_18": 0.1779
  },
  "count": 1,
  "disabled_app_ids": []
}

Get download sources

Get how many of apps' downloads were organic, from paid ads or from a browser, by day or month.

Inputs

Platformplatformtext
Count downloads from the App Store, Google Play, or both (the default). The apps are always given by unified id.One of: ios (App Store (iOS)), android (Google Play (Android)), unified (Both stores, combined (unified)).
Appsapp_idslistRequired
The apps, by their unified ids (from 'Search apps and publishers' with Platform set to both stores combined).
CountriescountrieslistRequired
Which countries, or Worldwide on its own.One or more of: WW (Worldwide), AE (United Arab Emirates), AO (Angola), AR (Argentina), AT (Austria), AU (Australia), AZ (Azerbaijan), BD (Bangladesh), BE (Belgium), BF (Burkina Faso), and 103 more.
Bydate_granularitytext
Monthly (the default) or daily.One of: monthly (Monthly (default)), daily.
Fromstart_datedateRequired
The first day to include.
Toend_datedateRequired
The last day to include.

Outputs

appslist
Each app's breakdown
countnumber
How many are in this answer
Example output
{
  "apps": [
    {
      "app_id": "55c5027502ac64f9c0001fa6",
      "breakdown": [
        {
          "browser_abs": 2677,
          "browser_frac": 0.0147,
          "date": "2026-10-01",
          "organic_abs": 165995,
          "organic_frac": 0.91154,
          "paid_abs": 13430,
          "paid_frac": 0.07376
        }
      ]
    }
  ],
  "count": 1
}

Get downloads and revenue

Get Sensor Tower's estimates of apps' downloads and revenue by country and day, week, month or quarter. Revenue is in US dollars.

Inputs

PlatformplatformtextRequired
Which store's data: the App Store, Google Play or both.One of: ios (App Store (iOS)), android (Google Play (Android)), unified (Both stores, combined (unified)).
Appsapp_idslist
The apps, by their Sensor Tower ids: 284882215 for an App Store app, com.facebook.katana for a Google Play app, or a unified id. Find them with 'Search apps and publishers'.
Publisherspublisher_idslist
Or every app of these publishers, by their Sensor Tower ids.
Countriescountrieslist
Which countries, or Worldwide on its own. Leave empty for every country.One or more of: WW (Worldwide), AE (United Arab Emirates), AO (Angola), AR (Argentina), AT (Austria), AU (Australia), AZ (Azerbaijan), BD (Bangladesh), BE (Belgium), BF (Burkina Faso), and 103 more.
Bydate_granularitytext
Add the estimates up by day (the default), week, month or quarter.One of: daily, weekly, monthly, quarterly.
Fromstart_datedateRequired
The first day to include.
Toend_datedateRequired
The last day to include.

Outputs

countnumber
How many are in this answer
estimateslist
The estimates
total_downloadsnumber
Every estimate's downloads together
total_revenuenumber
Every estimate's revenue together, in US dollars
Example output
{
  "count": 1,
  "estimates": [
    {
      "app_id": "284882215",
      "country": "US",
      "date": "2026-11-15",
      "downloads": 1594,
      "raw": {
        "aid": 284882215,
        "ar": 1815,
        "au": 135,
        "cc": "US",
        "d": "2026-11-15T00:00:00Z",
        "ir": 200438,
        "iu": 1459
      },
      "revenue": 2022.53
    }
  ],
  "total_downloads": 1594,
  "total_revenue": 2022.53
}

Get ranking history

Get where apps stood on a category's top charts each day, by chart and country. Defaults to the last 90 days.

Inputs

PlatformplatformtextRequired
Which store: the App Store or Google Play.One of: ios (App Store (iOS)), android (Google Play (Android)).
Appsapp_idslistRequired
The apps, by their Sensor Tower ids: 284882215 for an App Store app, com.facebook.katana for a Google Play app, or a unified id. Find them with 'Search apps and publishers'.
CategorycategorytextRequired
The store category.One of: 0 (App Store: Overall), 6000 (App Store: Business), 6001 (App Store: Weather), 6002 (App Store: Utilities), 6003 (App Store: Travel), 6004 (App Store: Sports), 6005 (App Store: Social Networking), 6006 (App Store: Reference), 6007 (App Store: Productivity), 6008 (App Store: Photo & Video), and 98 more.
Chartschart_typeslistRequired
Which charts.One or more of: topfreeapplications (Top Free iPhone Apps), toppaidapplications (Top Paid iPhone Apps), topgrossingapplications (Top Grossing iPhone Apps), topfreeipadapplications (Top Free iPad Apps), toppaidipadapplications (Top Paid iPad Apps), topgrossingipadapplications (Top Grossing iPad Apps), topselling_free (Top Free Android Apps), topselling_paid (Top Paid Android Apps), topgrossing (Top Grossing Android Apps), topselling_new_free (Top New Free Android Apps), topselling_new_paid (Top New Paid Android Apps).
CountriescountrieslistRequired
Which countries.One or more of: AE (United Arab Emirates), AO (Angola), AR (Argentina), AT (Austria), AU (Australia), AZ (Azerbaijan), BD (Bangladesh), BE (Belgium), BF (Burkina Faso), BG (Bulgaria), and 102 more.
Fromstart_datedate
The first day to include.
Toend_datedate
The last day to include.

Outputs

historyobject
Sensor Tower's answer as it gives it: by app id, then country, category and chart
Example output
{
  "history": {
    "284882215": {
      "US": {
        "6005": {
          "topfreeapplications": {
            "graphData": [
              [
                1787097600,
                4,
                null
              ],
              [
                1787184000,
                3,
                null
              ]
            ],
            "name": "Facebook"
          }
        }
      }
    }
  }
}

Get reviews

Get an app's store reviews in one country, filtered by stars, words or dates. Gets one page; to see more, run it again with the next page.

Inputs

PlatformplatformtextRequired
Which store: the App Store or Google Play.One of: ios (App Store (iOS)), android (Google Play (Android)).
Appapp_idtextRequired
The app's id on its store: 284882215 on the App Store, or com.facebook.katana on Google Play. Find it with 'Search apps and publishers'.
Countrycountrytext
Which country's store. Defaults to the United States.One of: AE (United Arab Emirates), AO (Angola), AR (Argentina), AT (Austria), AU (Australia), AZ (Azerbaijan), BD (Bangladesh), BE (Belgium), BF (Burkina Faso), BG (Bulgaria), and 102 more.
Fromstart_datedate
The first day to include.
Toend_datedate
The last day to include.
Starsratingtext
Only positive or negative reviews, or one star rating.One of: positive (Positive (4 and 5 stars)), negative (Negative (1 and 2 stars)), 5 (5 stars), 4 (4 stars), 3 (3 stars), 2 (2 stars), 1 (1 star).
Containingsearch_termtext
Only reviews with these words in them.
By reviewerusernametext
Only reviews by this reviewer name.
How manylimitnumber
How many to return, up to 200. Sensor Tower's default is 10.From 1 to 200.
Pagepagenumber
Which page of results, starting at 1.At least 1.

Outputs

countnumber
How many are in this answer
page_countnumber
How many pages of reviews match
reviewslist
The reviews
total_countnumber
How many reviews match, on every page
Example output
{
  "count": 1,
  "page_count": 1,
  "reviews": [
    {
      "content": "Perfect for my commute.",
      "country": "US",
      "date": "2026-11-15T00:00:00Z",
      "id": "9299021703023140000",
      "rating": 5
    }
  ],
  "total_count": 1
}

Get top ads

Get the top ads on one ad network in a category and country over a week, month or quarter.

Inputs

Platformplatformtext
Which store's ads: the App Store, Google Play, or both combined (the default, which takes unified app ids).One of: ios (App Store (iOS)), android (Google Play (Android)), unified (Both stores, combined (unified)).
Period startingperiod_startdateRequired
The start of the period to rank. Sensor Tower moves it to the start of its week (a Monday), month, quarter or year.
Periodperiodtext
How long a period, from its start. Defaults to a month.One of: week, month, quarter.
CategorycategorytextRequired
The store category. App Store categories are used for both stores combined.One of: 0 (App Store: Overall), 6000 (App Store: Business), 6001 (App Store: Weather), 6002 (App Store: Utilities), 6003 (App Store: Travel), 6004 (App Store: Sports), 6005 (App Store: Social Networking), 6006 (App Store: Reference), 6007 (App Store: Productivity), 6008 (App Store: Photo & Video), and 98 more.
CountrycountrytextRequired
Which country.One of: AE (United Arab Emirates), AO (Angola), AR (Argentina), AT (Austria), AU (Australia), AZ (Azerbaijan), BD (Bangladesh), BE (Belgium), BF (Burkina Faso), BG (Bulgaria), and 102 more.
Ad networknetworktextRequired
Which ad network.One of: Adcolony, Admob, Applovin, BidMachine, Chartboost, Digital Turbine, Facebook, InMobi, Instagram, Line, and 16 more.
Ad typesad_typeslistRequired
Which kinds of ad to include, such as video or playable.One or more of: image (Image (all)), image-banner (Image banner), image-interstitial (Image interstitial), image-other (Other image), banner, full_screen (Full screen), video (Video (all)), video-rewarded (Rewarded video), video-interstitial (Video interstitial), video-other (Other video), and 4 more.
Only new adsnew_onlytrue/false
Only ads first seen in the period asked about.
How manylimittext
How many to return. Sensor Tower's default is 25.One of: 25, 100, 250.
Pagepagenumber
Which page of results, starting at 1.At least 1.

Outputs

ad_unitslist
The ads, top first
available_networkslist
The networks Sensor Tower has ads from
countnumber
How many ads match, on every page
Example output
{
  "ad_units": [
    {
      "ad_type": "video",
      "app_id": "5f16a8019f7b275235017614",
      "app_info": {
        "name": "Royal Match",
        "publisher_name": "Dream Games"
      },
      "creatives": [
        {
          "button_text": "Install",
          "creative_url": "https://x-ad-assets.s3.amazonaws.com/media_asset/1/media",
          "height": 1920,
          "id": "6431a2b9a1f2b30001c1d2e3",
          "message": "Match three and win!",
          "thumb_url": "https://x-ad-assets.s3.amazonaws.com/media_asset/1/thumb",
          "width": 1080
        }
      ],
      "first_seen_at": "2026-10-02T00:00:00Z",
      "id": "6431a2b9a1f2b30001c1d2e0",
      "last_seen_at": "2026-11-14T00:00:00Z",
      "network": "TikTok"
    }
  ],
  "available_networks": [
    "TikTok"
  ],
  "count": 1
}

Get top advertisers

Rank the apps (or the publishers showing ads) with the biggest share of ad impressions in a category and country over a period.

Inputs

Platformplatformtext
Which store's ads: the App Store, Google Play, or both combined (the default, which takes unified app ids).One of: ios (App Store (iOS)), android (Google Play (Android)), unified (Both stores, combined (unified)).
Rankroletext
Advertisers (the default) or the publishers showing their ads.One of: advertisers, publishers (Publishers showing ads).
Period startingperiod_startdateRequired
The start of the period to rank. Sensor Tower moves it to the start of its week (a Monday), month, quarter or year.
Periodperiodtext
How long a period, from its start. Defaults to a month.One of: week, month, quarter.
CategorycategorytextRequired
The store category. App Store categories are used for both stores combined.One of: 0 (App Store: Overall), 6000 (App Store: Business), 6001 (App Store: Weather), 6002 (App Store: Utilities), 6003 (App Store: Travel), 6004 (App Store: Sports), 6005 (App Store: Social Networking), 6006 (App Store: Reference), 6007 (App Store: Productivity), 6008 (App Store: Photo & Video), and 98 more.
CountrycountrytextRequired
Which country.One of: AE (United Arab Emirates), AO (Angola), AR (Argentina), AT (Austria), AU (Australia), AZ (Azerbaijan), BD (Bangladesh), BE (Belgium), BF (Burkina Faso), BG (Bulgaria), and 102 more.
Ad networknetworktext
One ad network, or all of them (the default).One of: All Networks, Adcolony, Admob, Applovin, BidMachine, Chartboost, Digital Turbine, Facebook, InMobi, Instagram, and 17 more.
How manylimittext
How many to return. Sensor Tower's default is 25.One of: 25, 100, 250.
Pagepagenumber
Which page of results, starting at 1.At least 1.

Outputs

appslist
The advertisers, top first
countnumber
How many are in this answer
pagesnumber
How many pages there are
Example output
{
  "apps": [
    {
      "app_id": "5f16a8019f7b275235017614",
      "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/royal/150x150bb.png",
      "name": "Royal Match",
      "publisher_id": "5f16a7f99f7b275235017613",
      "publisher_name": "Dream Games",
      "sov": 0.083
    }
  ],
  "count": 1,
  "pages": 4
}

Get top apps by active users

Rank apps in a category by estimated daily, weekly or monthly active users in a period, or by how much that grew.

Inputs

PlatformplatformtextRequired
Which store's data: the App Store, Google Play or both.One of: ios (App Store (iOS)), android (Google Play (Android)), unified (Both stores, combined (unified)).
Measuremeasuretext
Daily (the default), weekly or monthly active users.One of: DAU (Daily active users), WAU (Weekly active users), MAU (Monthly active users).
Periodtime_rangetext
How long a period. Defaults to a month; monthly users can't be weekly.One of: week, month, quarter.
Categorycategorytext
The store category. App Store categories are used for both stores combined.One of: 0 (App Store: Overall), 6000 (App Store: Business), 6001 (App Store: Weather), 6002 (App Store: Utilities), 6003 (App Store: Travel), 6004 (App Store: Sports), 6005 (App Store: Social Networking), 6006 (App Store: Reference), 6007 (App Store: Productivity), 6008 (App Store: Photo & Video), and 98 more.
Period startingperiod_startdateRequired
The start of the period to rank. Sensor Tower moves it to the start of its week (a Monday), month, quarter or year.
Rank bycomparison_attributetext
Rank by the total in the period, or by the change from the period before.One of: absolute (Most in the period (default)), delta (Biggest change from the period before), transformed_delta (Biggest growth, as a share).
Countries or regionsregionslist
Which countries or regions to rank in. Leave empty for worldwide.One or more of: ASIA, CARIB (The Caribbean), CENTR_AM (Central America), EUR_UN (European Union), EUROPE, LATIN_AM (Latin America), MID_EAST (Middle East), NORTH_AM (North America), OCEANIA, SE_ASIA (Southeast Asia), and 113 more.
Devicesdevice_typetext
iPhone, iPad or both. Only the App Store splits them.Only when Platform is App Store (iOS). One of: total (iPhone and iPad (default)), iphone, ipad.
How manylimitnumber
How many to return, up to 2000. Sensor Tower's default is 25.From 1 to 2000.
Skipoffsetnumber
How many to skip, to get the next page after an earlier one.At least 0.

Outputs

appslist
The apps, top first
countnumber
How many are in this answer
Example output
{
  "apps": [
    {
      "app_id": "544007664",
      "date": "2026-10-01T00:00:00Z",
      "users_absolute": 480786661,
      "users_delta": -2198805,
      "users_market_share": 0.098,
      "users_transformed_delta": -0.0046
    }
  ],
  "count": 1
}

Get top apps by downloads or revenue

Rank apps in a category by estimated downloads or revenue in a week, month or other period, or by how much they grew. Revenue is in US cents.

Inputs

PlatformplatformtextRequired
Which store's data: the App Store, Google Play or both.One of: ios (App Store (iOS)), android (Google Play (Android)), unified (Both stores, combined (unified)).
Measuremeasuretext
Downloads (the default) or revenue.One of: units (Downloads), revenue.
Periodtime_rangetext
How long a period. Defaults to a week.One of: day, week, month, quarter, year.
CategorycategorytextRequired
The store category. App Store categories are used for both stores combined.One of: 0 (App Store: Overall), 6000 (App Store: Business), 6001 (App Store: Weather), 6002 (App Store: Utilities), 6003 (App Store: Travel), 6004 (App Store: Sports), 6005 (App Store: Social Networking), 6006 (App Store: Reference), 6007 (App Store: Productivity), 6008 (App Store: Photo & Video), and 98 more.
Period startingperiod_startdateRequired
The start of the period to rank. Sensor Tower moves it to the start of its week (a Monday), month, quarter or year.
Period endingperiod_enddate
To rank several periods together, the last day of the last one.
Rank bycomparison_attributetext
Rank by the total in the period, or by the change from the period before.One of: absolute (Most in the period (default)), delta (Biggest change from the period before), transformed_delta (Biggest growth, as a share).
Countries or regionsregionslist
Which countries or regions to rank in. Leave empty for worldwide.One or more of: ASIA, CARIB (The Caribbean), CENTR_AM (Central America), EUR_UN (European Union), EUROPE, LATIN_AM (Latin America), MID_EAST (Middle East), NORTH_AM (North America), OCEANIA, SE_ASIA (Southeast Asia), and 113 more.
Devicesdevice_typetext
iPhone, iPad or both. Only the App Store splits them.Only when Platform is App Store (iOS). One of: total (iPhone and iPad (default)), iphone, ipad.
How manylimitnumber
How many to return, up to 2000. Sensor Tower's default is 25.From 1 to 2000.
Skipoffsetnumber
How many to skip, to get the next page after an earlier one.At least 0.

Outputs

appslist
The apps, top first
countnumber
How many are in this answer
Example output
{
  "apps": [
    {
      "absolute": 2846013,
      "app_id": "546505307",
      "date": "2026-11-09T00:00:00Z",
      "delta": 1019596,
      "revenue_absolute": 0,
      "transformed_delta": 0.5582,
      "units_absolute": 2846013
    }
  ],
  "count": 1
}

Get top chart

Get the apps on one App Store or Google Play top chart, such as Top Free in Games, in a country, top first.

Inputs

PlatformplatformtextRequired
Which store: the App Store or Google Play.One of: ios (App Store (iOS)), android (Google Play (Android)).
CategorycategorytextRequired
The store category.One of: 0 (App Store: Overall), 6000 (App Store: Business), 6001 (App Store: Weather), 6002 (App Store: Utilities), 6003 (App Store: Travel), 6004 (App Store: Sports), 6005 (App Store: Social Networking), 6006 (App Store: Reference), 6007 (App Store: Productivity), 6008 (App Store: Photo & Video), and 98 more.
Chartchart_typetextRequired
Which chart, such as top free or top grossing.One of: topfreeapplications (Top Free iPhone Apps), toppaidapplications (Top Paid iPhone Apps), topgrossingapplications (Top Grossing iPhone Apps), topfreeipadapplications (Top Free iPad Apps), toppaidipadapplications (Top Paid iPad Apps), topgrossingipadapplications (Top Grossing iPad Apps), topselling_free (Top Free Android Apps), topselling_paid (Top Paid Android Apps), topgrossing (Top Grossing Android Apps), topselling_new_free (Top New Free Android Apps), topselling_new_paid (Top New Paid Android Apps).
CountrycountrytextRequired
Which country's chart.One of: AE (United Arab Emirates), AO (Angola), AR (Argentina), AT (Austria), AU (Australia), AZ (Azerbaijan), BD (Bangladesh), BE (Belgium), BF (Burkina Faso), BG (Bulgaria), and 102 more.
Onchart_datedate
The chart of this day. Leave empty for the latest.

Outputs

app_idslist
The apps' ids, number 1 first
categorytext
The category
chart_typetext
The chart
countnumber
How many are in this answer
countrytext
The country
datetext
The chart's day
Example output
{
  "app_ids": [
    "1500855883",
    "835599320",
    "389801252"
  ],
  "category": "6014",
  "chart_type": "topfreeapplications",
  "count": 3,
  "country": "US",
  "date": "2026-11-16"
}

Get top publishers

Rank publishers in a category by estimated downloads or revenue in a period, with their apps that count. Revenue is in US cents.

Inputs

PlatformplatformtextRequired
Which store's data: the App Store, Google Play or both.One of: ios (App Store (iOS)), android (Google Play (Android)), unified (Both stores, combined (unified)).
Measuremeasuretext
Downloads (the default) or revenue.One of: units (Downloads), revenue.
Periodtime_rangetext
How long a period. Defaults to a week.One of: day, week, month, quarter, year.
CategorycategorytextRequired
The store category. App Store categories are used for both stores combined.One of: 0 (App Store: Overall), 6000 (App Store: Business), 6001 (App Store: Weather), 6002 (App Store: Utilities), 6003 (App Store: Travel), 6004 (App Store: Sports), 6005 (App Store: Social Networking), 6006 (App Store: Reference), 6007 (App Store: Productivity), 6008 (App Store: Photo & Video), and 98 more.
Period startingperiod_startdateRequired
The start of the period to rank. Sensor Tower moves it to the start of its week (a Monday), month, quarter or year.
Period endingperiod_enddate
To rank several periods together, the last day of the last one.
Rank bycomparison_attributetext
Rank by the total in the period, or by the change from the period before.One of: absolute (Most in the period (default)), delta (Biggest change from the period before), transformed_delta (Biggest growth, as a share).
Country or regioncountrytext
Where to rank. Leave empty for worldwide.One of: ASIA, CARIB (The Caribbean), CENTR_AM (Central America), EUR_UN (European Union), EUROPE, LATIN_AM (Latin America), MID_EAST (Middle East), NORTH_AM (North America), OCEANIA, SE_ASIA (Southeast Asia), and 113 more.
Devicesdevice_typetext
iPhone, iPad or both. Only the App Store splits them.Only when Platform is App Store (iOS). One of: total (iPhone and iPad (default)), iphone, ipad.
How manylimitnumber
How many to return, up to 2000. Sensor Tower's default is 25.From 1 to 2000.
Skipoffsetnumber
How many to skip, to get the next page after an earlier one.At least 0.

Outputs

countnumber
How many are in this answer
publisherslist
The publishers, top first
Example output
{
  "count": 1,
  "publishers": [
    {
      "apps": [
        {
          "app_id": "1113153706",
          "name": "Microsoft Teams"
        }
      ],
      "date": "2026-11-09T00:00:00Z",
      "publisher_id": "298856275",
      "publisher_name": "Microsoft Corporation",
      "revenue_absolute": 2348517,
      "revenue_delta": 90412,
      "units_absolute": 3179744,
      "units_delta": 1691177
    }
  ]
}

List a publisher's apps

List a publisher's apps on one store, or every app of a publisher across both stores. Gets one page; to see more, run it again with Skip set.

Inputs

PlatformplatformtextRequired
Which store's data: the App Store, Google Play or both.One of: ios (App Store (iOS)), android (Google Play (Android)), unified (Both stores, combined (unified)).
Publisherpublisher_idtextRequired
The publisher's Sensor Tower id, from 'Search apps and publishers' with Find set to publishers. For both stores combined, a unified publisher or app id.
How manylimitnumber
How many to return, up to 100. Sensor Tower's default is 20.From 1 to 100.
Skipoffsetnumber
How many to skip, to get the next page after an earlier one.At least 0.

Outputs

appslist
The publisher's apps
countnumber
How many are in this answer
publisher_nametext
The publisher's name, when Sensor Tower gives it
Example output
{
  "apps": [
    {
      "app_id": "324684580",
      "name": "Spotify",
      "os": "ios"
    }
  ],
  "count": 1,
  "publisher_name": "Spotify"
}

Match apps across stores

Get the App Store and Google Play versions of each app under its unified id, from either store's ids or unified ids.

Inputs

Appsapp_idslistRequired
The apps, by the kind of id chosen in 'Ids are'. Up to 100.
Ids areid_typetextRequired
Which kind of id the apps are given as.One of: itunes (App Store app ids), android (Google Play app ids), unified (Unified app ids).

Outputs

appslist
The unified apps
countnumber
How many are in this answer
Example output
{
  "apps": [
    {
      "android_apps": [
        {
          "app_id": "com.facebook.katana"
        }
      ],
      "android_publisher_ids": [
        "Meta Platforms, Inc."
      ],
      "itunes_apps": [
        {
          "app_id": 284882215
        }
      ],
      "itunes_publisher_ids": [
        284882218
      ],
      "name": "Facebook",
      "unified_app_id": "55c5022302ac64f9c0001f86",
      "unified_publisher_ids": [
        "560c48b48ac350643900b82d"
      ]
    }
  ],
  "count": 1
}

Search apps and publishers

Find apps or publishers by name, or by words in their store listing, and get the Sensor Tower ids the other steps take.

Inputs

Search fortermtextRequired
A name or words to look for, at least 3 letters.
Platformplatformtext
Which store to search. Both stores combined (the default) gives unified ids; listed separately gives each store's own.One of: ios (App Store (iOS)), android (Google Play (Android)), unified (Both stores, combined (unified)), both_stores (Both stores, listed separately).
Findentity_typetext
Apps (the default) or publishers.One of: app (Apps), publisher (Publishers).
How manylimitnumber
How many to return, up to 250. Sensor Tower's default is 100.From 1 to 250.

Outputs

countnumber
How many are in this answer
resultslist
The matches
Example output
{
  "count": 1,
  "results": [
    {
      "app_id": "55c5027502ac64f9c0001fa6",
      "entity_type": "app",
      "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/spotify/150x150bb.png",
      "name": "Spotify: Music and Podcasts",
      "os": "unified",
      "publisher_id": "560c48ea02ac64f9c0002a5a",
      "publisher_name": "Spotify"
    }
  ]
}

On this page