Keywords Volume History allows you to fetch information about the popularity and competition of a list of keywords for a selected period. This is useful to estimate if it would be interesting to put an emphasis on a given the word in the app title, description or to target it in the keywords field. But also to compare how this keyword performs in comparison to new ones or those used by your competition, and evaluate them on a selected period.
This method returns the list of provided keywords and returns their volume o the selected period in a given country, language and device.
Note that the default selected period is for 90 days, but you can provide your date range in order to extend the targetted period.
The two letter country code (ISO Alpha-2) you want to fetch the app in.
us. Get the list of our country codes, here.Note that we only provide data for the following list of countries: us, uk, au, nz, ca, ch, mx, fr, de, it, es, jp and kr.
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/volume-history.json?country=us&language=us&keywords=catalogs,file%20scanner,food%20and%20exercise%20tracker,skyscanner%20app,ood,food%20reviewer,scn&start_date=2018-12-05&end_date=2018-12-12
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/ios/keywords/volume-history.json?country=us&language=us&keywords=catalogs,file%20scanner,food%20and%20exercise%20tracker,skyscanner%20app,ood,food%20reviewer,scn&start_date=2018-12-05&end_date=2018-12-12"The response is a hash which links each keyword with its volume history. The keys of the hash are the provided keywords and the values are ordered lists of integer giving the volume of the keyword between start_date and end_date.
Returns an ordered list of integer giving the volume of the related keyword between start_date and end_date. null indicates that we don't have the volume on the matching day.
As a reminder, the Volume is 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.
{
"content": {
"catalogs": {
"volumes": [
null,
null,
5,
5,
null,
null,
null,
5
],
"start_date": "2018-12-05 00:00:00 +0000",
"end_date": "2018-12-12 00:00:00 +0000"
},
"file scanner": {
"volumes": [
null,
18,
null,
null,
19,
null,
null,
null
],
"start_date": "2018-12-05 00:00:00 +0000",
"end_date": "2018-12-12 00:00:00 +0000"
}
},
"metadata": {
"request": {
"path": "/ios/keywords/volume-history.json",
"store": "ios",
"params": {
"country": "us",
"language": "us",
"keywords": "catalogs,file scanner,food and exercise tracker,skyscanner app,ood,food reviewer,scn",
"start_date": "2018-12-05T00:00:00+00:00",
"end_date": "2018-12-12T00:00:00+00:00",
"format": "json"
},
"performed_at": "2018-12-17 11:05:56 UTC"
},
"content": {
}
}
}