3003-Volume Ranking

POST

/ranking/volume-ranking

Request

Authorization

Add parameter in header

x-openapi-key

Example:

x-openapi-key: ********************

Header Params

Body Params application/json

Example

{
    "regions": [
        "string"
    ],
    "store": "AS",
    "device": "IPHONE",
    "category": "string",
    "keywords": [
        "string"
    ],
    "type": "KeywordType.ALL",
    "limit": "{size: 200, point: 200}"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.foxdata.com/apiv1/ranking/volume-ranking' \
--header 'x-openapi-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regions": [
        "string"
    ],
    "store": "AS",
    "device": "IPHONE",
    "category": "string",
    "keywords": [
        "string"
    ],
    "type": "KeywordType.ALL",
    "limit": "{size: 200, point: 200}"
}'

Responses

🟢200

application/json

Body

Example

{
  "requestParam": {
    "regions": [
      ""
    ],
    "store": "",
    "device": "",
    "category": "",
    "keywords": [
      ""
    ],
    "type": "",
    "limit": ""
  },
  "result": {
    "iconPrefix": "",
    "appInfoMap": {
      "": {
        "appId": "",
        "appName": "",
        "icon": ""
      }
    },
    "ranking": [
      {
        "keyword": "",
        "tag": {
          "brandAppIds": [
            ""
          ],
          "generic": false
        },
        "regions": [
          {
            "region": "",
            "num": 0,
            "trend": [
              0
            ]
          }
        ]
      }
    ],
    "dateMap": {
      "": [
        ""
      ]
    }
  },
  "creditsCost": {
    "requestCredits": 0,
    "baseCredits": 0,
    "extraCredits": 0,
    "totalCostCredits": 0
  },
  "next": {
    "taskId": "",
    "pageKey": ""
  }
}

Modified at 2026-03-25 06:37:08

3002-Global Ranking

3004-Download/Revenue Ranking