Ranked Keywords allows you to retrieve a list of keywords an app is performing well on. This is useful to investigate the keywords you should target.
This method resturns the list of keywords on which the app is ranked in the top 50 when a user performs a search in the selected country, language and device.
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
The two letter language (ISO Alpha-2) you want to fetch the application in.
en. Get the list of our language codes, here.
GET /ios/applications/284882215/keywords/top.json?country=us&language=en&device=iphone
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/ios/applications/284882215/keywords/top.json?country=us&language=en&device=iphone"The response is a list of keyword/ranking hash, which links each top keyword with the ranking of the app for that keyword.
The keyword this keyword/ranking object is referring to.
The ranking of the app for the keyword.
{
"content": [
{
"keyword": "facebook",
"ranking": 1
},
{
"keyword": "facebooku",
"ranking": 1
},
{
"keyword": "facebooka",
"ranking": 1
},
{
"keyword": "status update",
"ranking": 1
},
{
"keyword": "facebook for ipad",
"ranking": 1
},
{
"keyword": "facebook facebook",
"ranking": 1
},
{
"keyword": "facebok",
"ranking": 1
},
{
"keyword": "facebook places",
"ranking": 1
},
{
"keyword": "facebook app",
"ranking": 1
},
{
"keyword": "facebook free",
"ranking": 1
}
],
"metadata": {
"request": {
"path": "/ios/applications/284882215/keywords/top.json",
"store": "ios",
"params": {
"country": "us",
"language": "en",
"device": "iphone",
"id": "284882215",
"format": "json"
},
"performed_at": "2018-12-11 11:41:34 UTC"
},
"content": {
}
}
}