Keyword Rankings allow you to get the 90 days rankings for one or several applications for a keywords list. We compute the position of the apps for each keyword on a best effort basis and the list may thus be incomplete or even empty. However, once an App Keyword Ranking is performed asking for data for a specific keyword, the keyword is flagged in our system and fetched once a day. Subsequent calls for the same keyword should thus yield complete results.
Note that the default selected period is for 90 days, but you can provide your date range in order to extend the targetted period.
This method returns the rankings for the provided keywords.
A url encoded comma separated list of application IDs you wish to fetch rankings on. We allow a maximum of 5 applications per query.
The two letter country code (ISO Alpha-2) you want to fetch the app in.
us. Get the list of our country codes, here.
The device you want to fetch the application for.
iphone or ipad
A url encoded comma separated list of keywords you wish to fetch stats on. We allow a maximum of 10 keywords per query.
The two letter language (ISO Alpha-2) you want to fetch the application in.
en. Get the list of our language codes, here.
Start date, format: YYYY-MM-DD
End date, format: YYYY-MM-DD
GET /ios/keywords/app-rankings.json?country=us&language=us&device=iphone&keywords=photo,friend,share,free%20app&applications=284882215,389801252&start_date=2018-12-01&end_date=2018-12-10
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/ios/keywords/app-rankings.json?country=us&language=us&device=iphone&keywords=photo,friend,share,free%20app&applications=284882215,389801252&start_date=2018-12-01&end_date=2018-12-10"The response is a JSON object. Each key of the object is one of the provided keywords, the matching value is a ranking object holding the ranks and the dates per application.
The date of the last integer of the ranks array.
Key/value pair containing an ordered list of integer giving the position of each targetted app in the search result of the keyword between start_date and end_date. Lower is better. null indicates that the app was not found in the chart on the matching day.
The date of the first integer of the ranks array.
An ordered list of integer giving the total number of applications for which the rankings have been calculated between start_date and end_date.
The keys are the application ids and the values are an array of floats giving the estimated daily downloads for this app between start_date and end_date.
{
"content": {
"photo": {
"ranks": {
"284882215": [
null,
null,
null,
null,
null,
null,
null,
null,
null,
null
],
"389801252": [
27,
26,
27,
28,
25,
26,
25,
29,
29,
28
]
},
"total_size": [
138921,
140345,
140401,
139110,
140533,
140607,
140694,
139351,
139373,
139418
],
"start_date": "2018-12-01 00:00:00 +0000",
"end_date": "2018-12-10 00:00:00 +0000",
"downloads": {
"284882215": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"389801252": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
}
},
"friend": {
"ranks": {
"284882215": [
12,
22,
13,
22,
12,
20,
12,
13,
13,
13
],
"389801252": [
4,
5,
4,
5,
4,
5,
4,
4,
4,
4
]
},
"total_size": [
23621,
23899,
23637,
23934,
23665,
23968,
23718,
23739,
23749,
23765
],
"start_date": "2018-12-01 00:00:00 +0000",
"end_date": "2018-12-10 00:00:00 +0000",
"downloads": {
"284882215": [
2.971425626293256,
0.6543942432179538,
2.3126662942360343,
0.6543942432179538,
2.971425626293256,
0.7644243804226512,
2.971425626293256,
2.3126662942360343,
2.3126662942360343,
2.3126662942360343
],
"389801252": [
15.339978006486772,
10.402064235175075,
15.339978006486772,
10.402064235175075,
15.339978006486772,
10.402064235175075,
15.339978006486772,
15.339978006486772,
15.339978006486772,
15.339978006486772
]
}
},
"share": {
"ranks": {
"284882215": [
24,
31,
23,
31,
25,
26,
26,
28,
27,
26
],
"389801252": [
8,
9,
7,
8,
7,
7,
7,
7,
7,
7
]
},
"total_size": [
21546,
21731,
21563,
21753,
21583,
21603,
21617,
21635,
21646,
21650
],
"start_date": "2018-12-01 00:00:00 +0000",
"end_date": "2018-12-10 00:00:00 +0000",
"downloads": {
"284882215": [
0.6955314523231483,
0,
0.7331794546976336,
0,
0,
0,
0,
0,
0,
0
],
"389801252": [
9.857954672282343,
6.192523443112939,
13.830922137391847,
9.857954672282343,
13.830922137391847,
13.830922137391847,
13.830922137391847,
13.830922137391847,
13.830922137391847,
13.830922137391847
]
}
},
"free app": {
"ranks": {
"284882215": [
7,
4,
4,
8,
6,
7,
8,
9,
9,
9
],
"389801252": [
5,
6,
3,
5,
2,
2,
3,
5,
5,
3
]
},
"total_size": [
52210,
52217,
51139,
52193,
51123,
51149,
51150,
51168,
51185,
51162
],
"start_date": "2018-12-01 00:00:00 +0000",
"end_date": "2018-12-10 00:00:00 +0000",
"downloads": {
"284882215": [
7.539442173758426,
9.962428170489103,
9.962428170489103,
5.373718286091075,
6.624217368490787,
7.539442173758426,
5.373718286091075,
3.3756369926175873,
3.3756369926175873,
3.3756369926175873
],
"389801252": [
6.755538875213752,
6.624217368490787,
11.197958878181062,
6.755538875213752,
12.812393106900483,
12.812393106900483,
11.197958878181062,
6.755538875213752,
6.755538875213752,
11.197958878181062
]
}
}
},
"metadata": {
"request": {
"path": "/ios/keywords/app-rankings.json",
"store": "ios",
"params": {
"country": "us",
"language": "us",
"device": "iphone",
"keywords": "photo,friend,share,free app",
"applications": "284882215,389801252",
"start_date": "2018-12-01T00:00:00+00:00",
"end_date": "2018-12-10T00:00:00+00:00",
"format": "json"
},
"performed_at": "2019-07-15 09:56:28 UTC"
},
"content": {
}
}
}