---
title: "App Rankings History"
method: POST
path: "/data/app/ranking/history"
tags: ["App"]
---

# App Rankings History

`POST /data/app/ranking/history`

## Request

- Base URL: `https://data.applyzer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://data.applyzer.com/data/app/ranking/history`
- Auth: API key in header `Authorization`

This endpoint allows you to get the app history rankings for any app. You must never provide category or market as an input as it's not needed.<br/>

Credit Cost: 5

Credits per extra day: 5

## Request body

- object
  - `device` 'iphone' | 'ipad' | 'mac' | 'play', required: play / iphone / ipad / mac
  - `app` string, required: For Android apps this is the package ID like com.example.app. On iOS this is the numeric app ID such as 123456789
  - `startdate` string, required: SQL Date when to start the ranking history (format YYYY-MM-DD)
  - `enddate` string, required: SQL Date when to end the ranking history (format YYYY-MM-DD)
  - `countrycodes` string[], required: Use this to specify countries to look up. Country code follows the ISO 3166-1 Alpha-2 standard in uppercase

## Response `200`

Successful operation

- object
  - `message` string: The response message
  - `response` object[]: List of ranking history entries
    - `category` string: Category name
    - `categoryid` integer: Category ID
    - `countrycode` string: Country code
    - `date` string: Date and time of the ranking (format YYYY-MM-DD)
    - `rank` integer: Ranking position
    - `type` string: Ranking type (e.g., Free, Grossing)

## Other responses

- `400`: Out of date range
- `404`: No data found
- `500`: Error

---

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