2003-Market-Search Volume Charts

Request

Authorization

Add parameter in header

x-openapi-key

Example:

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

Body Params application/json

Example

{
  "regions": [
    "US",
    "CN"
  ],
  "store": "AS",
  "device": "IPHONE",
  "category": "36",
  "type": "ALL",
  "limit": "TOP_200"
}

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location 'https://api.foxdata.com/apiv1/open-api/ranking/volume-ranking' \
--header 'x-openapi-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "regions": [
    "US",
    "CN"
  ],
  "store": "AS",
  "device": "IPHONE",
  "category": "36",
  "type": "ALL",
  "limit": "TOP_200"
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
  "requestParam": {
    "regions": [
      "US",
      "CN",
      "KR",
      "JP"
    ],
    "store": "AS",
    "device": "IPHONE",
    "category": "36",
    "keywords": null,
    "type": "ALL",
    "limit": "TOP_400"
  },
  "result": {
    "iconPrefix": "https://is1-ssl.mzstatic.com/image/thumb",
    "appInfoMap": {
      "282614216": {
        "appName": "eBay online shopping & selling",
        "icon": "/Purple211/v4/36/c0/c4/36c0c492-bde2-897b-5f9e-b30f4553c274/AppIcon-0-0-1x_U007epad-0-1-0-85-220.png/88x88w.png"
      },
      "282935706": {
        "appName": "Bible",
        "icon": "/Purple221/v4/bf/5e/21/bf5e2186-6fff-3c00-49b1-0e238595522e/AppIcon-0-0-1x_U007epad-0-1-0-sRGB-0-85-220.png/88x88w.png"
      }
    },
    "ranking": [
      {
        "keyword": "x",
        "tag": {
          "brandAppIds": [
            "1250312807",
            "333903271",
            "1043429899",
            "587197095"
          ],
          "generic": true
        },
        "regions": [
          {
            "region": "US",
            "num": 95,
            "trend": [
              96,
              96,
              95,
              95,
              95,
              95,
              95
            ]
          },
          {
            "region": "CN",
            "num": 83,
            "trend": [
              83,
              83,
              83,
              83,
              83,
              83,
              83
            ]
          },
          {
            "region": "KR",
            "num": 97,
            "trend": [
              97,
              97,
              97,
              97,
              97,
              97,
              97
            ]
          },
          {
            "region": "JP",
            "num": 96,
            "trend": [
              100,
              100,
              100,
              98,
              96,
              96,
              96
            ]
          }
        ]
      }
    ],
    "dateMap": {
      "JP": [
        "2025-12-02",
        "2025-12-03"
      ],
      "KR": [
        "2025-12-02",
        "2025-12-03"
      ],
      "CN": [
        "2025-12-02",
        "2025-12-03"
      ],
      "US": [
        "2025-12-02",
        "2025-12-03"
      ]
    }
  },
  "creditsCost": {
    "requestCredits": 0,
    "baseCredits": 400,
    "extraCredits": 0,
    "totalCostCredits": 400
  },
  "next": null
}