---
title: "App Category Ranking - History"
method: GET
path: "/apps/category-rankings/history.json"
---

# App Category Ranking - History

`GET /apps/category-rankings/history.json`

Returns historical rankings of an app in its main category & the category "All".

## Query parameters

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

## Response `200`

200

- union
  - object
    - `result` object
      - `1313192037` object
        - `rankings` object[]
          - `value` object[]
            - `rank` integer
            - `fetch_date` string
            - `category` string
            - `category_name` string
            - `chart_type` string
            - `fetch_depth` integer
          - `date` string
    - `metadata` object
      - `request` object
        - `path` string
        - `params` object
          - `device` string
          - `country` string
          - `start_date` string
          - `end_date` string
          - `apps` string[]
        - `cost` integer
        - `max_credit_cost` integer
        - `status` integer
      - `response` unknown
  - object
    - `result` object
      - `homeworkout.homeworkouts.noequipment` object
        - `rankings` object[]
          - `value` object[]
            - `rank` integer
            - `fetch_date` string
            - `category` string
            - `category_name` string
            - `chart_type` string
            - `fetch_depth` integer
          - `date` string
    - `metadata` object
      - `request` object
        - `path` string
        - `params` object
          - `device` string
          - `country` string
          - `start_date` string
          - `end_date` string
          - `apps` string[]
        - `cost` integer
        - `max_credit_cost` integer
        - `status` integer
      - `response` unknown

---

[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-service-production.skmtc.workers.dev/v1/apis/apptweak/apptweak-store-api/revisions/636adc3c51f1/schema)