1005-App-Ranking History

POST

/app/rank/history

Query app chart rankings in the app market (defaults to today).

Request

Authorization

Add parameter in header

x-openapi-key

Example:

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

Body Params application/json

Example

{
  "appId": "com.android.chrome",
  "region": "US",
  "device": "IPHONE",
  "start": "2025-09-20",
  "end": "2025-09-30"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.foxdata.com/apiv1/open-api/app/rank/history' \
--header 'x-openapi-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "appId": "com.android.chrome",
  "region": "US",
  "device": "IPHONE",
  "start": "2025-09-20",
  "end": "2025-09-30"
}'

Responses

🟢200

application/json

Bodyapplication/json

Examples

Success ExampleSuccess Example

{
  "requestParam": {
    "appId": "com.android.chrome",
    "region": "US",
    "device": "IPHONE",
    "start": "2025-09-20",
    "end": "2025-09-30"
  },
  "result": {
    "appId": "com.android.chrome",
    "title": "Google Chrome",
    "icon": "https://image1.foxdata.com/gp-proxy/QRRGW2tMZ4-FNw0XWk6WWiXHaQCGxuwM-92HrBhlA4WOd_AGmjVmQkiHyAqQjW2yByc",
    "ranks": [
      {
        "categoryId": "COMMUNICATION",
        "chartsType": "FREE",
        "data": [
          {
            "date": "2025-09-20",
            "value": 50
          }
        ]
      }
    ]
  },
  "creditsCost": {
    "requestCredits": 0,
    "baseCredits": 110,
    "extraCredits": 0,
    "totalCostCredits": 110
  },
  "next": null
}

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

1004-App-Apps by Same Developer

1006-App-Featured Recommendations