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 and language.
The two letter country code (ISO Alpha-2) you want to fetch the app in.
us. Get the list of our country codes, here.
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 /android/keywords/stats_v2.json?country=us&language=us&keywords=toon,pop,blast,cubes
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/android/keywords/stats_v2.json?country=us&language=us&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 Google Play 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 for the app in Play Store
The title of the app
{
"content": {
"toon": {
"difficulty": 55,
"difficulty_details": {
"total_size": 249
},
"volume": 38,
"volume_details": {
"total_monthly_downloads": 2560
},
"is_branded": true,
"brand_details": {
"top_app_icon": "https://lh3.googleusercontent.com/CoY30EnjT93vdWAPZkWUMKqjUux8AGCuW5uWwqSdJEzHFoe_FtXuGVujNAU7QY6aTg",
"top_app_id": "net.peakgames.toonblast",
"top_app_title": "Toon Blast"
}
},
"pop": {
"difficulty": 45,
"difficulty_details": {
"total_size": 250
},
"volume": 49,
"volume_details": {
"total_monthly_downloads": 5166
},
"is_branded": false,
"brand_details": {
}
},
"blast": {
"difficulty": 48,
"difficulty_details": {
"total_size": 249
},
"volume": 43,
"volume_details": {
"total_monthly_downloads": 3431
},
"is_branded": false,
"brand_details": {
}
},
"cubes": {
"difficulty": 3,
"difficulty_details": {
"total_size": 249
},
"volume": 35,
"volume_details": {
"total_monthly_downloads": 2124
},
"is_branded": false,
"brand_details": {
}
}
},
"metadata": {
"request": {
"path": "/android/keywords/stats_v2.json",
"store": "android",
"params": {
"country": "us",
"language": "us",
"keywords": "toon,pop,blast,cubes",
"format": "json"
},
"performed_at": "2019-10-11 12:14:51 UTC"
},
"content": {
}
}
}