Reverse Similar Apps history (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/language. The results will contain an array of apps for each days inluded in the date range (starting from the start date).
The two letter country code (ISO Alpha-2) you want to fetch the app in.
Get the list of our country codes, here.
The two letter language (ISO Alpha-2) you want to fetch the application in.
Get the list of our language codes, here.
The first date for which to get data in YYYY-MM-DD format
The last date for which to get data in YYYY-MM-DD format
GET /ios/applications/983693694/reverse-similar-apps-history.json?country=be&language=fr&start_date=2020-08-09&end_date=2020-08-24
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/ios/applications/454638411/reverse-similar-apps-history.json?country=be&language=fr&start_date=2020-08-09&end_date=2020-08-24"
The response will contains an array of arrays (one for each day of the date range) of app objects containing similar app infos.
An array containing arrays of app objects
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 app power of the similar app
Views received from the similar apps section
The percentile the requested app belongs to in this country, based on how many similar apps list it appears in.
{
"content": {
"start_date": "2020-08-20",
"end_date": "2020-08-21",
"similar_apps": [
{
"apps": [
{
"application_id": 1490329988,
"position": 15,
"power": 0.0,
"impressions": 0
},
{
"application_id": 579523206,
"position": 4,
"power": 24.6,
"impressions": 114
},
{
"application_id": 1473573829,
"position": 11,
"power": 0.0,
"impressions": 0
},
{
"application_id": 1278828853,
"position": 11,
"power": 0.0,
"impressions": 0
}
],
"percentile": 10
},
{
"apps": [
{
"application_id": 1490329988,
"position": 15,
"power": 0.0,
"impressions": 0
},
{
"application_id": 579523206,
"position": 4,
"power": 24.6,
"impressions": 112
},
{
"application_id": 1473573829,
"position": 11,
"power": 0.0,
"impressions": 0
},
{
"application_id": 1278828853,
"position": 11,
"power": 0.0,
"impressions": 0
}
],
"percentile": 10
}
]
},
"metadata": {
"request": {
"path": "/applications/454638411/reverse-similar-apps-history.json",
"store": "ios",
"params": {
"start_date": "2020-08-20T00:00:00+00:00",
"end_date": "2020-08-21T00:00:00+00:00",
"country": "us",
"position_cutoff": 16,
"id": "454638411",
"format": "json"
},
"performed_at": "2020-08-24 20:44:38 UTC"
},
"content": {
}
}
}