Application Keywords Volume History

GET 5 Credits / Request + 5 Additional Credits / 30 days /ios/keywords/volume-history.json

The Application 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.

Application Keywords Volume History Request

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.

Header parameters
X-AppTweak-Key:
Your AppTweak API Key.
Query parameters
country: string us

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.

keywords: string toon,pop,blast,cubes Required

A url encoded comma separated list of keywords you wish to fetch stats on. We allow a maximum of 10 keywords per query.

language: string en

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: date

Start date, format: YYYY-MM-DD

end_date: date

End date, format: YYYY-MM-DD

GET /ios/keywords/volume-history.json

Request example
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 example
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

Application Keywords Volume History Response

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.

Object properties
volumes: array

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.

Response Example

{
  "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": {
    }
  }
}