Sign in

v1

latestOpenAPI 3.1.02026-07-24450694.7 KB

Top Category

Returns the most popular keyword list for a given category. The keyword list is sorted by descending keyword volume.

get/keywords/suggestions/category.json

Query parameters

categoriesstring required

The category id for which you want to get the top charts. <a href="https://apptweak.readme.io/reference/app-store-categories">App Store Categories</a> and <a href="https://apptweak.readme.io/reference/google-play-store-categories">Google Play Store Categories</a>. Max 5 categories are allowed.

countrystring

Two letter <a href="https://apptweak.readme.io/reference/country-codes">country code</a>. <br/><b>Default:</b> us

languagestring

Two letter <a href="https://developers.apptweak.com/reference/languages" target="_blank">language code</a>. <br/><b>Default:</b> AppTweak <a href="https://developers.apptweak.com/reference/languages-overview#default-language" target="_blank">default language</a> of the country.

device'iphone' | 'ipad' | 'android'

Choose a device from iphone, ipad or android. <br/><b>Default:</b> iphone

limitinteger

Number of items you want to fetch. <b>Max limit is 50</b> <br/><b>Default:</b> 50

offsetinteger

Index offset you want to apply to the ranking of results. <br/><b>Default:</b> 0

Response

200

OR

Example response

{
  "result": {
    "6017": {
      "suggestions": [
        {
          "keyword": "untis",
          "difficulty": 47,
          "volume": 70
        }
      ]
    }
  },
  "metadata": {
    "request": {
      "path": "/api/public/store/keywords/suggestions/category.json",
      "params": {
        "device": "iphone",
        "country": "de",
        "language": "de",
        "limit": 10,
        "categories": [
          "6017"
        ]
      },
      "cost": 101,
      "max_credit_cost": 101,
      "status": 200
    }
  }
}