Reverse Similar Apps (Incoming)

GET 5 Credits / Request /ios/applications/{APPLICATION_ID}/reverse-similar-apps.json

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.

Reverse Similar Apps Request

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.

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 us

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/{APPLICATION_ID}/reverse-similar-apps.json

Request example
GET /ios/applications/454638411/reverse-similar-apps.json?country=gb
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/ios/applications/454638411/reverse-similar-apps.json?country=gb"

Reverse Similar Apps Response

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.

Object properties
reverse_similar_apps: array

An array containing hashes of applications ids and positions

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.

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