Category Top Keywords

GET 20 Credits / Request /ios/categories/{CATEGORY_ID}/keywords/top.json

The category top keywords gives the most popular keyword for a given category. This is computed by looking at the best keywords for the app present at the top of each category (Top 50).

Category Top Keywords Request

This method returns top keywords for the provided category. We return the top 50 keywords.

Header parameters
Your AppTweak API Key.
Path parameters
Category ID for which you want to get the top keywords.
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

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.

type: string free

The type of chart to fetch

Possible values are: free, paid and grossing

GET /ios/categories/{CATEGORY_ID}/keywords/top.json

Request example
GET /ios/categories/6001/keywords/top.json?country=fr&language=fr&device=iphone&type=free
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" ""

Category Top Keywords Response

The response is a list of objects. Each of these object is a keyword.

Object properties
keyword: string

Popular keyword for the targetted category.

score: integer

A measure of how popular the keyword is in the category.

stats: hash

Hash providing for each keyword the volume, competiton and kei.

Response Example

  "content": [
      "keyword": "gps",
      "score": 38,
      "stats": {
        "competition": 95.58845589915678,
        "volume": 100,
        "kei": 54.411544100843216
      "keyword": "maps",
      "score": 25,
      "stats": {
        "competition": 97.36388190330067,
        "volume": 100,
        "kei": 52.636118096699335
      "keyword": "trafic",
      "score": 17,
      "stats": {
        "competition": 88.07092196836687,
        "volume": 100,
        "kei": 61.929078031633125
      "keyword": "navigation",
      "score": 35,
      "stats": {
        "competition": 94.26313418582413,
        "volume": 96.49320037781939,
        "kei": 53.78228561438904
      "keyword": "map",
      "score": 15,
      "stats": {
        "competition": 97.37932706965123,
        "volume": 91.27816804499983,
        "kei": 48.03118626377349
  "metadata": {
    "request": {
      "path": "/ios/categories/6010/keywords/top.json",
      "store": "ios",
      "params": {
        "country": "fr",
        "language": "fr",
        "device": "iphone",
        "type": "free",
        "id": "6010",
        "format": "json"
      "performed_at": "2018-12-17 10:14:19 UTC"
    "content": {