Reverse Similar Apps History (Incoming)

GET 30 Credits / Request / 30 days /ios/applications/{APPLICATION_ID}/reverse-similar-apps-history.json

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.

Reverse Similar Apps History Request

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).

Header parameters
X-AppTweak-Key:
Your AppTweak API Key.
Path parameters
APPLICATION_ID:
Application ID for which you want to get the the information.
Query parameters
country: string Required

The two letter country code (ISO Alpha-2) you want to fetch the app in.

Get the list of our country codes, here.

language: string Required

The two letter language (ISO Alpha-2) you want to fetch the application in.

Get the list of our language codes, here.

start_date: string

The first date for which to get data in YYYY-MM-DD format

end_date: string

The last date for which to get data in YYYY-MM-DD format

GET /ios/applications/{APPLICATION_ID}/reverse-similar-apps-history.json

Request example
GET /ios/applications/983693694/reverse-similar-apps-history.json?country=be&language=fr&start_date=2020-08-09&end_date=2020-08-24
cURL example
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"

Reverse Similar Apps History Response

The response will contains an array of arrays (one for each day of the date range) of app objects containing similar app infos.

Object properties
apps: array

An array containing arrays of app objects

CHILD PROPERTIES

application_id:

The id of the application for which the requested app appears in the similar apps section

position:

The position in the similar apps list in which the requested app appears.

power:

The app power of the similar app

impressions:

Views received from the similar apps section

percentile: number

The percentile the requested app belongs to in this country, based on how many similar apps list it appears in.

Response Example

{
  "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": {
    }
  }
}