Keywords Stats

GET 5 Credits / request / Keyword /ios/keywords/stats_v2.json

Keywords Stats allow you to fetch information about the volume and difficulty of a given keyword. This is useful to estimate if it would be interesting to put an emphasis on a given word in the app title, description or to target it in the keywords field.

Keywords Stats Request

This method returns the list of provided keywords and evaluates the volume and difficulty in a given country, language and device.

Header parameters
X-AppTweak-Key:
Your AppTweak API Key.
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

keywords: string toon,pop,blast,cubes Required

A url encoded comma separated list of keywords you wish to fetch stats on. We recommend querying 5 keywords at a time. We allow a maximum of 10 keywords per query.

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/keywords/stats_v2.json

Request example
GET /ios/keywords/stats_v2.json?country=us&language=us&device=iphone&keywords=toon,pop,blast,cubes
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/ios/keywords/stats_v2.json?country=us&language=us&device=iphone&keywords=toon,pop,blast,cubes"

Keywords Stats Response

The response is a hash which links each keyword with its stats. The keys of the hash are the provided keywords and the values are stats objects.

Object properties
volume: number [5..100]

A score between 5 and 100 that shows how popular a keyword is in terms of searches. The higher the number, the more popular the keyword is.

difficulty: number [1..100]

A score between 1 and 100 that shows the level of competition of a keyword. The higher the number, the higher the competition. A high Difficulty indicates that powerful apps rank in the top 10 search results, making it more difficult to rank high for the keyword.

is_branded: boolean

A flag indicating if AppTweak considers this keyword to be from a brand or not.

difficulty_details: hash

A hash holding additional information about the difficulty. Currently holds a single key total_size which provides the number of apps in the App Store search results when a search is performed on the keyword.

volume_details: hash

A hash holding additional information about the volume. Currently holds a single key total_monthly_downloads which provides an estimation of downloads generated by searches on that keyword every month, if available for the country requested.

brand_details: hash

A hash containing more information about the app that this keyword belongs to, in case AppTweak considers the keyword to be part of a brand

CHILD PROPERTIES

top_app_icon: string

The url for the icon of the app

top_app_id: integer

The id given by apple for the app

top_app_title: string

The title of the app

Response Example

{
  "content": {
    "toon": {
      "difficulty": 26,
      "difficulty_details": {
        "total_size": 1458
      },
      "volume": 40,
      "volume_details": {
        "total_monthly_downloads": 5814
      },
      "is_branded": true,
      "brand_details": {
        "top_app_icon": "https://is4-ssl.mzstatic.com/image/thumb/Purple113/v4/02/1e/35/021e35f5-73e2-8e2c-aa52-5fd545da8238/AppIcon-0-1x_U007emarketing-0-85-220-0-9.png/1024x1024bb.jpg",
        "top_app_id": 1176027022,
        "top_app_title": "Toon Blast"
      }
    },
    "pop": {
      "difficulty": 55,
      "difficulty_details": {
        "total_size": 23001
      },
      "volume": 49,
      "volume_details": {
        "total_monthly_downloads": 12940
      },
      "is_branded": true,
      "brand_details": {
        "top_app_icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple123/v4/5e/44/a4/5e44a40a-dc1c-e495-3091-ab38c8393cdf/AppIcon-0-1x_U007emarketing-0-0-GLES2_U002c0-512MB-sRGB-0-0-0-85-220-0-0-0-3.png/1024x1024bb.jpg",
        "top_app_id": 1269654347,
        "top_app_title": "Pop Now"
      }
    },
    "blast": {
      "difficulty": 51,
      "difficulty_details": {
        "total_size": 10374
      },
      "volume": 43,
      "volume_details": {
        "total_monthly_downloads": 7291
      },
      "is_branded": false,
      "brand_details": {
      }
    },
    "cubes": {
      "difficulty": 57,
      "difficulty_details": {
        "total_size": 7691
      },
      "volume": 27,
      "volume_details": {
        "total_monthly_downloads": 2342
      },
      "is_branded": false,
      "brand_details": {
      }
    }
  },
  "metadata": {
    "request": {
      "path": "/ios/keywords/stats_v2.json",
      "store": "ios",
      "params": {
        "country": "us",
        "language": "us",
        "device": "iphone",
        "keywords": "toon,pop,blast,cubes",
        "format": "json"
      },
      "performed_at": "2019-07-12 13:09:54 UTC"
    },
    "content": {
    }
  }
}