2001-Market-Realtime Charts

POST

/ranking/realtime

Query app store chart rankings across countries and categories.

Request

Authorization

Add parameter in header

x-openapi-key

Example:

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

Body Params application/json

Example

{
  "region": "US",
  "store": "AS",
  "device": "IPAD",
  "category": "-1",
  "start": "2025-09-19",
  "end": "2025-09-20"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.foxdata.com/apiv1/open-api/ranking/realtime' \
--header 'x-openapi-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "region": "US",
  "store": "AS",
  "device": "IPAD",
  "category": "-1",
  "start": "2025-09-19",
  "end": "2025-09-20"
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
  "requestParam": {
    "region": "US",
    "store": "AS",
    "device": "IPAD",
    "category": "-1",
    "start": "2025-09-19",
    "end": "2025-09-20"
  },
  "result": [
    {
      "region": "US",
      "store": "AS",
      "device": "IPAD",
      "category": "-1",
      "date": "2025-09-20",
      "charts": [
        {
          "rankType": "FREE",
          "apps": [
            {
              "appId": "545519333",
              "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/b5/67/d8/b567d87b-e9f9-d217-875a-22cc52cfc704/AppIcon-0-0-1x_U007epad-0-1-0-0-85-220.png/88x88w.png",
              "title": "Amazon Prime Video",
              "rank": 1,
              "change": 0
            }
          ]
        },
        {
          "rankType": "PAID",
          "apps": [
            {
              "appId": "479516143",
              "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/48/d0/37/48d0370e-cc6c-f1e2-1d36-6322809ba598/AppIcon-0-0-1x_U007emarketing-0-10-0-85-220.png/88x88w.png",
              "title": "Minecraft: Dream it, Build it!",
              "rank": 1,
              "change": 1
            }
          ]
        },
        {
          "rankType": "TOP_GROSSING",
          "apps": [
            {
              "appId": "544007664",
              "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/bc/ff/e5/bcffe5f4-c5cd-ea33-d747-9f1acda1e084/logo_youtube_2024_q4_color-0-1x_U007emarketing-0-0-0-7-0-0-0-85-220-0.png/88x88w.png",
              "title": "YouTube",
              "rank": 1,
              "change": 0
            }
          ]
        }
      ]
    }
  ],
  "creditsCost": {
    "requestCredits": 0,
    "baseCredits": 20,
    "extraCredits": 0,
    "totalCostCredits": 20
  },
  "next": null
}

Modified at 2026-06-25 05:44:00

1021-App-CPP Keywords

2002-Market-Global Chart Analysis