Suggested Competitors

GET 20 Credits / Request /ios/applications/{APPLICATION_ID}/keywords/competitors.json

Suggested Competitors allow you to get a list of applications that are competing with the given application on search result. These application are ranked at similar positions on the app main keywords. This is usefull to watch for new competitors, or to check the app position in the market.

Suggested Competitors Request

This method returns the top 10 most relevant competitors we found.

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

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/competitors.json

Request example
GET /ios/applications/284882215/keywords/competitors.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/competitors.json?country=us&language=en&device=iphone"

Suggested Competitors Response

The response is an array. Each element of the array corresponding to a competitor.

Object properties
id: number

The ID that Apple has given to the application.

genres: array

The list of category the app is listed on. See the supported categories list to match the category_id to it's human friendly name. The special category_id 0 is used to refer to the global rankings across all categories combined.

icon: string

The URL of the icon as it appears on the App Store.

price: string

Price of the application as displayed in the App Store in the target country.

rating: string

Value describing the average rating for the application.

title: string

The App name as it appears on the App Store, in the chosen language.

version: string

The current version of the application.

Response Example

{
  "content": [
    {
      "id": 389801252,
      "title": "Instagram",
      "icon": "https://is3-ssl.mzstatic.com/image/thumb/Purple118/v4/5a/9f/9d/5a9f9d9a-92d8-23cd-0afb-0b72c44b13bb/Prod-0-1x_U007emarketing-0-0-85-220-0-6.png/180x180bb.png",
      "genres": [
        6008,
        6005
      ],
      "price": "$0.00",
      "rating": 0.0,
      "version": "v10.1"
    },
    {
      "id": 454638411,
      "title": "Messenger",
      "icon": "https://is5-ssl.mzstatic.com/image/thumb/Purple128/v4/da/79/fd/da79fdd2-f7d4-6dbe-56d7-96d3d1eb4d5b/Icon-Production-1x_U007emarketing-85-220-0-6.png/360x216bb.png",
      "genres": [
        6005,
        6007
      ],
      "price": "$0.00",
      "rating": 0.0,
      "version": "99.0"
    }
  ],
  "metadata": {
    "request": {
      "path": "/ios/applications/284882215/keywords/competitors.json",
      "store": "ios",
      "params": {
        "country": "us",
        "language": "en",
        "device": "iphone",
        "id": "284882215",
        "format": "json"
      },
      "performed_at": "2018-12-11 15:24:42 UTC"
    },
    "content": {
    }
  }
}