---
title: "App History Download Estimations"
method: POST
path: "/data/app/history/download/estimations"
tags: ["App"]
---

# App History Download Estimations

`POST /data/app/history/download/estimations`

## 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/history/download/estimations`
- Auth: API key in header `Authorization`

This endpoint returns download estimate for any app over any timeframe. You need to provide the app/bundle ID, store and country. In the response, for days without rankings, returns null values.<br/>

Credit Cost: 10

Credits per extra day: 10

## 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 with download estimations
    - `date` string: Date of the estimation (format YYYY-MM-DD)
    - `est_downloads_mid` integer: Estimated daily downloads (null if no ranking data available for that day)

## Other responses

- `400`: Out of date range or bad request
- `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)