Pipispy APIEnglish

App 新榜列表接口

接口信息

  • 接口名称: 获取 App 新榜列表
  • 请求方法: POST
  • 接口地址: /open-api/v1/data
  • 接口路径: /v3/api/open/rank/app-new/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-new/list"
是
params
object
接口入参对象
见参数列表
是

参数列表 (params 对象)

参数名 类型 描述 示例 必填 默认值
current_page
integer
当前页码
1
是
found_time
double
发现时间范围: 0-默认, 1-3 天, 2-7 天, 3-1 个月, 4-3 个月, 5-6 个月, 6-全部
1
是
page_size
integer
每页数据量
20
是
sort_key
string
排序字段: count_growth-播放数增长, growth_rate-增长率, video_count-广告数
"count_growth"
是
sort_type
string
排序方式: desc-降序, asc-升序
"desc"
是
type
integer
时间类型: 0-默认, 1-24 小时, 2-3 天, 3-7 天
1
是
create_time_type
integer
创建时间类型: 1~6 近 3 天、近 7 天、近 1 个月、近 3 个月、近 6 个月、全部
1
是
app_category
string
App 分类，支持多个，字符串拼接
"id6003,id6023"
否
app_system
string
App 系统: ios/android
"ios"
否
app_type
string
App 类型: app/game
"app"
否
count_growth_max
double
数据增长最大值(播放数增长)
1000000
否
count_growth_min
double
数据增长最小值(播放数增长)
1000
否
growth_rate_max
double
数据增长率最大值
1.0
否
growth_rate_min
double
数据增长率最小值
0.1
否
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-new/list",
    "params": {
      "current_page": 1,
      "found_time": 1,
      "page_size": 20,
      "sort_key": "count_growth",
      "sort_type": "desc",
      "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
}

响应字段说明

主要响应字段
字段名 类型 描述
code
integer
响应状态码
message
string
响应消息
data
object
响应数据对象
version
string
API 版本号
timestamp
integer/null
时间戳
sign
string/null
签名
remaining_credits
Long
当前请求后的剩余可用积分
consumed_credits
Long
本次请求消耗的积分
success
boolean
是否成功
fail
boolean
是否失败
数据对象字段
字段名 类型 描述
data
array[object]
App 榜单列表
page
object
分页信息
数据项字段
字段名 类型 描述
id
string
App 唯一标识 ID
app_name
string
App 名称
icon
string
App 图标 URL
platform
array[string]
平台列表，如["tiktok", "facebook"]
region
array[string]
目标地区列表，如["US", "CA", "GB"]
app_category
object
App 分类信息
app_rate
object
App 评分信息
app_type
string
App 类型(app/game)
app_store
string
应用商店(apple/google)
app_download_count
long
下载量
app_comment_count
long
评论数
play_count
long
播放数
video_count
long
视频数量
digg_count
long
点赞数
put_day
integer
上线天数
found_time
long
发现时间戳
latest_found_time
long
最新发现时间戳
is_collection
boolean
是否已收藏
last_month_revenue
object
上月收入信息
play_count_growth_rate
double
播放数增长率
digg_growth_rate
double
点赞增长率
latest_download_count
long
最新下载量
app_dev_info
object
开发者信息
created_time
long
创建时间戳
App 分类对象字段
字段名 类型 描述
id
string
分类 ID
name
string
分类名称
type
string
分类类型
app_system
string
应用系统
children
array[object]
子分类列表
App 评分对象字段
字段名 类型 描述
score
double
评分
count
long
评分数量
收入对象字段
字段名 类型 描述
unit
string
单位(cent)
currency
string
货币类型(USD)
type
string
类型(currency)
value
long
收入值(分)
开发者信息对象字段
字段名 类型 描述
name
string
开发者名称
icon
string
开发者图标
id
string
开发者 ID
email
string
开发者邮箱
url
string
开发者链接
website_url
string
官网链接(可选)
avatar
string
头像(可选)
分页对象字段
字段名 类型 描述
total_count
number
总数量
page_count
number
总页数
current_page
number
当前页码
page_size
number
每页数据量
is_next
boolean
是否有下一页

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      {
        "platform": ["tiktok"],
        "id": "44eced5a4740e4062566",
        "icon": "https://cdn-app.pipispy.com/f1e8e137f2582e41f5e7bccd327e954d.jpg",
        "region": ["ID", "JP", "SG", "US", "TH", "MY", "CA"],
        "app_name": "Lemon8 - Lifestyle Community",
        "app_category": {
          "id": "googleapp",
          "name": "App",
          "type": "app",
          "app_system": "android",
          "children": [
            {
              "id": "LIFESTYLE",
              "name": "Lifestyle",
              "type": "app",
              "app_system": "android"
            }
          ]
        },
        "app_rate": {
          "score": 4.7058825,
          "count": 201979
        },
        "app_type": "app",
        "app_store": "google",
        "app_download_count": 28744075,
        "app_comment_count": 202439,
        "play_count": 352576845,
        "video_count": 396,
        "digg_count": 13886211,
        "put_day": 717,
        "found_time": 1690011301,
        "latest_found_time": 1752131772,
        "is_collection": false,
        "last_month_revenue": {
          "unit": "cent",
          "currency": "USD",
          "type": "currency",
          "value": 100000
        },
        "play_count_growth_rate": 0.1841,
        "digg_growth_rate": 0.3007,
        "latest_download_count": 1000000,
        "app_dev_info": {
          "name": "TikTok Pte. Ltd.",
          "icon": "f1e8e137f2582e41f5e7bccd327e954d.jpg",
          "id": "8354621850408287155",
          "email": "[email protected]",
          "url": "https://play.google.com/store/apps/developer?id=TikTok+Pte.+Ltd."
        },
        "created_time": 1583425601
      }
    ],
    "page": {
      "total_count": 6645,
      "page_count": 333,
      "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
服务器内部错误