---
title: "App Metrics - History"
method: GET
path: "/apps/metrics/history.json"
---

# App Metrics - History

`GET /apps/metrics/history.json`

Get the historical metrics of an app (downloads, revenues, ratings & app power).

## Query parameters

- `apps` string, required
- `metrics` string, required
- `start_date` string, date
- `end_date` string, date
- `country` string
- `device` 'iphone' | 'ipad' | 'android'

## Response `200`

200

- union
  - object
    - `result` object
      - `1521236603` object
        - `downloads` object[]
          - `value` integer
          - `date` string
          - `precision` integer
        - `revenues` object[]
          - `value` integer
          - `date` string
          - `precision` integer
          - `currency` string
        - `ratings` object[]
          - `value` number
          - `breakdown` object
            - `1` integer
            - `2` integer
            - `3` integer
            - `4` integer
            - `5` integer
            - `total` integer
            - `avg` number
          - `date` string
        - `daily-ratings` object[]
          - `breakdown` object
            - `1` integer
            - `2` integer
            - `3` integer
            - `4` integer
            - `5` integer
          - `date` string
          - `value` number
        - `app-power` object[]
          - `value` number
          - `date` string
    - `metadata` object
      - `request` object
        - `path` string
        - `params` object
          - `device` string
          - `country` string
          - `language` string
          - `start_date` string
          - `end_date` string
          - `apps` string[]
          - `metrics` string[]
        - `cost` integer
        - `max_credit_cost` integer
        - `status` integer
      - `response` unknown
  - object
    - `result` object
      - `com.reddit.frontpage` object
        - `downloads` object[]
          - `value` integer
          - `date` string
          - `precision` integer
        - `revenues` object[]
          - `value` integer
          - `date` string
          - `precision` integer
          - `currency` string
        - `ratings` object[]
          - `value` number
          - `breakdown` object
            - `1` integer
            - `2` integer
            - `3` integer
            - `4` integer
            - `5` integer
            - `total` integer
            - `avg` number
          - `date` string
        - `app_power` object[]
          - `value` number
          - `date` string
    - `metadata` object
      - `request` object
        - `path` string
        - `params` object
          - `device` string
          - `country` string
          - `language` string
          - `start_date` string
          - `end_date` string
          - `apps` string[]
          - `metrics` string[]
        - `cost` integer
        - `max_credit_cost` integer
        - `status` integer
      - `response` unknown

---

[API](https://skmtc.net/apptweak/apis/apptweak-store-api.md) · [All operations](https://skmtc.net/apptweak/apis/apptweak-store-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apptweak/apptweak-store-api/revisions/636adc3c51f1/schema)