---
title: "Top Charts - History"
method: GET
path: "/charts/top-results/history"
---

# Top Charts - History

`GET /charts/top-results/history`

Returns historical top charts for the App Store or Google Play Store. The top 500 applications are provided for free and paid, or grossing apps.

## Query parameters

- `categories` string, required
- `start_date` string
- `end_date` string
- `types` 'free' | 'paid' | 'grossing'
- `country` string
- `device` 'iphone' | 'ipad' | 'android'
- `limit` integer
- `offset` integer

## Response `200`

200

- union
  - object
    - `result` object
      - `7013` object
        - `free` object[]
          - `date` string
          - `value` integer[]
    - `metadata` object
      - `request` object
        - `path` string
        - `params` object
          - `device` string
          - `country` string
          - `limit` integer
          - `offset` integer
          - `start_date` string
          - `end_date` string
          - `categories` string[]
          - `types` string[]
        - `cost` integer
        - `max_credit_cost` integer
        - `status` integer
      - `response` unknown
  - object
    - `result` object
      - `HEALTH_AND_FITNESS` object
        - `paid` object[]
          - `date` string
          - `value` string[]
    - `metadata` object
      - `request` object
        - `path` string
        - `params` object
          - `device` string
          - `country` string
          - `limit` integer
          - `offset` integer
          - `start_date` string
          - `end_date` string
          - `categories` string[]
          - `types` 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)