Keywords Stats allow you to fetch information about the volume and difficulty 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 method returns the list of provided keywords and evaluates the volume and difficulty 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 recommend querying 5 keywords at a time. 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_v2.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_v2.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 5 and 100 that shows how popular a keyword is in terms of searches. The higher the number, the more popular the keyword is.
A score between 1 and 100 that shows the level of competition of a keyword. The higher the number, the higher the competition. A high Difficulty indicates that powerful apps rank in the top 10 search results, making it more difficult to rank high for the keyword.
A flag indicating if AppTweak considers this keyword to be from a brand or not.
A hash holding additional information about the difficulty. Currently holds a single key total_size which provides the 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 holds a single key total_monthly_downloads which provides an estimation of downloads generated by searches on that keyword every month, if available for the country requested.
A hash containing more information about the app that this keyword belongs to, in case AppTweak considers the keyword to be part of a brand
The url for the icon of the app
The id given by apple for the app
The title of the app
{
"content": {
"toon": {
"difficulty": 26,
"difficulty_details": {
"total_size": 1458
},
"volume": 40,
"volume_details": {
"total_monthly_downloads": 5814
},
"is_branded": true,
"brand_details": {
"top_app_icon": "https://is4-ssl.mzstatic.com/image/thumb/Purple113/v4/02/1e/35/021e35f5-73e2-8e2c-aa52-5fd545da8238/AppIcon-0-1x_U007emarketing-0-85-220-0-9.png/1024x1024bb.jpg",
"top_app_id": 1176027022,
"top_app_title": "Toon Blast"
}
},
"pop": {
"difficulty": 55,
"difficulty_details": {
"total_size": 23001
},
"volume": 49,
"volume_details": {
"total_monthly_downloads": 12940
},
"is_branded": true,
"brand_details": {
"top_app_icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple123/v4/5e/44/a4/5e44a40a-dc1c-e495-3091-ab38c8393cdf/AppIcon-0-1x_U007emarketing-0-0-GLES2_U002c0-512MB-sRGB-0-0-0-85-220-0-0-0-3.png/1024x1024bb.jpg",
"top_app_id": 1269654347,
"top_app_title": "Pop Now"
}
},
"blast": {
"difficulty": 51,
"difficulty_details": {
"total_size": 10374
},
"volume": 43,
"volume_details": {
"total_monthly_downloads": 7291
},
"is_branded": false,
"brand_details": {
}
},
"cubes": {
"difficulty": 57,
"difficulty_details": {
"total_size": 7691
},
"volume": 27,
"volume_details": {
"total_monthly_downloads": 2342
},
"is_branded": false,
"brand_details": {
}
}
},
"metadata": {
"request": {
"path": "/ios/keywords/stats_v2.json",
"store": "ios",
"params": {
"country": "us",
"language": "us",
"device": "iphone",
"keywords": "toon,pop,blast,cubes",
"format": "json"
},
"performed_at": "2019-07-12 13:09:54 UTC"
},
"content": {
}
}
}