广告主详情接口
接口信息
- 接口名称: 获取广告主详情
- 请求方法: POST
- 接口地址:
/open-api/v1/data
- 接口路径:
/v3/api/open/advertiser/detail
- 接口描述: 根据广告主 ID 获取广告主详细信息
请求头:
- Content-Type: application/json
- Accept: application/json
请求参数
请求结构
| 参数名 |
类型 |
描述 |
示例 |
必填 |
默认值 |
| key |
string |
用户申请的外部 api 请求 key |
"your_api_key_here" |
是 |
|
| uri |
string |
接口路径 |
"/v3/api/open/advertiser/detail" |
是 |
|
| params |
object |
接口入参对象 |
见参数列表 |
是 |
|
参数列表 (params 对象)
| 参数名 |
类型 |
必填 |
描述 |
| id |
String |
是 |
广告主唯一标识 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/advertiser/detail",
"params": {
"id": "66f994b3a8f1cc723674b9ff"
}
}'
响应参数
响应体结构
{
"code": 200,
"message": "success",
"data": {},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 1,
"success": true,
"fail": false
}
响应字段说明
| 字段名 |
类型 |
描述 |
| code |
Integer |
响应状态码,200 表示成功 |
| message |
String |
响应消息 |
| data |
Object |
广告主详情信息 |
| version |
String |
API 版本 |
| timestamp |
Number/null |
响应时间戳(不可用时为 null) |
| sign |
String/null |
响应签名(不可用时为 null) |
| remaining_credits |
Long |
当前请求后的剩余可用积分 |
| consumed_credits |
Long |
本次请求消耗的积分 |
| success |
Boolean |
请求是否成功 |
| fail |
Boolean |
请求是否失败 |
广告主详情字段
| 字段名 |
类型 |
描述 |
| id |
String |
广告主唯一标识 ID |
| root_path |
String |
广告主(域名) |
| app_image |
String |
应用图片 URL |
| ad_platform_list |
Array |
广告平台列表(tiktok, facebook 等) |
| shop_type |
Array |
商店类型列表 |
| data_count |
Number |
数据总数 |
| monthly_visits |
Number |
月访问量 |
| first_data_time |
Number |
首次数据时间(时间戳) |
| found_time |
Number |
发现时间(时间戳) |
| latest_found_time |
Number |
最新发现时间(时间戳) |
| region |
Array |
地区列表 |
| is_collection |
Boolean |
是否已收藏 |
响应示例
{
"code": 200,
"message": "success",
"data": {
"id": "655f4a07a1b892646643349e",
"region": [
"DE",
"TW",
"PT",
"DK",
"LT",
"LU",
"LV",
"HR",
"UA",
"HU",
"LY",
"MA",
"MF",
"YT",
"ID",
"IE",
"US",
"EE",
"MQ",
"IN",
"MT",
"IT",
"MX",
"ES",
"AT",
"RE",
"AU",
"VN",
"RO",
"NL",
"BD",
"BE",
"FI",
"BG",
"JP",
"FR",
"SA",
"SE",
"SG",
"SI",
"SK",
"GB",
"KH",
"CA",
"GF",
"GP",
"GR",
"CN",
"TH",
"LA",
"CY",
"CZ",
"PL"
],
"root_path": "donotage.org",
"app_image": "https://fb-cdn.pipispy.com/images/cb28fc3f16e9711e247b575ca4fb43b6.png",
"ad_platform_list": ["tiktok", "facebook"],
"shop_type": ["magento"],
"data_count": 368,
"monthly_visits": 243818,
"first_data_time": 1675830644,
"found_time": 1675830644,
"latest_found_time": 1752202412,
"is_collection": false
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 1,
"success": true,
"fail": false
}
错误码说明
| 错误码 |
描述 |
| 200 |
成功 |
| 400 |
请求参数错误,如缺少广告主 ID |
| 404 |
广告主不存在 |
| 500 |
服务器内部错误 |