监控任务广告文案（最长运营）
接口信息
- 接口名称: 监控任务广告文案（最长运营）
- 请求方法: 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 | 排序字段 <br/>active_days<br/>ad_started_at |
direction | String | false | 排序方式 <br/>desc(降序)<br/>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 | 服务器内部错误 |