Sign in

v1

latestOpenAPI 3.1.02026-07-24450694.7 KB

Top Installs

Returns a list of recommended keywords for which an app is performing well on.

get/keywords/suggestions/app.json

Query parameters

appsstring required

Comma separated list of app ids (e.g. 1095459556,835599320 or com.facebook.katana,us.zoom.videomeetings). Max 5 apps 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 500</b> <br/><b>Default:</b> 100

offsetinteger

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

sort'score' | 'volume' | 'ranking'

The parameter by which keywords are sorted (score,volume,ranking). <a href="https://developers.apptweak.com/reference/keyword-suggestions#keyword-suggestions-by-app">More info</a> <br/><b>Default:</b> score

sort_direction'desc' | 'asc'

Sorting direction for the sort parameter. <br/><b>Default:</b> "descending" for score and volume; "ascending" for rank

Response

200

OR

Example response

{
  "result": {
    "835599320": {
      "suggestions": [
        {
          "keyword": "tik tok",
          "ranking": 1,
          "volume": 88,
          "score": 100
        }
      ]
    }
  },
  "metadata": {
    "request": {
      "path": "/api/public/store/keywords/suggestions/app.json",
      "params": {
        "device": "iphone",
        "country": "es",
        "language": "es",
        "limit": 10,
        "apps": [
          "835599320"
        ],
        "sort_by": "score",
        "sort_direction": "desc"
      },
      "cost": 101,
      "max_credit_cost": 101,
      "status": 200
    }
  }
}