Pipispy APIEnglish

App 开发者列表接口

接口信息

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

参数列表 (params 对象)

必填参数

参数名 类型 描述 示例 必填 默认值
current_page
integer
当前页码(必填)
1
是
page_size
integer
每页数量(必填)
20
是
plat_type
integer
平台类型(必填):0-全部,1-TikTok,2-Facebook
1
是
sort
integer
排序字段(必填):0-总广告数,1-广告播放,2-总点赞数,4-总投放天数,7-总开始时间,8-总结束时间,9-App 数量,10-总安装数,11-月安装数,12-月收入额(USD)
1
是
time
long
时间范围(必填):0-近7天,1-近30天,2-近90天,4-昨天,3-全部时间
1640995200
是

可选参数(按字母顺序)

参数名 类型 描述 示例 必填 默认值
app_category
array
App 分类列表,支持格式:["id6003", "id6023"] 或 ["6003", "6023"],系统会自动处理"id"前缀
["id6003", "id6023"]
否
app_comment_count_max
long
App 评论数最大值
100000
否
app_comment_count_min
long
App 评论数最小值
1000
否
app_count_max
long
App 数量最大值
100
否
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"
否
cpm_max
double
CPM 最大值
10.0
否
cpm_min
double
CPM 最小值
1.0
否
digg_count_max
long
点赞数最大值
100000
否
digg_count_min
long
点赞数最小值
1000
否
digg_rate_max
double
点赞率最大值(范围:0.0-1.0)
1.0
否
digg_rate_min
double
点赞率最小值(范围:0.0-1.0)
0.1
否
end_time_end
long
结束时间结束(时间戳,对应最近发现时间范围)
1643673600
否
end_time_start
long
结束时间开始(时间戳,对应最近发现时间范围)
1640995200
否
goods_source_max
long
商品来源最大值(注意:此字段实际对应数据量字段)
1000
否
goods_source_min
long
商品来源最小值(注意:此字段实际对应数据量字段)
10
否
keyword
string
搜索关键词,根据 searchType 的不同,搜索方式不同:1-同时搜索开发者名称和应用名称,2-仅搜索应用名称,3-仅搜索开发者名称
"MercadoLibre"
否
last_month_app_download_count_max
long
月安装数, 上个月 App 下载数最大值
50000
否
last_month_app_download_count_min
long
月安装数, 上个月 App 下载数最小值
1000
否
last_month_revenue_max
long
月收入额(USD), 上个月收入最大值(注意:系统会自动乘以 100 进行处理)
100000
否
last_month_revenue_min
long
月收入额(USD), 上个月收入最小值(注意:系统会自动乘以 100 进行处理)
1000
否
play_count_max
long
播放数最大值
10000000
否
play_count_min
long
播放数最小值
1000000
否
popular_person_count_max
long
红人数量最大值
100
否
popular_person_count_min
long
红人数量最小值
1
否
put_day_max
long
投放天数最大值
30
否
put_day_min
long
投放天数最小值
1
否
region
array
国家/地区,支持多个地区代码,例如:["BR", "TW", "MX"]
["BR", "TW", "MX"]
否
search_type
integer
搜索类型:1-关键词(同时匹配APP名称、开发者名称),2-APP名称,3-开发者名称
1
否
1
sort_type
string
排序方式:asc-升序,desc-降序
"desc"
否
"desc"
start_time_end
long
广告开始时间结束(时间戳,对应首次发现时间范围)
1643673600
否
start_time_start
long
广告开始时间开始(时间戳,对应首次发现时间范围)
1640995200
否

请求示例

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/app-dev/list",
    "params": {
      "current_page": 1,
      "page_size": 20,
      "plat_type": 1,
      "sort": 1,
      "time": 1640995200,
      "keyword": "MercadoLibre",
      "region": ["BR", "TW", "MX"],
      "app_type": "app",
      "app_system": "ios"
    }
  }'

响应参数

响应体结构

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      // App开发者列表项
    ],
    "page": {
      // 分页信息
    }
  }
}

响应字段说明

标准响应字段

字段名 类型 描述
remaining_credits
Long
当前请求后的剩余可用积分
consumed_credits
Long
本次请求消耗的积分
主要响应字段
字段名 类型 描述
data
array[object]
App 开发者列表
page
object
分页信息
数据项字段
字段名 类型 描述
id
string
App 开发者唯一标识 ID
name
string
App 开发者名称
icon
string
App 开发者图标 URL
ad_platform_list
array
广告平台列表(例如:["tiktok", "facebook"])
app_system
array
App 系统列表(例如:["ios", "android"])
app_store
array
应用商店列表(例如:["apple", "google"])
app_count
long
App 数量
app_download_count
long
总 App 下载数
app_comment_count
long
总 App 评论数
rate_score
double
App 评分
rate_count
long
评分数量
revenue
object
收入信息对象
found_time
long
首次发现时间 (时间戳)
last_found_time
long
最近发现时间 (时间戳)
last_month_app_download_count
long
上个月 App 下载数
region
array
目标地区列表
is_collection
boolean
是否已收藏
goods_source_count
long
商品来源数量(数据量)
popular_person_count
long
红人数量
put_day_change
long
投放天数变化
play_change
long
播放数变化
digg_change
long
点赞数变化
latest_data
array
最新数据数组,包含平台、URL 和数量信息
收入对象字段
字段名 类型 描述
unit
string
计量单位(例如:"cent")
currency
string
货币代码(例如:"USD")
type
string
值类型(例如:"currency")
value
long
收入值
最新数据对象字段
字段名 类型 描述
platform
integer
平台标识符
url
string
图片 URL
count
long
数量值
分页对象字段
字段名 类型 描述
total_count
number
总数量
page_count
number
总页数
current_page
number
当前页码
page_size
number
每页数据量
is_next
boolean
是否有下一页

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      {
        "id": "1754094607",
        "name": "NETSTORY PTE. LTD.",
        "icon": "https://cdn-app.pipispy.com/801cee19685e5bef313e17e836c2df70.jpg",
        "ad_platform_list": ["tiktok"],
        "app_system": ["ios"],
        "app_store": ["apple"],
        "app_count": 1,
        "app_download_count": 0,
        "app_comment_count": 61883,
        "rate_score": 4.6,
        "rate_count": 61883,
        "revenue": {
          "unit": "cent",
          "currency": "USD",
          "type": "currency",
          "value": 1100000000
        },
        "found_time": 1751558400,
        "last_found_time": 1752076800,
        "last_month_app_download_count": 0,
        "region": [
          "DE",
          "TW",
          "RU",
          "PT",
          "JP",
          "FR",
          "HU",
          "SA",
          "BR",
          "SC",
          "SG",
          "ID",
          "GB",
          "CA",
          "US",
          "AE",
          "CH",
          "KR",
          "MX",
          "IT",
          "MY",
          "ES",
          "AT",
          "AU",
          "TH",
          "CZ",
          "VN",
          "PH",
          "TR",
          "NL"
        ],
        "is_collection": false,
        "goods_source_count": 4098,
        "popular_person_count": 1,
        "put_day_change": 7,
        "play_change": 3062405,
        "digg_change": 34776,
        "latest_data": [
          {
            "platform": 1,
            "url": "https://cdn-video.pipispy.com/cover_ada1b5dae0c90e5c4849.jpg",
            "count": 855
          },
          {
            "platform": 1,
            "url": "https://cdn-video.pipispy.com/cover_52a1eb83b3133814a76b.jpg",
            "count": 1122
          },
          {
            "platform": 1,
            "url": "https://cdn-video.pipispy.com/cover_fc6b7355ef13c217a26c.jpg",
            "count": 973
          }
        ]
      }
    ],
    "page": {
      "total_count": 10000,
      "page_count": 500,
      "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
服务器内部错误