--- title: "Keyword App Rank History" method: POST path: "/data/keyword/rank/history" tags: ["Keyword"] --- # Keyword App Rank History `POST /data/keyword/rank/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/keyword/rank/history` - Auth: API key in header `Authorization` This endpoint allows you to get the historical keyword rankings for any app & keyword.
Credit Cost: 10 Credits per extra keyword: 10 ## Request body - object - `device` string, required: play / iphone / ipad / mac - `keyword` string, required: search term - `language` string, required: The code for English (United States) 'en-US'. The prefix, 'en', is a language code following the ISO 639-1 standard. The suffix, 'US', is a country code following the ISO 3166-1 Alpha-2 standard - `market` string, required: IOS / PLAY - `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: Start date for the rank history (YYYY-MM-DD) - `enddate` string, required: End date for the rank history (YYYY-MM-DD) ## Response `200` Successful operation - object - `message` string: The response message - `response` object: The response object - `date` string: The date of the result (YYYY-MM-DD) - `rank` integer: The rank of the app for the keyword on that date. If 0 the app did not rank for that keyword on that date. If -1 the keyword was not being actively tracked on that day and the data simply isn't available. - `totalresults` integer: Total number of results tracked for the keyword on that date ## Other responses - `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)