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