Similar Apps (Incoming) allows you to fetch information about apps for which the required app appears in top positions of the similar apps section in the App Store.
The request must be done about one app in a specific country. The results will contain app ids with positions in which the apps is featured, plus a estimation of which percentile this app is regarding to the country combination.
The two letter country code (ISO Alpha-2) you want to fetch the app in.
Get the list of our country codes, here.
GET /ios/applications/454638411/reverse-similar-apps.json?country=gb
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/ios/applications/454638411/reverse-similar-apps.json?country=gb"
The response will contain an array called reverse_similar_apps, in which each item is a hash containing an application id in which this app appears in the similar apps section and the position it appears in. It will also contain a key percentile, with the percentile this app is related to how many apps it appears in.
An array containing hashes of applications ids and positions
The id of the application for which the requested app appears in the similar apps section
The position in the similar apps list in which the requested app appears.
The percentile the requested app belongs to in this country, based on how many similar apps list it appears in.
{
"content": {
"application_id": 454638411,
"reverse_similar_apps": [
{
"application_id": 310633997,
"position": 2
},
{
"application_id": 579523206,
"position": 4
},
{
"application_id": 1204219634,
"position": 7
},
{
"application_id": 1389694636,
"position": 8
},
{
"application_id": 1457993244,
"position": 9
},
{
"application_id": 1131708905,
"position": 10
},
{
"application_id": 1441179129,
"position": 11
},
{
"application_id": 1073521090,
"position": 12
},
{
"application_id": 400169658,
"position": 13
},
{
"application_id": 429047995,
"position": 14
}
],
"percentile": 18
},
"metadata": {
"request": {
"path": "/applications/454638411/reverse-similar-apps.json",
"store": "ios",
"params": {
"country": "gb",
"id": "454638411",
"format": "json"
},
"performed_at": "2019-07-15 16:17:06 UTC"
},
"content": {
}
}
}