Returns Category Downloads or Category Revenues that AppTweak has been able to estimate

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

query parameterrequiredoptionscomment
metric✔︎Market size type: "downloads" or "revenues"Only one parameter can be passed.
Revenues are expressed in USD
categories✔︎App Store Categories and Google Play Store CategoriesMax 5 category ids are allowed
countries✔︎List of country codesMax 5 country codes are allowed
start_date–Start date of the period in format YYYY-MM-DDDefault: 30 days ago
⚠️ Data available from 2019-01-01 onwards
end_date–End date of the period in format YYYY-MM-DDDefault: yesterday
type–Chart type: "free" or "paid"Default: "free"
device–Type of device: "iphone" or "android"Default: "iphone"

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 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.

response parametersDescriptionOriginHistorical Data?
downloadsThe daily number of downloads generated the categoryAppTweak estimation✅ - starting from 01/2019
revenuesThe daily number of revenues generated the category. Expressed in USD.AppTweak estimation✅ - starting from 01/2019

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.

13411341

Market Intelligence menu from AppTweak's tool. The orange boxes correspond to the query parameters that can be changed in the API request. The red arrow indicates the sub-menu "Market Size" from the Market Intelligence menu of AppTweak.

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

675675

API response from "Category Metrics - History" for the downloads of the Music Category on iOS from the 2022-11-01 till 2022-11-07 in the UK, Germany and France.