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.
This method returns the top 10 most relevant competitors we found.
The two letter country code (ISO Alpha-2) you want to fetch the app in.
us. Get the list of our country codes, here.
The device you want to fetch the application for.
iphone or ipad
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/284882215/keywords/competitors.json?country=us&language=en&device=iphone
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"The response is an array. Each element of the array corresponding to a competitor.
The ID that Apple has given to the application.
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.
The URL of the icon as it appears on the App Store.
Price of the application as displayed in the App Store in the target country.
Value describing the average rating for the application.
The App name as it appears on the App Store, in the chosen language.
The current version of the application.
{
"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": {
}
}
}