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

query parameter	required	options	comment
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 Categories	Max 5 category ids are allowed
countries	✔︎	List of country codes	Max 5 country codes are allowed
start_date	–	Start date of the period in format YYYY-MM-DD	Default: 30 days ago ⚠️ Data available from 2019-01-01 onwards
end_date	–	End date of the period in format YYYY-MM-DD	Default: 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, 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.

response parameters	Description	Origin	Historical Data?
downloads	The daily number of downloads generated by the category	AppTweak estimation	✅ - starting from 01/2019
revenues	The daily number of revenues generated by 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.

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