Pipispy APIEnglish

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

App 详情接口

接口信息

  • 接口名称: 获取 App 详情
  • 请求方法: POST
  • 接口地址: /open-api/v1/data
  • 接口路径: /v3/api/open/app/detail
  • 接口描述: 根据 App ID 获取 App 详细信息
  • 价格说明: 详情接口计费规则: 基础费用:1 credit/次。 免费访问条件(满足其一即可): 该ID在3天内已获取过详情;该ID在3天内出现在您的榜单列表查询结果中。

请求头:

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

请求参数

请求结构

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

参数列表 (params 对象)

参数名 类型 必填 描述
id String 是 App ID

请求示例

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/detail",
    "params": {
      "id": "61d787d667dcc8ca6a82"
    }
  }'

响应参数

响应体结构

{
  "code": 200,
  "message": "success",
  "data": {
    // App详情信息
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "success": true,
  "fail": false
}

响应字段说明

主要响应字段
字段名 类型 描述
id String App ID
name String App 名称
icon String App 图标 URL
rate Object 评分信息
url String App 商店链接
app_download_count Number App 下载次数
app_comment_count Number App 评论数
desc String App 描述
app_system String App 系统 (ios/android)
app_store String App 商店 (apple/google)
app_type String App 类型 (app/game)
app_category Object App 分类信息
app_create_time Number App 创建时间 (时间戳)
app_update_time Number App 更新时间 (时间戳)
ad_platform_list Array 广告平台列表
app_dev Object 开发者信息
is_collection Boolean 是否收藏
revenue Object 收入信息
last_month_app_download_count Number 上月下载次数
images Array App 截图列表
all_data_count Number 总数据量
top_region Array 主要地区
top_in_app_purchases Array 应用内购买信息
keywords Array 关键词列表
评分信息字段 (rate)
字段名 类型 描述
score Number 评分
count Number 评分数量
rate1 Number 1 星评分数量
rate2 Number 2 星评分数量
rate3 Number 3 星评分数量
rate4 Number 4 星评分数量
rate5 Number 5 星评分数量
App 分类信息字段 (app_category)
字段名 类型 描述
id String 分类 ID
name String 分类名称
type String 分类类型
app_system String App 系统
app_store String App 商店
children Array 子分类列表
开发者信息字段 (app_dev)
字段名 类型 描述
id String 开发者 ID
name String 开发者名称
email String 开发者邮箱
url String 开发者 URL
icon String 开发者图标 URL
avatar String 开发者头像 URL
website_url String 开发者网站 URL (可选)
收入信息字段 (revenue)
字段名 类型 描述
unit String 单位 (cent)
currency String 货币类型 (USD 等)
type String 类型 (currency)
value Number 收入值 (以分为单位)
应用内购买信息字段 (top_in_app_purchases)
字段名 类型 描述
price String 价格范围描述
关键词信息字段 (keywords)
字段名 类型 描述
name String 关键词名称
url String 关键词搜索链接
响应根级别字段
字段名 类型 描述
code Number 响应状态码
message String 响应消息
data Object App 详情数据
version String API 版本号
timestamp Number/null 时间戳
sign String/null 签名
remaining_credits Long 当前请求后的剩余可用积分
consumed_credits Long 本次请求消耗的积分
success Boolean 请求是否成功
fail Boolean 请求是否失败

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "id": "69474be0ed2cecb479b1",
    "name": "Stickman vs Monster: Idle RPG",
    "icon": "https://cdn-app.pipispy.com/86f80c31e7712aa1ff486b1ff210028b.jpg",
    "rate": {
      "score": 4.8965516,
      "count": 12565,
      "rate1": 216,
      "rate2": 0,
      "rate3": 0,
      "rate4": 433,
      "rate5": 11916
    },
    "url": "https://play.google.com/store/apps/details?id=com.stickman.monster.epic.stickman.war.shadow.idle.game",
    "app_download_count": 1528081,
    "app_comment_count": 12566,
    "desc": "<b>Idle Gameplay, Epic Rewards</b><br>Stickman vs Monster offers a relaxed and enjoyable gaming experience...",
    "app_system": "android",
    "app_store": "google",
    "app_type": "game",
    "app_category": {
      "id": "googlegame",
      "name": "Game",
      "type": "game",
      "children": [
        {
          "id": "GAME_ROLE_PLAYING",
          "name": "Role Playing",
          "type": "game",
          "app_system": "android"
        }
      ],
      "app_system": "android"
    },
    "app_create_time": 1736218411,
    "app_update_time": 1750895087,
    "ad_platform_list": ["tiktok"],
    "app_dev": {
      "id": "7752608683054605616",
      "name": "Fansipan Limited",
      "email": "[email protected]",
      "url": "https://play.google.com/store/apps/dev?id=7752608683054605616",
      "icon": "https://cdn-app.pipispy.com/c8bb0c844b7fe66799bed62b7da8a166.jpg",
      "avatar": "https://cdn-app.pipispy.com/c8bb0c844b7fe66799bed62b7da8a166.jpg"
    },
    "is_collection": false,
    "revenue": {
      "unit": "cent",
      "currency": "USD",
      "type": "currency",
      "value": 2000000
    },
    "last_month_app_download_count": 200000,
    "images": [
      "https://cdn-app.pipispy.com/c37bd0ad1bb037fd89f174846d2b434f.jpg",
      "https://cdn-app.pipispy.com/59ba6218aa9ac9c8de05aef730d0f9d9.jpg",
      "https://cdn-app.pipispy.com/f71de19f71464fa8a2070f37362ac812.jpg"
    ],
    "all_data_count": 937,
    "top_region": ["US", "VN", "TW"],
    "top_in_app_purchases": [
      {
        "price": "$1.49 - $99.99 per item"
      }
    ],
    "keywords": [
      {
        "name": "Idle RPG",
        "url": "/store/search?q=Idle+RPG+games&c=apps"
      },
      {
        "name": "Stylized",
        "url": "/store/search?q=Stylized+games&c=apps"
      },
      {
        "name": "Monster",
        "url": "/store/search?q=Monster+games&c=apps"
      },
      {
        "name": "Stickman",
        "url": "/store/search?q=Stickman+games&c=apps"
      }
    ]
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "success": true,
  "fail": false
}

错误码说明

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