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.
This method returns the rankings for the provided keyword.
An url encoded string with the keyword you want to get the rankings for.
The two letter country code (ISO Alpha-2) you want to fetch the app in.
Get the list of our country codes, here.
The two letter language (ISO Alpha-2) you want to fetch the application in.
Get the list of our language codes, here.
The device you want to fetch the application for.
iphone or ipad
The first date for which to get data in YYYY-MM-DD format. The default value is yesterday.
The last date for which to get data in YYYY-MM-DD format. The default value is 90 days ago.
An upper limit of how many results should be returned per date.
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 -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"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.
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.
{
"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": {
}
}
}