监控任务广告文案(最长运营)
接口信息
- 接口名称: 监控任务广告文案(最长运营)
- 请求方法: POST
- 接口地址:
open-api/v1/monitor/data
- 接口路径:
/v3/api/ad-monitor-task/ad-copy-longest-run
- 接口描述:
- 获取广告文案-最长运营列表,分析广告文案的持续投放时间
- 价格说明:
免费
请求头:
- Content-Type: application/json
- Accept: application/json
请求参数
请求结构
| 参数名 |
类型 |
描述 |
示例 |
必填 |
默认值 |
| key |
string |
用户申请的外部 api 请求 key |
"your_api_key_here" |
是 |
|
| uri |
string |
接口路径 |
"/v3/api/ad-monitor-task/ad-copy-longest-run" |
是 |
|
| params |
object |
接口入参对象 |
见参数列表 |
是 |
|
请求体参数 (params 对象)
| 参数名 |
类型 |
必填 |
描述 |
| task_id |
String |
true |
任务id |
| order_by |
String |
false |
排序字段 active_days ad_started_at |
| direction |
String |
false |
排序方式 desc(降序) asc(升序) |
| page |
integer |
false |
页码 (默认值1) |
| per_page |
integer |
false |
分页大小 (默认值10) |
请求示例
curl -X POST "https://www.pipispy.com/open-api/v1/monitor/data" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"key": "your_api_key_here",
"uri": "/v3/api/ad-monitor-task/ad-copy-longest-run",
"params": {
"task_id": "68fa2e36789edb5700215e03",
"order_by": "active_days",
"direction": "desc",
"per_page": 10,
"page": 1
}
}'
响应参数
响应体结构
{
"code": 200,
"message": "success",
"data": {},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 0,
"success": true,
"fail": false
}
响应字段说明
| 字段名 |
类型 |
描述 |
| code |
Integer |
响应状态码,200 表示成功 |
| message |
String |
响应消息 |
| data |
Object |
响应数据 |
| version |
String |
API 版本 |
| timestamp |
String |
响应时间戳 |
| sign |
String |
响应签名 |
| remaining_credits |
Long |
当前请求后的剩余可用积分 |
| consumed_credits |
Long |
本次请求消耗的积分 |
| success |
Boolean |
请求是否成功 |
| fail |
Boolean |
请求是否失败 |
响应结果信息字段
分页信息字段
| 字段名 |
类型 |
描述 |
| per_page |
integer |
每页显示数量 |
| total |
integer |
总记录数 |
| last_page |
integer |
最后一页页码 |
| current_page |
integer |
当前页码 |
广告文案数据字段(data数组中的对象)
| 字段名 |
类型 |
描述 |
| ad_id |
string |
广告唯一标识ID |
| ad_content |
string |
广告文案内容 |
| ad_started_at |
integer |
广告开始投放时间戳(秒) |
| active_days |
integer |
广告活跃天数 |
| ad_status |
integer |
广告状态(1:活跃,2:不活跃,3:下架) |
| media_format |
integer |
媒体格式(1:视频,2:图片,3:轮播图) |
轮播卡片信息字段(cards数组中的对象)
| 字段名 |
类型 |
描述 |
| cover_url |
string |
卡片封面图片URL |
| media_type |
integer |
媒体类型(1:视频,2:图片) |
| url |
string |
媒体文件URL(视频或图片) |
响应示例
{
"code": 200,
"message": "success",
"data": {
"per_page": 1,
"total": 14383,
"data": [
{
"ad_id": "533113862830147",
"cards": [
{
"cover_url": "https://cdn.pipidata.com/images/9192627b9a36040a50fe2de4b498af66bd5dbd6eba3105319e6741143ef98ad3.png",
"media_type": 1,
"url": "https://cdn.pipidata.com/videos/5fa61671bec84b95fc8c89b2d6b1c1c2b32b645cdd52a5d518e6e2df13a6e5d8.mp4"
},
{
"cover_url": "https://cdn.pipidata.com/images/b580a01a2b3c53582c0973c76435745b4bc98c1a9aa5d02a85c1ba1d8fff06eb.png",
"media_type": 1,
"url": "https://cdn.pipidata.com/videos/39716ecc4d74112db9bbb9cd39ebc574548a3c335afd3dffdf61adff689089cf.mp4"
},
{
"cover_url": "https://cdn.pipidata.com/images/8a01532735407f02653e6bcf2614ede57378f2489993f524a4411187e0ce85af.png",
"media_type": 1,
"url": "https://cdn.pipidata.com/videos/c79d0d74990f35d70b3a454d393f69267fba3b51f62ccd78baaea086f22cb602.mp4"
},
{
"cover_url": "https://cdn.pipidata.com/images/1aed919d9871dcfef51b68b063ca8ee901e59a869319a51e3a71f408d5928fe0.png",
"media_type": 1,
"url": "https://cdn.pipidata.com/videos/77448e042c5babe93bddbd63b09e147f87d89f48dced4f62545003768dfdc48b.mp4"
},
{
"cover_url": "https://cdn.pipidata.com/images/46a27759af20e2be7870263f781eb8c0077440d62242eb798abc7b19eac271db.png",
"media_type": 1,
"url": "https://cdn.pipidata.com/videos/ee1162127729f52b9943234cbf23f8c67cec59a2956d183bb83d88e9d4e88716.mp4"
}
],
"media_format": 3,
"ad_content": "Werken bij Coolblue",
"ad_started_at": 1731916800,
"active_days": 184,
"ad_status": 1
}
],
"last_page": 14383,
"current_page": 1
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 0,
"success": true,
"fail": false
}
错误码说明
| 错误码 |
描述 |
| 200 |
成功 |
| 400 |
请求参数错误 |
| 500 |
服务器内部错误 |