Category Metrics

Get access to the Market Intelligence data from AppTweak. The Market Size corresponds to the category downloads or revenues for a specific country and a category type ("free" or "paid") which can be accessed through the Category Metrics - History endpoint.

Category Metrics - History

Category Metrics is available for iOS & Android. Downloads and revenues metrics are estimated based on data science algorithms from AppTweak. The revenues are expressed in USD in the API endpoint response. The data is updated everyday.

Query parameters

Response format

Results are returned in a JSON format. For category downloads, the response pattern is the following:

{
  "result": {
    "category_id": {
      "country_code": [
        {
          "date": <string>
          "downloads": <int> 
        },
        ...
      ]
    }
  },
  "metadata": {
    "request": {
      "path": "/api/public/store/categories/metrics",
      "params": {
        "device": <string> // iphone, ipad or android,
        "start_date": <string>, // start date in the format YYYY-MM-DD 
        "end_date": <string>,// end date in the format YYYY-MM-DD 
        "categories": [
          category_id // App Store or Google Play Store category code
        ],
        "countries": [
          country_code // 2 letter country code
        ],
        "metric": "downloads",
        "type": <string> // free or paid
      },
      "cost": ,
      "max_credit_cost": <int>,
      "status": <int>
    },
    "response": null
  }
}

For category revenues, the response pattern in the following:

{
  "result": {
    "category_id": {
      "country_code": [
        {
          "date": <string>
          "revenues": <float> 
        },
        ...
      ]
    }
  },
  "metadata": {
    "request": {
      "path": "/api/public/store/categories/metrics",
      "params": {
        "device": <string> // iphone or android,
        "start_date": <string>, // start date in the format YYYY-MM-DD 
        "end_date": <string>,// end date in the format YYYY-MM-DD 
        "categories": [
          category_id // App Store or Google Play Store category code
        ],
        "countries": [
          country_code // 2 letter country code
        ],
        "metric": "revenues",
        "type": <string> // free or paid
      },
      "cost": ,
      "max_credit_cost": <int>,
      "status": <int>
    },
    "response": null
  }
}

The results will be an array of objects containing the date and the metric on that day. The list of objects are not necessarily sorted in a chronological order.

AppTweak tool

The data provided with the Category Metrics - History endpoint is also used in the tool of AppTweak. You can find Market Size data in the Market Intelligence menu of AppTweak. It is the first section of the menu, indicated by the red arrow in the graph below.

You can get the same data shown on the graph above with the API. The response format will be following.

FAQs

How do I fetch download estimates for an entire app store category via API?

You can pull category-level download estimates with AppTweak's Category Metrics - History endpoint (GET /categories/metrics), by setting metric=downloads along with up to 5 categories and up to 5 countries. The response returns a daily downloads figure per category and country for the requested date range, estimated with AppTweak's data science models rather than sourced from Apple or Google directly. Data is available for both iOS and Android, going back to 2019-01-01, and refreshes daily.

Can I get market size or revenue data for an app category instead of a single app?

Yes — AppTweak's Category Metrics - History endpoint returns aggregate revenue for an entire category, not any individual app's revenue. Set metric=revenues with the target categories and countries; the response returns a daily revenues value in USD per category/country combination. To size a market, this is the right endpoint; to get one specific app's own download or revenue numbers, use the App Metrics endpoint instead, which reports at the app level.

What parameters does the category-level download and revenue endpoint accept?

AppTweak's Category Metrics - History endpoint requires three parameters: metric ("downloads" or "revenues"), categories (up to 5 App Store or Google Play category IDs), and countries (up to 5 two-letter country codes). Optional parameters narrow the query further: start_date and end_date (default: last 30 days, data available from 2019-01-01), type ("free" or "paid", default "free"), and device ("iphone" or "android", default "iphone"). Only one metric value can be requested per call.

How do I compare market size across free and paid apps in the same category?

You can set the type parameter to free or paid on a Category Metrics - History call, since AppTweak tracks free and paid app charts separately per category. Running the same categories/countries/date range once with type=free and once with type=paid returns two comparable daily series — one for the free chart, one for the paid chart — so a category's paid-app market size can be benchmarked against its free-app market size without mixing the two populations.

Why does the category metrics endpoint return an estimate instead of an exact number?

Category downloads and revenues are AppTweak's own data-science estimates, since app stores don't publish exact download or revenue figures per category. The endpoint models these figures from public signals like chart positions, ratings velocity, and category structure, refreshed daily, rather than pulling a number Apple or Google discloses directly. That's why the response documents each value as an "AppTweak estimation" rather than an official first-party figure, and why it should be read as a market-sizing signal, not an audited total.