Category Services

Top Charts ( 10 Credits / Request )

Provides top charts information for given category, country, ranking type and device.

bash

GET /appstore-category-v2/topcharts/{version}/{categoryId}/{countryCode}/{rankingType}/{targetDevice}?date={date}

Request Parameters

Parameter	Description
`version`	(required) "v1" for iOS 11 and before, "v2" for iOS 12+ (currently only overall category is available)
`categoryId`	(required) Integer category id
`countryCode`	(required) Two letter country code
`rankingType`	(required) FREE, PAID, GROSSING
`targetDevice`	(required) IPHONE, IPAD
`date`	(required) YYYY-MM-DD formatted date

Response Fields

Field	Description
`countryCode`	Two letter country code, category rankings are mapped by this
`categoryId`	Category code, date and rankings are mapped according to this
`targetDevice`	IPHONE or IPAD
`rankingType`	FREE, PAID, GROSSING
`date`	Date in LocalDateTime format
`trackIds`	List of AppStore track ids, sorted by ranking

Example request

bash

curl "https://api.mobileaction.co/appstore-category-v2/topcharts/v1/36/US/FREE/IPHONE?date=2019-03-01&token=YOUR_API_KEY"

Example response

json

{
  "countryCode": "US",
  "categoryId": 36,
  "targetDevice": "IPHONE",
  "rankingType": "FREE",
  "date": "2019-03-01T23:05:17",
  "trackIds": [
    1448852425,
    544007664,
    310633997,
    454638411,
    1445450568,
    389801252,
    284882215,
    447188370,
    422689480,
    711923939
  ]
}

Category Ranking ( 10 Credits / Request )

Provides category rankings history of an app in AppStore. Max 30 days of history is allowed for a single request.

bash

GET /appstore-category-v2/rankings/{version}/{trackId}/{countryCode}?hourly={hourly}&startDate={startDate}&endDate={endDate}

Request Parameters

Parameter	Description
`version`	(required) "v1" for iOS 11 and before, "v2" for iOS 12+ (currently only overall category is available)
`trackId`	(required) AppStore track id of app
`hourly`	(required) "true" for exact values, "false" for aggregated daily average values.
`countryCode`	(required) Two letter country code
`startDate`	(required) YYYY-MM-DD formatted date, history start date, inclusive.
`endDate`	(required) YYYY-MM-DD formatted date, history end date, exclusive.

Response Fields

Field	Description
`trackId`	AppStore track id of app
`countryCode`	Two letter country code, category rankings are mapped by this
`categoryId`	Category code, date and rankings are mapped according to this
`targetDevice`	IPHONE or IPAD
`rankingType`	FREE, PAID, GROSSING
`date`	Date in LocalDateTime format
`rank`	Category ranking value

Example request

bash

curl "https://api.mobileaction.co/appstore-category-v2/rankings/v1/529479190/US?hourly=false&startDate=2019-02-01&endDate=2019-02-02&token=YOUR_API_KEY"

Example response

json

{
  "trackId": 529479190,
  "ranksByCategory": {
    "US": {
      "36": [
        {
          "targetDevice": "IPHONE",
          "rankingType": "FREE",
          "rankingsByDate": [
            {
              "date": "2019-02-01T00:00:00",
              "ranking": 214
            },
            {
              "date": "2019-02-02T00:00:00",
              "ranking": 223
            }
          ]
        },
        {
          "targetDevice": "IPHONE",
          "rankingType": "GROSSING",
          "rankingsByDate": [
            {
              "date": "2019-02-01T00:00:00",
              "ranking": 11
            },
            {
              "date": "2019-02-02T00:00:00",
              "ranking": 11
            }
          ]
        },
        {
          "targetDevice": "IPAD",
          "rankingType": "FREE",
          "rankingsByDate": [
            {
              "date": "2019-02-01T00:00:00",
              "ranking": 236
            },
            {
              "date": "2019-02-02T00:00:00",
              "ranking": 253
            }
          ]
        },
        {
          "targetDevice": "IPAD",
          "rankingType": "GROSSING",
          "rankingsByDate": [
            {
              "date": "2019-02-01T00:00:00",
              "ranking": 15
            },
            {
              "date": "2019-02-02T00:00:00",
              "ranking": 14
            }
          ]
        }
      ],
      "6014": [
        {
          "targetDevice": "IPHONE",
          "rankingType": "FREE",
          "rankingsByDate": [
            {
              "date": "2019-02-01T00:00:00",
              "ranking": 71
            },
            {
              "date": "2019-02-02T00:00:00",
              "ranking": 81
            }
          ]
        },
        {
          "targetDevice": "IPHONE",
          "rankingType": "GROSSING",
          "rankingsByDate": [
            {
              "date": "2019-02-01T00:00:00",
              "ranking": 6
            },
            {
              "date": "2019-02-02T00:00:00",
              "ranking": 5
            }
          ]
        },
        {
          "targetDevice": "IPAD",
          "rankingType": "FREE",
          "rankingsByDate": [
            {
              "date": "2019-02-01T00:00:00",
              "ranking": 144
            },
            {
              "date": "2019-02-02T00:00:00",
              "ranking": 162
            }
          ]
        },
        {
          "targetDevice": "IPAD",
          "rankingType": "GROSSING",
          "rankingsByDate": [
            {
              "date": "2019-02-01T00:00:00",
              "ranking": 13
            },
            {
              "date": "2019-02-02T00:00:00",
              "ranking": 13
            }
          ]
        }
      ]
    }
  }
}

Global Last Day Category Rankings ( 20 Credits / Request )

Provides global category rankings of an app in AppStore for last day.

bash

GET /appstore-category-v2/global-rankings-last-day/{trackId}/{device}

Request Parameters

Parameter	Description
`trackId`	(required) Appstore track id of the app.
`device`	(required) IPHONE or IPAD.

Response Fields

Field	Description
`trackId`	AppStore track id of app
`countryCode`	Two letter country code, category rankings are mapped by this
`categoryId`	Category code, date and rankings are mapped according to this
`targetDevice`	IPHONE or IPAD
`rankingType`	FREE, PAID, GROSSING
`date`	Date in LocalDateTime format
`rank`	Category ranking value

Example request

bash

curl "https://api.mobileaction.co/appstore-category-v2/global-rankings-last-day/529479190/IPHONE?token=YOUR_API_KEY"

Example response

json

{
  "trackId": 529479190,
  "ranksByCategory": {
    "LI": {
      "36": [
        {
          "targetDevice": "IPHONE",
          "rankingType": "FREE",
          "rankingsByDate": [
            {
              "date": "2019-06-18T05:30:05",
              "ranking": 217
            }
          ]
        },
        {
          "targetDevice": "IPHONE",
          "rankingType": "GROSSING",
          "rankingsByDate": [
            {
              "date": "2019-06-18T05:30:06",
              "ranking": 5
            }
          ]
        }
      ],
      "6014": [
        {
          "targetDevice": "IPHONE",
          "rankingType": "FREE",
          "rankingsByDate": [
            {
              "date": "2019-06-18T05:28:15",
              "ranking": 89
            }
          ]
        },
        {
          "targetDevice": "IPHONE",
          "rankingType": "GROSSING",
          "rankingsByDate": [
            {
              "date": "2019-06-18T05:28:17",
              "ranking": 1
            }
          ]
        }
      ],
      "7001": [
        {
          "targetDevice": "IPHONE",
          "rankingType": "FREE",
          "rankingsByDate": [
            {
              "date": "2019-06-18T05:28:54",
              "ranking": 27
            }
          ]
        },
        {
          "targetDevice": "IPHONE",
          "rankingType": "GROSSING",
          "rankingsByDate": [
            {
              "date": "2019-06-18T05:28:56",
              "ranking": 1
            }
          ]
        }
      ],
      "7017": [
        {
          "targetDevice": "IPHONE",
          "rankingType": "FREE",
          "rankingsByDate": [
            {
              "date": "2019-06-18T05:29:51",
              "ranking": 6
            }
          ]
        },
        {
          "targetDevice": "IPHONE",
          "rankingType": "GROSSING",
          "rankingsByDate": [
            {
              "date": "2019-06-18T05:29:53",
              "ranking": 1
            }
          ]
        }
      ]
    }
  }
}

New Apps ( 3 Credits / Request )

Provides app infos for newly released app for given country and category.

bash

GET /appstore-category-v2/new-apps/{categoryId}/{countryCode}/{rankingType}?date={date}

Request Parameters

Parameter	Description
`category`	(required) Category id
`countryCode`	(required) Two letter country code
`rankingType`	(required) FREE, PAID or GROSSING
`date`	(optional) YYYY-MM-DD formatted date, default value is yesterday's date

Response Fields

Field	Description
`trackId`	Appstore track id of app
`name`	App name
`url`	App URL
`price`	App price
`iconUrl`	URL containing app's icon
`releaseDate`	Release date of the app in date-time format
`developerName`	Name of the developer

Example request

bash

curl "https://api.mobileaction.co/appstore-category-v2/new-apps/6000/US/FREE?token=YOUR_API_KEY"

Example response

json

[
  {
    "trackId": "1567876275",
    "name": "Ahsen Demir Çelik",
    "url": "Ahsen Demir Çelik",
    "price": "0.00",
    "iconUrl": "https://is3-ssl.mzstatic.com/image/thumb/Purple125/v4/61/e5/54/61e55409-7134-724a-92be-7d5dce0f10d2/AppIcon-0-0-1x_U007emarketing-0-0-0-5-0-0-sRGB-0-0-0-GLES2_U002c0-512MB-85-220-0-0.png/100x100bb.png",
    "category": "6000",
    "releaseDate": "2021-05-18T00:00:00",
    "developerName": "Ramazan Oksuz"
  },
  {
    "trackId": "1567902120",
    "name": "Alan Tierney and Partners",
    "url": "Alan Tierney and Partners",
    "price": "0.00",
    "iconUrl": "https://is3-ssl.mzstatic.com/image/thumb/Purple125/v4/04/6d/b9/046db94b-ea74-0a33-bff3-d53affbbc3ac/AppIcons-1x_U007emarketing-0-7-0-0-85-220.png/100x100bb.png",
    "category": "6000",
    "releaseDate": "2021-05-18T00:00:00",
    "developerName": "Alan Tierney and Partners Ltd"
  },
  {
    "trackId": "1567951917",
    "name": "Alpine Insurance",
    "url": "Alpine Insurance",
    "price": "0.00",
    "iconUrl": "https://is4-ssl.mzstatic.com/image/thumb/Purple115/v4/05/1d/c0/051dc01c-e4d7-dc18-faa5-fa53e88e43c4/AppIcons-1x_U007emarketing-0-7-0-0-85-220.png/100x100bb.png",
    "category": "6000",
    "releaseDate": "2021-05-18T00:00:00",
    "developerName": "Alpine Insurance & Financial Inc."
  }
]

Category Services ​

Top Charts ( 10 Credits / Request ) ​

Category Ranking ( 10 Credits / Request ) ​

Global Last Day Category Rankings ( 20 Credits / Request ) ​

New Apps ( 3 Credits / Request ) ​

Category Services

Top Charts ( 10 Credits / Request )

Category Ranking ( 10 Credits / Request )

Global Last Day Category Rankings ( 20 Credits / Request )

New Apps ( 3 Credits / Request )