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