App 开发者详情接口
接口信息
- 接口名称: 获取 App 开发者详情
- 请求方法: POST
- 接口地址:
/open-api/v1/data - 接口路径:
/v3/api/open/app-dev/detail - 接口描述: 根据开发者 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-dev/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-dev/detail",
"params": {
"id": "507f1f77bcf86cd799439011"
}
}'
响应参数
响应体结构
{
"code": 200,
"message": "success",
"data": {
// App开发者详情信息
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 1,
"success": true,
"fail": false
}
响应字段说明
标准响应字段
| 字段名 | 类型 | 描述 |
|---|---|---|
remaining_credits | Long | 当前请求后的剩余可用积分 |
consumed_credits | Long | 本次请求消耗的积分 |
主要响应字段
| 字段名 | 类型 | 描述 |
|---|---|---|
id | String | App 开发者唯一标识 ID |
icon | String | App 开发者图标 URL |
name | String | App 开发者名称 |
url | String | App 开发者商店链接 |
ad_platform_list | Array | 广告平台列表 |
app_system | Array | App 系统列表 (如: android, ios) |
all_data_count | Long | 总数据数量 |
app_count | Long | App 数量 |
app_download_count | Long | 总 App 下载次数 |
app_comment_count | Long | 总 App 评论次数 |
revenue | Object | 收入信息对象 |
first_time | Long | 首次时间 (时间戳) |
found_time | Long | 首次发现时间 (时间戳) |
latest_found_time | Long | 最新发现时间 (时间戳) |
last_month_app_download_count | Long | 上月 App 下载次数 |
region | Array | 目标地区列表 |
is_collection | Boolean | 是否已收藏 |
收入信息字段 (revenue)
| 字段名 | 类型 | 描述 |
|---|---|---|
unit | String | 收入单位 (如: "cent") |
currency | String | 货币代码 (如: "USD") |
type | String | 收入类型 (如: "currency") |
value | Long | 收入数值 |
响应示例
{
"code": 200,
"message": "success",
"data": {
"id": "7318974570271626660",
"icon": "https://cdn-app.pipispy.com/0b6854aa841473b2657939f3221880f0.jpg",
"name": "Knowunity",
"url": "https://play.google.com/store/apps/dev?id=7318974570271626660",
"ad_platform_list": ["tiktok"],
"app_system": ["android"],
"all_data_count": 95,
"app_count": 1,
"app_download_count": 13506812,
"app_comment_count": 0,
"revenue": {
"unit": "cent",
"currency": "USD",
"type": "currency",
"value": 4000000
},
"first_time": 1623380257,
"found_time": 1623380257,
"latest_found_time": 1752198253,
"last_month_app_download_count": 500000,
"region": [
"DE",
"PT",
"IT",
"GR",
"MX",
"FR",
"ES",
"BR",
"CZ",
"GB",
"PL",
"RO",
"US",
"TR"
],
"is_collection": false
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 1,
"success": true,
"fail": false
}
错误码说明
| 错误码 | 描述 |
|---|---|
200 | 成功 |
400 | 请求参数错误 |
401 | 未授权 - API 密钥无效 |
404 | 未找到 - App 开发者不存在 |
500 | 服务器内部错误 |