Curl

Ranked Keywords

GET 100 Credits / Request /android/applications/{APPLICATION_ID}/keywords/top.json

Ranked Keywords allows you to retrieve a list of keywords an app is performing well on. This is useful to investigate the keywords you should target.

Ranked Keywords Request

This method resturns the list of keywords on which the app is ranked in the top 50 when a user performs a search in the selected country, language and device.

Header parameters
X-AppTweak-Key:
Your AppTweak API Key.
Path parameters
APPLICATION_ID:
Application ID for which you want to get the data.
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.

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/applications/{APPLICATION_ID}/keywords/top.json

Request example 
GET /android/applications/com.facebook.katana/keywords/top.json?country=us&language=en
cURL example 
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/android/applications/com.facebook.katana/keywords/top.json?country=us&language=en"

Ranked Keywords Response

The response is a list of keyword/ranking hash, which links each top keyword with the ranking of the app for that keyword.

Object properties
keyword: string

The keyword this keyword/ranking object is referring to.

ranking: number

The ranking of the app for the keyword.

Response Example

{
  "content": [
    {
      "keyword": "facebook",
      "ranking": 1
    },
    {
      "keyword": "face",
      "ranking": 1
    },
    {
      "keyword": "fav",
      "ranking": 1
    },
    {
      "keyword": "free apps",
      "ranking": 1
    },
    {
      "keyword": "top free apps",
      "ranking": 1
    },
    {
      "keyword": "chat messenger",
      "ranking": 1
    },
    {
      "keyword": "https facebook",
      "ranking": 1
    },
    {
      "keyword": "facebook facebook",
      "ranking": 1
    },
    {
      "keyword": "facebook blog",
      "ranking": 1
    },
    {
      "keyword": "facebook https",
      "ranking": 1
    }
  ],
  "metadata": {
    "request": {
      "path": "/android/applications/com.facebook.katana/keywords/top.json",
      "store": "android",
      "params": {
        "country": "us",
        "language": "en",
        "id": "com.facebook.katana",
        "format": "json"
      },
      "performed_at": "2018-12-11 14:03:29 UTC"
    },
    "content": {
    }
  }
}