# Sensor Tower

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

App · 21 actions. Web page: https://docs.lodol.com/docs/integrations/sensor-tower

## Actions

### 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 (`platform`, text, required): Which store: the App Store or Google Play. One of: `ios` (App Store (iOS)), `android` (Google Play (Android)).
- Category (`category`, text, required): 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_after`, date): Only apps released on or after this day.
- Updated on or after (`updated_on_or_after`, date): Only apps updated on or after this day.
- How many (`limit`, number): How many to return, up to 10000. Sensor Tower's default is 1000. From 1 to 10000.
- Skip (`offset`, number): How many to skip, to get the next page after an earlier one. At least 0.

**Outputs**

- `app_ids` (list): The apps' ids, oldest release first
- `count` (number): How many are in this answer
- `date_range` (list): When the first and the last of these apps were released

**Example output**

```json
{
  "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 (`platform`, text, required): 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_ids`, list, required): The apps, by their Sensor Tower ids (unified ids for both stores combined). Up to 500.
- Measure (`time_period`, text): Daily (the default), weekly or monthly active users. One of: `day` (Daily active users), `week` (Weekly active users), `month` (Monthly active users).
- Countries (`countries`, list): 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_date`, date, required): The first day to include.
- To (`end_date`, date, required): The last day to include.

**Outputs**

- `active_users` (list): The figures
- `count` (number): How many are in this answer

**Example output**

```json
{
  "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 (`platform`, text): 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_ids`, list, required): 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_date`, date, required): The first day to include.
- To (`end_date`, date, required): The last day to include.
- By (`period`, text): Day (the default) or week. One of: `day`, `week`.
- Ad networks (`networks`, list): 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 (`countries`, list): 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**

- `count` (number): How many are in this answer
- `ranks` (list): The ranks

**Example output**

```json
{
  "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 (`platform`, text): 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_ids`, list, required): 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_date`, date, required): The first day to include.
- To (`end_date`, date, required): The last day to include.
- By (`period`, text): Day (the default), week or month. One of: `day`, `week`, `month`.
- Ad networks (`networks`, list): 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 (`countries`, list): 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**

- `count` (number): How many are in this answer
- `share_of_voice` (list): The figures

**Example output**

```json
{
  "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 (`platform`, text): 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_ids`, list, required): The advertising apps, by unified id unless Platform is one store.
- From (`start_date`, date, required): The first day to include.
- To (`end_date`, date): The last day. Defaults to today.
- Countries (`countries`, list, required): 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 (`networks`, list, required): Which ad networks. One or more of: `Adcolony`, `Admob`, `Applovin`, `BidMachine`, `Chartboost`, `Digital Turbine`, `Facebook`, `InMobi`, `Instagram`, `Line`, and 16 more.
- Ad types (`ad_types`, list, required): 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_only`, true/false): Only ads first seen in the period asked about.
- How many (`limit`, text): How many to return. Sensor Tower's default is 10. One of: `10`, `50`, `100`.
- Page (`page`, number): Which page of results, starting at 1. At least 1.

**Outputs**

- `ad_units` (list): The ads
- `available_networks` (list): The networks Sensor Tower has ads from
- `count` (number): How many ads match, on every page

**Example output**

```json
{
  "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 (`month`, date): Any day in the month to report on. Leave empty for this month.

**Outputs**

- `month` (text): The month, as YYYY-MM
- `organization` (object): Your organisation's use
- `remaining` (number): Requests left in the month
- `user` (object): This token's use

**Example output**

```json
{
  "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 (`platform`, text, required): Which store: the App Store or Google Play. One of: `ios` (App Store (iOS)), `android` (Google Play (Android)).
- Apps (`app_ids`, list, required): 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 (`country`, text): 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**

- `apps` (list): The apps
- `count` (number): How many are in this answer

**Example output**

```json
{
  "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 (`platform`, text, required): Which store: the App Store or Google Play. One of: `ios` (App Store (iOS)), `android` (Google Play (Android)).
- Apps (`app_ids`, list, required): The apps, by their store ids, such as 284882215 or com.facebook.katana. Up to 500.
- Over (`date_granularity`, text): All time (the default) or each quarter. One of: `all_time` (All time), `quarterly`.
- Country or region (`country`, text): 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_date`, date, required): The first day to include.
- To (`end_date`, date): The last day to include.

**Outputs**

- `apps` (list): Each app's audience
- `baseline` (object): The audience of every app together, to compare with, by gender and age band
- `count` (number): How many are in this answer
- `disabled_app_ids` (list): Apps asked about that have too few users for an estimate

**Example output**

```json
{
  "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 (`platform`, text): 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_ids`, list, required): The apps, by their unified ids (from 'Search apps and publishers' with Platform set to both stores combined).
- Countries (`countries`, list, required): 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_granularity`, text): Monthly (the default) or daily. One of: `monthly` (Monthly (default)), `daily`.
- From (`start_date`, date, required): The first day to include.
- To (`end_date`, date, required): The last day to include.

**Outputs**

- `apps` (list): Each app's breakdown
- `count` (number): How many are in this answer

**Example output**

```json
{
  "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 (`platform`, text, required): 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_ids`, list): 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_ids`, list): Or every app of these publishers, by their Sensor Tower ids.
- Countries (`countries`, list): 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_granularity`, text): Add the estimates up by day (the default), week, month or quarter. One of: `daily`, `weekly`, `monthly`, `quarterly`.
- From (`start_date`, date, required): The first day to include.
- To (`end_date`, date, required): The last day to include.

**Outputs**

- `count` (number): How many are in this answer
- `estimates` (list): The estimates
- `total_downloads` (number): Every estimate's downloads together
- `total_revenue` (number): Every estimate's revenue together, in US dollars

**Example output**

```json
{
  "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 (`platform`, text, required): Which store: the App Store or Google Play. One of: `ios` (App Store (iOS)), `android` (Google Play (Android)).
- Apps (`app_ids`, list, required): 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 (`category`, text, required): 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_types`, list, required): 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 (`countries`, list, required): 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_date`, date): The first day to include.
- To (`end_date`, date): The last day to include.

**Outputs**

- `history` (object): Sensor Tower's answer as it gives it: by app id, then country, category and chart

**Example output**

```json
{
  "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 (`platform`, text, required): Which store: the App Store or Google Play. One of: `ios` (App Store (iOS)), `android` (Google Play (Android)).
- App (`app_id`, text, required): 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 (`country`, text): 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_date`, date): The first day to include.
- To (`end_date`, date): The last day to include.
- Stars (`rating`, text): 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_term`, text): Only reviews with these words in them.
- By reviewer (`username`, text): Only reviews by this reviewer name.
- How many (`limit`, number): How many to return, up to 200. Sensor Tower's default is 10. From 1 to 200.
- Page (`page`, number): Which page of results, starting at 1. At least 1.

**Outputs**

- `count` (number): How many are in this answer
- `page_count` (number): How many pages of reviews match
- `reviews` (list): The reviews
- `total_count` (number): How many reviews match, on every page

**Example output**

```json
{
  "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 (`platform`, text): 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_start`, date, required): The start of the period to rank. Sensor Tower moves it to the start of its week (a Monday), month, quarter or year.
- Period (`period`, text): How long a period, from its start. Defaults to a month. One of: `week`, `month`, `quarter`.
- Category (`category`, text, required): 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 (`country`, text, required): 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 (`network`, text, required): Which ad network. One of: `Adcolony`, `Admob`, `Applovin`, `BidMachine`, `Chartboost`, `Digital Turbine`, `Facebook`, `InMobi`, `Instagram`, `Line`, and 16 more.
- Ad types (`ad_types`, list, required): 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_only`, true/false): Only ads first seen in the period asked about.
- How many (`limit`, text): How many to return. Sensor Tower's default is 25. One of: `25`, `100`, `250`.
- Page (`page`, number): Which page of results, starting at 1. At least 1.

**Outputs**

- `ad_units` (list): The ads, top first
- `available_networks` (list): The networks Sensor Tower has ads from
- `count` (number): How many ads match, on every page

**Example output**

```json
{
  "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 (`platform`, text): 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 (`role`, text): Advertisers (the default) or the publishers showing their ads. One of: `advertisers`, `publishers` (Publishers showing ads).
- Period starting (`period_start`, date, required): The start of the period to rank. Sensor Tower moves it to the start of its week (a Monday), month, quarter or year.
- Period (`period`, text): How long a period, from its start. Defaults to a month. One of: `week`, `month`, `quarter`.
- Category (`category`, text, required): 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 (`country`, text, required): 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 (`network`, text): 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 (`limit`, text): How many to return. Sensor Tower's default is 25. One of: `25`, `100`, `250`.
- Page (`page`, number): Which page of results, starting at 1. At least 1.

**Outputs**

- `apps` (list): The advertisers, top first
- `count` (number): How many are in this answer
- `pages` (number): How many pages there are

**Example output**

```json
{
  "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 (`platform`, text, required): 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 (`measure`, text): Daily (the default), weekly or monthly active users. One of: `DAU` (Daily active users), `WAU` (Weekly active users), `MAU` (Monthly active users).
- Period (`time_range`, text): How long a period. Defaults to a month; monthly users can't be weekly. One of: `week`, `month`, `quarter`.
- Category (`category`, text): 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_start`, date, required): 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_attribute`, text): 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 (`regions`, list): 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_type`, text): 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 (`limit`, number): How many to return, up to 2000. Sensor Tower's default is 25. From 1 to 2000.
- Skip (`offset`, number): How many to skip, to get the next page after an earlier one. At least 0.

**Outputs**

- `apps` (list): The apps, top first
- `count` (number): How many are in this answer

**Example output**

```json
{
  "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 (`platform`, text, required): 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 (`measure`, text): Downloads (the default) or revenue. One of: `units` (Downloads), `revenue`.
- Period (`time_range`, text): How long a period. Defaults to a week. One of: `day`, `week`, `month`, `quarter`, `year`.
- Category (`category`, text, required): 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_start`, date, required): 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_end`, date): To rank several periods together, the last day of the last one.
- Rank by (`comparison_attribute`, text): 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 (`regions`, list): 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_type`, text): 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 (`limit`, number): How many to return, up to 2000. Sensor Tower's default is 25. From 1 to 2000.
- Skip (`offset`, number): How many to skip, to get the next page after an earlier one. At least 0.

**Outputs**

- `apps` (list): The apps, top first
- `count` (number): How many are in this answer

**Example output**

```json
{
  "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 (`platform`, text, required): Which store: the App Store or Google Play. One of: `ios` (App Store (iOS)), `android` (Google Play (Android)).
- Category (`category`, text, required): 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_type`, text, required): 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 (`country`, text, required): 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_date`, date): The chart of this day. Leave empty for the latest.

**Outputs**

- `app_ids` (list): The apps' ids, number 1 first
- `category` (text): The category
- `chart_type` (text): The chart
- `count` (number): How many are in this answer
- `country` (text): The country
- `date` (text): The chart's day

**Example output**

```json
{
  "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 (`platform`, text, required): 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 (`measure`, text): Downloads (the default) or revenue. One of: `units` (Downloads), `revenue`.
- Period (`time_range`, text): How long a period. Defaults to a week. One of: `day`, `week`, `month`, `quarter`, `year`.
- Category (`category`, text, required): 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_start`, date, required): 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_end`, date): To rank several periods together, the last day of the last one.
- Rank by (`comparison_attribute`, text): 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 (`country`, text): 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_type`, text): 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 (`limit`, number): How many to return, up to 2000. Sensor Tower's default is 25. From 1 to 2000.
- Skip (`offset`, number): How many to skip, to get the next page after an earlier one. At least 0.

**Outputs**

- `count` (number): How many are in this answer
- `publishers` (list): The publishers, top first

**Example output**

```json
{
  "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 (`platform`, text, required): 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_id`, text, required): 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 (`limit`, number): How many to return, up to 100. Sensor Tower's default is 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, to get the next page after an earlier one. At least 0.

**Outputs**

- `apps` (list): The publisher's apps
- `count` (number): How many are in this answer
- `publisher_name` (text): The publisher's name, when Sensor Tower gives it

**Example output**

```json
{
  "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_ids`, list, required): The apps, by the kind of id chosen in 'Ids are'. Up to 100.
- Ids are (`id_type`, text, required): 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**

- `apps` (list): The unified apps
- `count` (number): How many are in this answer

**Example output**

```json
{
  "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 (`term`, text, required): A name or words to look for, at least 3 letters.
- Platform (`platform`, text): 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_type`, text): Apps (the default) or publishers. One of: `app` (Apps), `publisher` (Publishers).
- How many (`limit`, number): How many to return, up to 250. Sensor Tower's default is 100. From 1 to 250.

**Outputs**

- `count` (number): How many are in this answer
- `results` (list): The matches

**Example output**

```json
{
  "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"
    }
  ]
}
```
