Similar Apps history allows you to fetch information about apps that are in the required app's similar apps section in the App Store.
The request must be done about one app in a specific country. 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 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/similar-apps-history.json?country=be&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/similar-apps-history.json?country=be&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
{
"content": {
"start_date": "2020-08-20",
"end_date": "2020-08-21",
"similar_apps": [
{
"apps": [
{
"application_id": 579523206,
"position": 1,
"power": 24.6,
"impressions": 16218
},
{
"application_id": 1374745251,
"position": 2,
"power": 35.1,
"impressions": 16218
},
{
"application_id": 1185897042,
"position": 3,
"power": 0.1,
"impressions": 6932
},
{
"application_id": 1498889847,
"position": 4,
"power": 1.6,
"impressions": 6932
}
]
},
{
"apps": [
{
"application_id": 579523206,
"position": 1,
"power": 24.6,
"impressions": 16416
},
{
"application_id": 1374745251,
"position": 2,
"power": 35.3,
"impressions": 16416
},
{
"application_id": 1185897042,
"position": 3,
"power": 0.1,
"impressions": 7016
},
{
"application_id": 1498889847,
"position": 4,
"power": 1.5,
"impressions": 7016
}
]
}
]
},
"metadata": {
"request": {
"path": "/applications/454638411/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 17:07:27 UTC"
},
"content": {
}
}
}