---
title: "Category Metrics - History"
method: GET
path: "/categories/metrics"
tags: ["Category Metrics"]
---

# Category Metrics - History

`GET /categories/metrics`

## Request

- Base URL: `https://public-api.apptweak.com/api/public/store`
- URL: `https://public-api.apptweak.com/api/public/store/categories/metrics`
- Auth: API key in header `x-apptweak-key`

Market intelligence data that provides downloads or revenues per category and per country. <br/><br/> <b>Price</b> <table> <thead><tr><th>Datapoint</th><th>Description</th><th>Credits for 1 day</th><th>Credits per extra day</th></tr></thead> <tbody> <tr><td><b>downloads</b></td><td>Array of objects containing the category download estimates and associated date the date.</td><td>1000</td><td>100</td></tr> <tr><td><b>revenues</b></td><td>Array of objects containing the category revenue estimates and associated date the date.</td><td>1000</td><td>100</td></tr> </tbody> </table>

## Query parameters

- `metric` 'downloads' | 'revenues', required
- `categories` string, required
- `countries` string, required
- `start_date` string, date
- `end_date` string, date
- `type` 'free' | 'paid'
- `device` 'iphone' | 'ipad' | 'android'

## Response `200`

Successful response.

- object
  - `result` object
  - `metadata` ResponseMetadata: Standard response envelope, identical on every endpoint.
    - `request` object
      - `path` string: The path that was called.
      - `params` object, nullable: The query as the API parsed it, with defaults applied.
      - `cost` integer: Credits actually charged for this call.
      - `max_credit_cost` integer: Credits the call could have cost if every datapoint requested had been available.
      - `status` integer: HTTP status of the response.
    - `response` object, nullable: Endpoint-specific notes; null when there are none.

## Other responses

- `401`: Unauthorized. Unknown or missing API token.
- `403`: Forbidden. Not enough credits to perform the request.
- `422`: Validation error. Returned when a parameter is invalid.

## Changes

- **2026-11-03** `a4af4000f1e3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/apptweak/apis/apptweak-store-api/changes/categories/metrics/get.md)

---

[API](https://skmtc.dev/apptweak/apis/apptweak-store-api.md) - [All operations](https://skmtc.dev/apptweak/apis/apptweak-store-api/llms.txt) - [OpenAPI document](https://skmtc.dev/apptweak/apis/apptweak-store-api/revisions/a4af4000f1e3?raw)