App Category Ranking - FoxData Open API

Cost Type	Cost Credits
Request Credits	1
Base Credits	10
Extra Credits	0

Request

Header Params

x-openapi-key

string

required

Default:

Your License

Body Params application/json

appId

string

required

Application ID or packageName

region

string

required

Two character region code,like US.

Default:

US

device

enum<string> | enum<null>

optional

App Store Device, only for AppStore query.

Allowed values:

IPHONEIPAD

Example

{
  "appId": "416048305",
  "region": "KR",
  "device": "IPHONE"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.foxdata.com/apiv1/expose/app/rank' \
--header 'x-openapi-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "416048305",
    "region": "KR",
    "device": "IPHONE"
}'

Responses

🟢200Success

application/json

Body

requestParam

object (AppRankQuery)

optional

Your request param.

appId

string | null

required

Application ID or packageName

region

string | null

required

Two character region code,like US.

Default:

US

device

enum<string> | enum<null>

optional

App Store Device, only for AppStore query.

Allowed values:

IPHONEIPAD

result

object (AppRankVO)

optional

Your response.

ranks

array[object (Rank) {4}] | null

optional

creditsCost

object (OpenApiPointCostVO)

optional

Credits cost info.

requestCredits

integer | null

optional

baseCredits

integer | null

optional

extraCredits

integer | null

optional

totalCostCredits

integer | null

optional

Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "requestParam": {
      "appId": "416048305",
      "region": "KR",
      "device": "IPHONE"
    },
    "result": {
      "ranks": [
        {
          "date": "2024-05-15T04:17:48.111Z",
          "rank": 46,
          "categoryId": "36",
          "chartsType": "TOP_GROSSING"
        },
        {
          "date": "2024-05-15T04:31:00.945Z",
          "rank": 7,
          "categoryId": "6008",
          "chartsType": "TOP_GROSSING"
        },
        {
          "date": "2024-05-15T04:36:42.122Z",
          "rank": 9,
          "categoryId": "6008",
          "chartsType": "FREE"
        },
        {
          "date": "2024-05-15T07:15:01.169Z",
          "rank": 201,
          "categoryId": "36",
          "chartsType": "FREE"
        },
        {
          "date": "2024-05-15T07:16:11.138Z",
          "rank": 135,
          "categoryId": "-1",
          "chartsType": "TOP_GROSSING"
        }
      ]
    },
    "creditsCost": {
      "requestCredits": 1,
      "baseCredits": 10,
      "extraCredits": 0,
      "totalCostCredits": 11
    }
  }
}