Application Top Keywords

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

App top 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.

Application Top 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.

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.

GET /ios/applications/{APPLICATION_ID}/keywords/top.json

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

Application Top 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": "facebooku",
      "ranking": 1
    },
    {
      "keyword": "facebooka",
      "ranking": 1
    },
    {
      "keyword": "status update",
      "ranking": 1
    },
    {
      "keyword": "facebook for ipad",
      "ranking": 1
    },
    {
      "keyword": "facebook facebook",
      "ranking": 1
    },
    {
      "keyword": "facebok",
      "ranking": 1
    },
    {
      "keyword": "facebook places",
      "ranking": 1
    },
    {
      "keyword": "facebook app",
      "ranking": 1
    },
    {
      "keyword": "facebook free",
      "ranking": 1
    }
  ],
  "metadata": {
    "request": {
      "path": "/ios/applications/284882215/keywords/top.json",
      "store": "ios",
      "params": {
        "country": "us",
        "language": "en",
        "device": "iphone",
        "id": "284882215",
        "format": "json"
      },
      "performed_at": "2018-12-11 11:41:34 UTC"
    },
    "content": {
    }
  }
}