监控任务广告文案(最多使用)
接口信息
- 接口名称: 监控任务广告文案(最多使用)
- 请求方法: POST
- 接口地址:
open-api/v1/monitor/data
- 接口路径:
/v3/api/ad-monitor-task/ad-copy-most-used
- 接口描述:
- 获取监控任务中使用次数最多的广告文案列表
- 支持按使用次数排序
- 提供分页查询功能
- 分析广告文案的使用频率和效果
- 价格说明:
免费
请求头:
- Content-Type: application/json
- Accept: application/json
请求参数
请求结构
| 参数名 |
类型 |
描述 |
示例 |
必填 |
默认值 |
| key |
string |
用户申请的外部 api 请求 key |
"your_api_key_here" |
是 |
|
| uri |
string |
接口路径 |
"/v3/api/ad-monitor-task/ad-copy-most-used" |
是 |
|
| params |
object |
接口入参对象 |
见参数列表 |
是 |
|
请求体参数 (params 对象)
| 参数名 |
类型 |
必填 |
描述 |
| task_id |
string |
true |
任务id |
| order_by |
string |
false |
排序字段,可取值:ad_count(广告数) last_discovered_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-most-used",
"params": {
"task_id": "68fa2e36789edb5700215e03",
"direction": "desc",
"page": 1,
"per_page": 10
}
}'
响应参数
响应体结构
{
"code": 200,
"message": "success",
"data": {},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 0,
"fail": false,
"success": true
}
响应字段说明
| 字段名 |
类型 |
描述 |
| 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 |
数据总量 |
| data |
array [object {4}] |
数据 |
| data[].ad_content |
string |
文案内容 |
| data[].ad_count |
integer |
使用该文案的广告数量 |
| data[].proportion |
integer |
比例 (百分比) |
| data[].last_discovered_at |
integer |
最近使用日期(秒级时间戳) |
响应示例
{
"code": 200,
"message": "success",
"data": {
"per_page": 10,
"total": 568,
"data": [
{
"proportion": 2.59,
"ad_count": 373,
"last_discovered_at": 1758092400,
"ad_content": "Dat scheelt een haartje."
},
{
"proportion": 2.15,
"ad_count": 309,
"last_discovered_at": 1757314800,
"ad_content": "Nu met flinke korting."
},
{
"proportion": 1.83,
"ad_count": 263,
"last_discovered_at": 1757746800,
"ad_content": "Je favoriete koffie gewoon thuis? Het is je verdiende boon."
},
{
"proportion": 1.34,
"ad_count": 193,
"last_discovered_at": 1758006000,
"ad_content": "Even bijtanken."
},
{
"proportion": 1.27,
"ad_count": 183,
"last_discovered_at": 1756882800,
"ad_content": "Op zoek naar een studielaptop? Helemaal jouw typen."
},
{
"proportion": 1.25,
"ad_count": 180,
"last_discovered_at": 1758006000,
"ad_content": "Bereik stap voor stap je sportdoelen."
},
{
"proportion": 1.14,
"ad_count": 164,
"last_discovered_at": 1758006000,
"ad_content": "Bestel 'm op Coolblue.nl of in onze app."
},
{
"proportion": 1.11,
"ad_count": 160,
"last_discovered_at": 1757401200,
"ad_content": "Die kun je in je zak steken."
},
{
"proportion": 1.06,
"ad_count": 152,
"last_discovered_at": 1758006000,
"ad_content": "Een schone vloer? Even wat stoom afblazen."
},
{
"proportion": 0.98,
"ad_count": 141,
"last_discovered_at": 1758092400,
"ad_content": "Creëer je eigen thuisbioscoop en geniet van kamervullend geluid."
}
],
"last_page": 57,
"current_page": 1
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 0,
"fail": false,
"success": true
}
错误码说明
| 错误码 |
描述 |
| 200 |
成功 |
| 400 |
请求参数错误 |
| 500 |
服务器内部错误 |