Keywords Stats allow you to fetch information about the popularity and competition of a given keyword. This is useful to estimate if it would be interesting to put an emphasis on a given word in the app title, description or to target it in the keywords field.
This endpoint is now deprecated and might be removed in the future. It is recommended to start using Keywords Stats v2 instead.
This method returns the list of provided keywords and evaluates the volume and competiton in a given 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
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.
GET /ios/keywords/stats.json?country=us&language=us&device=iphone&keywords=toon,pop,blast,cubes
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/ios/keywords/stats.json?country=us&language=us&device=iphone&keywords=toon,pop,blast,cubes"The response is a hash which links each keyword with its stats. The keys of the hash are the provided keywords and the values are stats objects.
A score between 0 and 100 indicating how competitive the keyword is. Competitive keywords match more apps. It is therefore harder to get a good ranking on such keywords. Lower competitive keywords are better to target.
A score between 0 and 100 indicating how popular the keyword is. Popular keywords are more likely to be searched on the App Store and tend to generate more downloads. It is therefore more interesting to be well ranked keywords with a high volume.
KEI stand for Keyword Efficiency Index. It's a score between 0 and 100 taking into account both the volume and competition. It's a measure of the risk/reward associated to each keyword. A high KEI indicates that the keyword is a good candidate for App Store Optimization (high volume and low competition).
A hash holding additional information about the competiton. Currently only holds the sub key search_result_size wich provides the precise number of apps in the App Store search results when a search is performed on the keyword.
A hash holding additional information about the volume. Currently only available on single words (no spaces).
Score between 0 and 100 indicating how often is the word used in the common language
Estimation of the number of monthly queries made on that keyword on Google
Contains a per continent list of known brands containing that keyword
Contains a list of 1,2 or 3 letters combinations in the data/results subkey which, if typed in the App Store search field, lead to Apple suggesting the keyword as a popular search term. For each hint, we provide the position (lower = better), the complete hint, and the date at which it was found. The score subkey is a numerical computation indicates how often the keyword is hinted by Apple.
{
"content": {
"pop": {
"competition": 96.56303583723124,
"volume": 48.0,
"kei": 35.99706219714095,
"competition_details": {
"total_size": 26169
},
"volume_details": {
"language_frequency": 63.89,
"appstore_hints": {
"data": {
"results": {
"bll": [
{
"position": 10,
"updated_at": "2016-01-27 11:42:11 UTC",
"hint": "pop blloons"
}
],
"cpo": [
{
"position": 4,
"updated_at": "2016-01-27 11:48:13 UTC",
"hint": "c-pop hits! - get the newest c-pop charts!"
},
{
"position": 6,
"updated_at": "2016-01-27 11:48:13 UTC",
"hint": "c-pop tuber - c-pop music videos for youtube"
}
],
"jpo": [
{
"position": 4,
"updated_at": "2016-01-27 12:25:15 UTC",
"hint": "j-pop & anime - internet radio"
},
{
"position": 5,
"updated_at": "2016-01-27 12:25:15 UTC",
"hint": "j-pop hits! - get the newest j-pop charts!"
}
],
"kpo": [
{
"position": 8,
"updated_at": "2016-01-27 12:31:02 UTC",
"hint": "k-pop boy idol photoping - share k-pop photos & videos with other fans!"
}
],
"kwn": [
{
"position": 1,
"updated_at": "2016-01-27 12:32:28 UTC",
"hint": "106.3 pop fm kwnz"
}
],
"pop": [
{
"position": 2,
"updated_at": "2016-01-27 12:58:51 UTC",
"hint": "pop the lock"
},
{
"position": 10,
"updated_at": "2016-01-27 12:58:51 UTC",
"hint": "pop"
}
],
"ppo": [
{
"position": 4,
"updated_at": "2016-01-27 12:59:08 UTC",
"hint": "p-pop-club"
}
],
"prn": [
{
"position": 9,
"updated_at": "2016-01-27 12:59:29 UTC",
"hint": "pop red note - prn play fun the best for boys and girls game"
}
]
},
"score": 59.533917033189795
},
"date": "2017-06-26 14:36:27 UTC"
},
"web_volume": 165000,
"world_brands": {
"north-america": [
"Blow Pop",
"Pop-Tarts",
"Pop Rocks"
],
"oceania": [
"Paddle Pop"
]
}
}
}
},
"metadata": {
"request": {
"path": "/ios/keywords/stats.json",
"store": "ios",
"params": {
"country": "us",
"language": "us",
"device": "iphone",
"keywords": "toon,pop,blast,cubes",
"format": "json"
},
"performed_at": "2018-12-10 10:17:09 UTC"
},
"content": {
}
}
}