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
| Action | What it does |
|---|---|
| Find new apps in a category | Get the ids of apps in a store category released, or updated, on or after a date. |
| Get active users | Get Sensor Tower's estimates of apps' daily, weekly or monthly active users, by country. |
| Get ad network ranks | Get where apps rank among advertisers on each ad network, by country and day or week. |
| Get ad share of voice | Get each app's share of ad impressions by ad network, country and day, week or month. |
| 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. |
| Get API usage | Get how many API requests your organisation and this token have used in a month, and how many are left. |
| Get app details | Get the store details of up to 100 apps: name, publisher, categories, rating, price, release date and description. |
| Get audience demographics | Get the gender and age of apps' users, for all time or by quarter, worldwide or in one country or region. |
| Get download sources | Get how many of apps' downloads were organic, from paid ads or from a browser, by day or month. |
| Get downloads and revenue | Get Sensor Tower's estimates of apps' downloads and revenue by country and day, week, month or quarter. |
| Get ranking history | Get where apps stood on a category's top charts each day, by chart and country. |
| Get reviews | Get an app's store reviews in one country, filtered by stars, words or dates. |
| Get top ads | Get the top ads on one ad network in a category and country over a week, month or quarter. |
| 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. |
| 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. |
| 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. |
| 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. |
| Get top publishers | Rank publishers in a category by estimated downloads or revenue in a period, with their apps that count. |
| List a publisher's apps | List a publisher's apps on one store, or every app of a publisher across both stores. |
| 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. |
| 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. |
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
- Platform
platformtextRequired - Which store: the App Store or Google Play.One of:
ios(App Store (iOS)),android(Google Play (Android)). - Category
categorytextRequired - 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 after
released_on_or_afterdate - Only apps released on or after this day.
- Updated on or after
updated_on_or_afterdate - Only apps updated on or after this day.
- How many
limitnumber - How many to return, up to 10000. Sensor Tower's default is 1000.From 1 to 10000.
- Skip
offsetnumber - 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
- Platform
platformtextRequired - 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)). - Apps
app_idslistRequired - The apps, by their Sensor Tower ids (unified ids for both stores combined). Up to 500.
- Measure
time_periodtext - Daily (the default), weekly or monthly active users.One of:
day(Daily active users),week(Weekly active users),month(Monthly active users). - Countries
countrieslist - 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. - From
start_datedateRequired - The first day to include.
- To
end_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
- Platform
platformtext - 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)). - Apps
app_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'.
- From
start_datedateRequired - The first day to include.
- To
end_datedateRequired - The last day to include.
- By
periodtext - Day (the default) or week.One of:
day,week. - Ad networks
networkslist - 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. - Countries
countrieslist - 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
- Platform
platformtext - 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)). - Apps
app_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'.
- From
start_datedateRequired - The first day to include.
- To
end_datedateRequired - The last day to include.
- By
periodtext - Day (the default), week or month.One of:
day,week,month. - Ad networks
networkslist - 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. - Countries
countrieslist - 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
- Platform
platformtext - 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)). - Apps
app_idslistRequired - The advertising apps, by unified id unless Platform is one store.
- From
start_datedateRequired - The first day to include.
- To
end_datedate - The last day. Defaults to today.
- Countries
countrieslistRequired - 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 networks
networkslistRequired - Which ad networks.One or more of:
Adcolony,Admob,Applovin,BidMachine,Chartboost,Digital Turbine,Facebook,InMobi,Instagram,Line, and 16 more. - Ad types
ad_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 ads
new_onlytrue/false - Only ads first seen in the period asked about.
- How many
limittext - How many to return. Sensor Tower's default is 10.One of:
10,50,100. - Page
pagenumber - 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
- Month
monthdate - 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
- Platform
platformtextRequired - Which store: the App Store or Google Play.One of:
ios(App Store (iOS)),android(Google Play (Android)). - Apps
app_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'.
- Country
countrytext - 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
- Platform
platformtextRequired - Which store: the App Store or Google Play.One of:
ios(App Store (iOS)),android(Google Play (Android)). - Apps
app_idslistRequired - The apps, by their store ids, such as 284882215 or com.facebook.katana. Up to 500.
- Over
date_granularitytext - All time (the default) or each quarter.One of:
all_time(All time),quarterly. - Country or region
countrytext - 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. - From
start_datedateRequired - The first day to include.
- To
end_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
- Platform
platformtext - 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)). - Apps
app_idslistRequired - The apps, by their unified ids (from 'Search apps and publishers' with Platform set to both stores combined).
- Countries
countrieslistRequired - 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. - By
date_granularitytext - Monthly (the default) or daily.One of:
monthly(Monthly (default)),daily. - From
start_datedateRequired - The first day to include.
- To
end_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
- Platform
platformtextRequired - 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)). - Apps
app_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'.
- Publishers
publisher_idslist - Or every app of these publishers, by their Sensor Tower ids.
- Countries
countrieslist - 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. - By
date_granularitytext - Add the estimates up by day (the default), week, month or quarter.One of:
daily,weekly,monthly,quarterly. - From
start_datedateRequired - The first day to include.
- To
end_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
- Platform
platformtextRequired - Which store: the App Store or Google Play.One of:
ios(App Store (iOS)),android(Google Play (Android)). - Apps
app_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'.
- Category
categorytextRequired - 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. - Charts
chart_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). - Countries
countrieslistRequired - 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. - From
start_datedate - The first day to include.
- To
end_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
- Platform
platformtextRequired - Which store: the App Store or Google Play.One of:
ios(App Store (iOS)),android(Google Play (Android)). - App
app_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'.
- Country
countrytext - 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. - From
start_datedate - The first day to include.
- To
end_datedate - The last day to include.
- Stars
ratingtext - 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). - Containing
search_termtext - Only reviews with these words in them.
- By reviewer
usernametext - Only reviews by this reviewer name.
- How many
limitnumber - How many to return, up to 200. Sensor Tower's default is 10.From 1 to 200.
- Page
pagenumber - 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
- Platform
platformtext - 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 starting
period_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
periodtext - How long a period, from its start. Defaults to a month.One of:
week,month,quarter. - Category
categorytextRequired - 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. - Country
countrytextRequired - 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 network
networktextRequired - Which ad network.One of:
Adcolony,Admob,Applovin,BidMachine,Chartboost,Digital Turbine,Facebook,InMobi,Instagram,Line, and 16 more. - Ad types
ad_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 ads
new_onlytrue/false - Only ads first seen in the period asked about.
- How many
limittext - How many to return. Sensor Tower's default is 25.One of:
25,100,250. - Page
pagenumber - 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
- Platform
platformtext - 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)). - Rank
roletext - Advertisers (the default) or the publishers showing their ads.One of:
advertisers,publishers(Publishers showing ads). - Period starting
period_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
periodtext - How long a period, from its start. Defaults to a month.One of:
week,month,quarter. - Category
categorytextRequired - 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. - Country
countrytextRequired - 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 network
networktext - 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 many
limittext - How many to return. Sensor Tower's default is 25.One of:
25,100,250. - Page
pagenumber - 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
- Platform
platformtextRequired - 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)). - Measure
measuretext - Daily (the default), weekly or monthly active users.One of:
DAU(Daily active users),WAU(Weekly active users),MAU(Monthly active users). - Period
time_rangetext - How long a period. Defaults to a month; monthly users can't be weekly.One of:
week,month,quarter. - Category
categorytext - 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 starting
period_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 by
comparison_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 regions
regionslist - 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. - Devices
device_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 many
limitnumber - How many to return, up to 2000. Sensor Tower's default is 25.From 1 to 2000.
- Skip
offsetnumber - 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
- Platform
platformtextRequired - 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)). - Measure
measuretext - Downloads (the default) or revenue.One of:
units(Downloads),revenue. - Period
time_rangetext - How long a period. Defaults to a week.One of:
day,week,month,quarter,year. - Category
categorytextRequired - 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 starting
period_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 ending
period_enddate - To rank several periods together, the last day of the last one.
- Rank by
comparison_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 regions
regionslist - 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. - Devices
device_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 many
limitnumber - How many to return, up to 2000. Sensor Tower's default is 25.From 1 to 2000.
- Skip
offsetnumber - 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
- Platform
platformtextRequired - Which store: the App Store or Google Play.One of:
ios(App Store (iOS)),android(Google Play (Android)). - Category
categorytextRequired - 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. - Chart
chart_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). - Country
countrytextRequired - 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. - On
chart_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
- Platform
platformtextRequired - 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)). - Measure
measuretext - Downloads (the default) or revenue.One of:
units(Downloads),revenue. - Period
time_rangetext - How long a period. Defaults to a week.One of:
day,week,month,quarter,year. - Category
categorytextRequired - 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 starting
period_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 ending
period_enddate - To rank several periods together, the last day of the last one.
- Rank by
comparison_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 region
countrytext - 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. - Devices
device_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 many
limitnumber - How many to return, up to 2000. Sensor Tower's default is 25.From 1 to 2000.
- Skip
offsetnumber - 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
- Platform
platformtextRequired - 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)). - Publisher
publisher_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 many
limitnumber - How many to return, up to 100. Sensor Tower's default is 20.From 1 to 100.
- Skip
offsetnumber - 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
- Apps
app_idslistRequired - The apps, by the kind of id chosen in 'Ids are'. Up to 100.
- Ids are
id_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 for
termtextRequired - A name or words to look for, at least 3 letters.
- Platform
platformtext - 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). - Find
entity_typetext - Apps (the default) or publishers.One of:
app(Apps),publisher(Publishers). - How many
limitnumber - 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"
}
]
}