App Rank List API

API Information

• API Name: Get Top Apps Rank List
• Request Method: POST
• API URL: /open-api/v1/data
• API Path: /v3/api/open/rank/app/list
• API Description: Get app rank list information based on filter conditions, supports pagination
• Pricing: Retrieving one data result consumes 1 credit

Request Headers:

• Content-Type: application/json
• Accept: application/json

Request Parameters

Request Structure

Parameter List (params object)

Request Example

curl -X POST "https://www.pipispy.com/open-api/v1/data" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "key": "your_api_key_here",
    "uri": "/v3/api/open/rank/app/list",
    "params": {
      "current_page": 1,
      "page_size": 20,
      "sort_key": "count_growth",
      "sort_type": "desc",
      "time": 1,
      "type": 1,
      "app_category": "id6003,id6023",
      "app_system": "ios",
      "app_type": "app",
      "count_growth_min": 1000,
      "count_growth_max": 1000000,
      "growth_rate_min": 0.1,
      "growth_rate_max": 1.0,
      "plat_type": 1,
      "region": "US,CA,GB"
    }
  }'

Response Parameters

Response Body Structure

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      // App rank list items
    ],
    "page": {
      // Pagination information
    }
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 20,
  "success": true,
  "fail": false
}

Response Field Description

Main Response Fields

Data Object Fields

Data Item Fields

App Category Object Fields

App Rating Object Fields

Revenue Object Fields

Developer Info Object Fields

Page Object Fields

Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      {
        "platform": ["tiktok", "facebook"],
        "id": "17cdd4b2fc9c3e0fc0df",
        "icon": "https://cdn-app.pipispy.com/15b5139d7abb7892a0624fe0d96b3286.jpg",
        "region": [
          "US",
          "AU",
          "CA",
          "EG",
          "GB",
          "BR",
          "PE",
          "MX",
          "FR",
          "SA",
          "MY",
          "JP",
          "VN",
          "SG",
          "IT",
          "DE",
          "AE",
          "PT",
          "IE",
          "NL",
          "PH",
          "ID",
          "IN",
          "ES",
          "TW",
          "TR"
        ],
        "app_name": "TikTok - Videos, Shop & LIVE",
        "app_category": {
          "id": "id36",
          "name": "App",
          "type": "app",
          "app_system": "ios",
          "children": [
            {
              "id": "id6016",
              "name": "Entertainment",
              "type": "app",
              "app_system": "ios"
            },
            {
              "id": "id6008",
              "name": "Photo & Video",
              "type": "app",
              "app_system": "ios"
            }
          ]
        },
        "app_rate": {
          "score": 4.7,
          "count": 18153387
        },
        "app_type": "app",
        "app_store": "apple",
        "app_download_count": 99000000,
        "app_comment_count": 18153387,
        "play_count": 49774290,
        "video_count": 67,
        "digg_count": 4084565,
        "put_day": 2627,
        "found_time": 1616402946,
        "latest_found_time": 1751806943,
        "is_collection": false,
        "last_month_revenue": {
          "unit": "cent",
          "currency": "USD",
          "type": "currency",
          "value": 15300000000
        },
        "play_count_growth_rate": 0.0474,
        "digg_growth_rate": 0.7988,
        "latest_download_count": 6000000,
        "app_dev_info": {
          "website_url": "http://www.tiktok.com",
          "name": "TikTok Ltd.",
          "icon": "https://cdn-app.pipispy.com/15b5139d7abb7892a0624fe0d96b3286.jpg",
          "id": "1322881000",
          "email": "",
          "url": "https://apps.apple.com/us/developer/tiktok-ltd/id1322881000"
        },
        "created_time": 1396411200
      }
    ],
    "page": {
      "total_count": 5441,
      "page_count": 273,
      "current_page": 1,
      "page_size": 20,
      "is_next": true
    }
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 20,
  "success": true,
  "fail": false
}

Error Code Description