Live Search History

GET 30 Credits / request / 30 days /ios/keywords/kw-rankings.json

Giving the opposite result as Keywords Rankings for Applications, this endpoint will list applications that were ranked for a given keyword during the interval of time requested. The response will be computed in a best-effort basis, and the list might be incomplete or empty if there's no data available for the period requested.

Live Search History Request

This method returns the rankings for the provided keyword.

Header parameters
X-AppTweak-Key:
Your AppTweak API Key.
Query parameters
keyword: string Required

An url encoded string with the keyword you want to get the rankings for.

country: string us

The two letter country code (ISO Alpha-2) you want to fetch the app in.

Get the list of our country codes, here.

language: string en

The two letter language (ISO Alpha-2) you want to fetch the application in.

Get the list of our language codes, here.

device: string iphone

The device you want to fetch the application for.

iphone or ipad

start_date: date

The first date for which to get data in YYYY-MM-DD format. The default value is yesterday.

end_date: date

The last date for which to get data in YYYY-MM-DD format. The default value is 90 days ago.

limit: integer [0..500]

An upper limit of how many results should be returned per date.

GET /ios/keywords/kw-rankings.json

Request example
GET /ios/keywords/kw-rankings.json?country=us&language=us&keyword=mastodon&limit=10&start_date=2019-03-24&end_date=2019-03-31
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/ios/keywords/kw-rankings.json?country=us&language=us&keyword=mastodon&limit=10&start_date=2019-03-24&end_date=2019-03-31"

Live Search History Response

The response is a JSON object. Each key of the object is a date within the required interval, the matching value is a ranking object holding an array of ranked applications.

Object properties
rankings: array

An array containing the id of the applications that ranked in the day of the current key in which the first application is the the highest ranked.

Response Example

{
  "content": {
    "2019-03-24": {
      "rankings": [
        1282283934,
        1437429129,
        1214116200,
        1229021451,
        1231706631,
        1236013466,
        438090426,
        1107176601,
        1436079856,
        1239260388
      ]
    },
    "2019-03-25": {
      "rankings": [
        1282283934,
        1437429129,
        1214116200,
        1229021451,
        1231706631,
        1236013466,
        438090426,
        1107176601,
        1436079856,
        1239260388
      ]
    },
    "2019-03-26": {
      "rankings": [
        1282283934,
        1437429129,
        1214116200,
        1229021451,
        1231706631,
        1236013466,
        438090426,
        1107176601,
        1436079856,
        1239260388
      ]
    },
    "2019-03-27": {
      "rankings": [
        1282283934,
        1437429129,
        1214116200,
        1229021451,
        1231706631,
        1236013466,
        438090426,
        1107176601,
        1436079856,
        1229070679
      ]
    },
    "2019-03-28": {
      "rankings": [
        1282283934,
        1437429129,
        1214116200,
        1229021451,
        1231706631,
        1236013466,
        438090426,
        1107176601,
        1436079856,
        1239260388
      ]
    },
    "2019-03-29": {
      "rankings": [
        1282283934,
        1437429129,
        1214116200,
        1229021451,
        1231706631,
        1236013466,
        438090426,
        1107176601,
        1436079856,
        1239260388
      ]
    },
    "2019-03-30": {
      "rankings": [
        1282283934,
        1437429129,
        1214116200,
        1229021451,
        1231706631,
        1236013466,
        438090426,
        1107176601,
        1436079856,
        1239260388
      ]
    },
    "2019-03-31": {
      "rankings": [
        1437429129,
        1282283934,
        1214116200,
        1229021451,
        1236013466,
        1436079856,
        1229461703,
        1296825434,
        1436972796,
        921372048
      ]
    }
  },
  "metadata": {
    "request": {
      "path": "/ios/keywords/kw-rankings.json",
      "store": "ios",
      "params": {
        "country": "us",
        "language": "us",
        "keyword": "mastodon",
        "limit": 10,
        "start_date": "2019-03-24T00:00:00+00:00",
        "end_date": "2019-03-31T00:00:00+00:00",
        "device": "iphone",
        "format": "json"
      },
      "performed_at": "2019-07-15 14:23:53 UTC"
    },
    "content": {
    }
  }
}