Keywords Stats v2

GET 5 Credits / Request /android/keywords/stats_v2.json

Keywords Stats v2 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.

Keywords Stats v2 Request

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

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.

keywords: string toon,pop,blast,cubes Required

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.

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 /android/keywords/stats_v2.json

Request example
GET /android/keywords/stats_v2.json?country=us&language=us&keywords=toon,pop,blast,cubes
cURL example
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

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

A score between 1 and 100 that shows how popular a keyword is in terms of searches. The higher the number, the more popular the keyword is.

difficulty: number [0..100]

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.

difficulty_details: hash

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.

volume_details: hash

A hash holding additional information about the volume.

Response Example

{
  "content": {
    "toon": {
      "volume": 38.13639712242053,
      "volume_details": {
      },
      "difficulty": 12,
      "difficulty_details": {
        "total_size": 250
      }
    },
    "pop": {
      "volume": 51.136937950311875,
      "volume_details": {
      },
      "difficulty": 48,
      "difficulty_details": {
        "total_size": 250
      }
    },
    "blast": {
      "volume": 39.1147776824019,
      "volume_details": {
      },
      "difficulty": 50,
      "difficulty_details": {
        "total_size": 249
      }
    },
    "cubes": {
      "volume": 25.28977392158928,
      "volume_details": {
      },
      "difficulty": 12,
      "difficulty_details": {
        "total_size": 249
      }
    }
  },
  "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-04-02 15:34:13 UTC"
    },
    "content": {
    }
  }
}