Pipispy APIEnglish

数据消耗规则:1. 获取一条数据结果消耗1 数据,获取数据结果的更多数据详情不消耗数据。2. 广告监控: 每次监控 $1 / 月。单个监控有效期为一个月,一个月后自动停止。删除监控不会恢复监控次数,请谨慎删除。监控调用为随时且无限次。

App 开发者榜单列表接口

接口信息

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

请求头:

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

请求参数

请求结构

参数名 类型 描述 示例 必填 默认值
key string 用户申请的外部 api 请求 key "your_api_key_here" 是
uri string 接口路径 "/v3/api/open/rank/app-dev/list" 是
params object 接口入参对象 见参数列表 是

参数列表 (params 对象)

参数名 类型 描述 示例 必填 默认值
current_page integer 当前页码 1 是
page_size integer 每页数据量 20 是
sort_key string 排序字段: digg_count_growth-点赞数, digg_growth_rate-增长率, video_count-广告数,app_download_count-总安装数,latest_download_count-月安装数,last_month_revenue-月收入额(USD) "count_growth" 是
sort_type string 排序方式: desc-降序, asc-升序 "desc" 是
time integer 时间范围: 0-默认, 1-1 天, 2-3 天, 3-7 天, 4-1 个月, 5-3 个月, 6-6 个月 1 是
type integer 时间类型: 0-默认, 1-日榜, 2-周榜, 3-月榜 1 是
app_category string App 分类,支持多个,字符串拼接 "id6003,id6023" 否
app_count_max long App 数量最大值 50 否
app_count_min long App 数量最小值 1 否
app_download_count_max long App 下载数最大值 1000000 否
app_download_count_min long App 下载数最小值 1000 否
app_system string App 系统: ios/android "ios" 否
app_type string App 类型: app/game "app" 否
count_growth_max double 数据增长最大值(播放数增长) 1000000 否
count_growth_min double 数据增长最小值(播放数增长) 1000 否
play_count_growth_max long 广告播放 1000000 No
play_count_growth_min long 广告播放 1000 No
digg_count_growth_max double 点赞数增长最大值 10000 否
digg_count_growth_min double 点赞数增长最小值 100 否
digg_growth_rate_max double 点赞增长率最大值 1.0 否
digg_growth_rate_min double 点赞增长率最小值 0.1 否
growth_rate_max double 数据增长率最大值 1.0 否
growth_rate_min double 数据增长率最小值 0.1 否
install_count_max long 安装数最大值 500000 否
install_count_min long 安装数最小值 1000 否
last_month_app_download_count_max long 上个月 App 下载数最大值 50000 否
last_month_app_download_count_min long 上个月 App 下载数最小值 1000 否
last_month_revenue_max double 上个月收入最大值(USD) 100000 否
last_month_revenue_min double 上个月收入最小值(USD) 1000 否
plat_type integer 平台类型: 0-全部平台, 1-TikTok, 2-Facebook 1 否
region string 目标地区,支持多个,字符串拼接 "US,CA,GB" 否

请求示例

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-dev/list",
    "params": {
      "current_page": 1,
      "page_size": 20,
      "sort_key": "count_growth",
      "sort_type": "desc",
      "time": 1,
      "type": 1,
      "app_category": "id6003,id6023",
      "app_count_min": 1,
      "app_count_max": 50,
      "app_download_count_min": 1000,
      "app_download_count_max": 1000000,
      "app_system": "ios",
      "app_type": "app",
      "count_growth_min": 1000,
      "count_growth_max": 1000000,
      "digg_count_growth_min": 100,
      "digg_count_growth_max": 10000,
      "digg_growth_rate_min": 0.1,
      "digg_growth_rate_max": 1.0,
      "growth_rate_min": 0.1,
      "growth_rate_max": 1.0,
      "install_count_min": 1000,
      "install_count_max": 500000,
      "last_month_app_download_count_min": 1000,
      "last_month_app_download_count_max": 50000,
      "last_month_revenue_min": 1000,
      "last_month_revenue_max": 100000,
      "popular_person_count_min": 1,
      "popular_person_count_max": 100,
      "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
}

响应字段说明

主要响应字段
字段名 类型 描述
data array[object] App 开发者榜单列表
page object 分页信息
version string API 版本
timestamp string/null 响应时间戳
sign string/null 响应签名
remaining_credits Long 当前请求后的剩余可用积分
consumed_credits Long 本次请求消耗的积分
success boolean 请求成功状态
fail boolean 请求失败状态
数据项字段
字段名 类型 描述
id string App 开发者唯一标识 ID
name string App 开发者名称
icon string App 开发者图标 URL
rate_score double 评分
rate_count integer 评分数量
play_count long 总播放数
is_collection boolean 是否已收藏
digg_count_growth_rate double 点赞数增长率
max_cpm double 最大 CPM(千次展示成本)
app_store array[string] 应用商店平台(apple/google)
revenue object 收入信息对象
digg_count long 总点赞数
latest_download_count long 最新下载数
app_comment_count long App 评论数
ad_platform_list array[string] 广告平台列表(tiktok/facebook)
video_count long 视频数量
app_system array[string] App 系统平台(ios/android)
app_download_count long 总 App 下载数
play_count_growth_rate double 播放数增长率
min_cpm double 最小 CPM(千次展示成本)
app_count long App 数量
收入对象字段
字段名 类型 描述
unit string 收入单位(分)
currency string 货币类型(USD)
type string 值类型(currency)
value long 收入值(以分为单位)
分页对象字段
字段名 类型 描述
total_count number 总数量
page_count number 总页数
current_page number 当前页码
page_size number 每页数据量
is_next boolean 是否有下一页

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      {
        "id": "1322881000",
        "name": "TikTok Ltd.",
        "icon": "https://cdn-app.pipispy.com/fec3b999ed026c90c9ee9d2423fd634b.jpg",
        "rate_score": 0.0,
        "rate_count": 0,
        "play_count": 6435411646,
        "is_collection": false,
        "digg_count_growth_rate": 0.068,
        "max_cpm": 24544321.31,
        "app_store": ["apple"],
        "revenue": {
          "unit": "cent",
          "currency": "USD",
          "type": "currency",
          "value": 14400300000
        },
        "digg_count": 28094952,
        "latest_download_count": 6100000,
        "app_comment_count": 18931330,
        "ad_platform_list": ["tiktok", "facebook"],
        "video_count": 6284,
        "app_system": ["ios"],
        "app_download_count": 111100000,
        "play_count_growth_rate": 0.1867,
        "min_cpm": 6282994.0,
        "app_count": 5
      }
    ],
    "page": {
      "total_count": 6039,
      "page_count": 302,
      "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
}

错误码说明

错误码 描述
200 成功
400 请求参数错误
401 未授权 - API 密钥无效
500 服务器内部错误