Pipispy APIEnglish

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

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 服务器内部错误