Keywords Stats

GET 5 Credits / Keyword /ios/keywords/stats.json

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.

Keywords Stats Request

This method returns the list of provided keywords and evaluates the volume and competiton in a given country, language and device.

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.

device: string iphone

The device you want to fetch the application for.

iphone or ipad

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.

GET /ios/keywords/stats.json

Request example
GET /ios/keywords/stats.json?country=us&language=us&device=iphone&keywords=toon,pop,blast,cubes
cURL example
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"

Keywords Stats Response

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.

Object properties
competition: float [0..100]

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.

volume: float [0..100]

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: float [0..100]

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).

competition_details: hash

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.

volume_details: hash

A hash holding additional information about the volume. Currently only available on single words (no spaces).

CHILD PROPERTIES

language_frequency: float [0..100]

Score between 0 and 100 indicating how often is the word used in the common language

web_volume: number

Estimation of the number of monthly queries made on that keyword on Google

word_brands: hash

Contains a per continent list of known brands containing that keyword

appstore_hints: hash

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.

Response Example

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