APapplyzer
Keyword

Keyword Ranked Apps History

Return ALL apps ranking for a keyword per date (and store) over a date<br/>range. Unlike /data/keyword/rank/history (which returns a single app's rank),<br/>this returns the full ranked app list captured for the keyword each day.<br/>

Credit Cost: 20

post/data/keyword/apps/history

Request

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

Request body

devicestring required

play / iphone / ipad / mac

keywordstring required

search term

languagestring required

locale code such as en-US. The store/country is derived from this (e.g. en-US -> US store).

marketstring required

IOS / PLAY

startdatestring required

Start date (YYYY-MM-DD)

enddatestring required

End date (YYYY-MM-DD)

ranklimitinteger

Optional. Only return apps ranked at or above this position.

Response

Successful operation. response.data is keyed by date (YYYY-MM-DD); each value is the ranked list of app ids for that day, ordered by rank (index 0 = rank 1). totals holds the full number of ranked apps per day before ranklimit is applied, so it can exceed the length of the matching data list. searchscore and impressions are keyed by the same dates; a day only appears there if a search score was recorded, and impressions is null when the score has no impressions lookup entry for that store. If the keyword is not in the library the request still returns 200 with an empty data object and no totals/searchscore/impressions.

messagestring

Example response

{
  "message": "OK",
  "response": {
    "keyword": "photo editor",
    "device": "iphone",
    "market": "IOS",
    "data": {
      "2025-01-01": [
        "389801252",
        "1094591345",
        "302584613"
      ],
      "2025-01-02": [
        "1094591345",
        "389801252",
        "302584613"
      ]
    },
    "totals": {
      "2025-01-01": 200,
      "2025-01-02": 198
    },
    "searchscore": {
      "2025-01-01": 45,
      "2025-01-02": 46
    },
    "impressions": {
      "2025-01-01": 12000,
      "2025-01-02": 12500
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.