App 榜单列表接口

接口信息

• 接口名称: 获取 App 投放榜单列表
• 请求方法: POST
• 接口地址: /open-api/v1/data
• 接口路径: /v3/api/open/rank/app/list
• 接口描述: 根据过滤条件获取 App 榜单列表信息，支持分页
• 价格说明: 获取一条数据结果消耗1 credit

请求头:

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

请求参数

请求结构

参数列表 (params 对象)

请求示例

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"
    }
  }'

响应参数

响应体结构

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      // App榜单列表项
    ],
    "page": {
      // 分页信息
    }
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 20,
  "success": true,
  "fail": false
}

响应字段说明

主要响应字段

数据对象字段

数据项字段

App 分类对象字段

App 评分对象字段

收入对象字段

开发者信息对象字段

分页对象字段

响应示例

{
  "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
}

错误码说明