获取监控任务详情
接口信息
- 接口名称: 获取监控任务详情
- 请求方法: POST
- 接口地址:
open-api/v1/monitor/data
- 接口路径:
/v3/api/ad-monitor-task/monitor-task-details
- 接口描述:
- 根据任务ID获取监控任务的完整详情信息
- 返回任务的详细监控数据和统计信息
- 价格说明:
免费
请求头:
- Content-Type: application/json
- Accept: application/json
请求参数
请求结构
| 参数名 |
类型 |
描述 |
示例 |
必填 |
默认值 |
| key |
string |
用户申请的外部 api 请求 key |
"your_api_key_here" |
是 |
|
| uri |
string |
接口路径 |
"/v3/api/ad-monitor-task/monitor-task-details" |
是 |
|
| params |
object |
接口入参对象 |
见参数列表 |
是 |
|
请求体参数 (params 对象)
| 参数名 |
类型 |
必填 |
描述 |
| task_id |
String |
true |
任务id |
请求示例
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/monitor-task-details",
"params": {
"task_id": "68fa2e36789edb5700215e03"
}
}'
响应参数
响应体结构
{
"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 |
请求是否失败 |
响应结果信息字段
| 字段名 |
类型 |
描述 |
| task_id |
string |
监控任务ID |
| monitor_task_type |
integer |
监控任务类型,1:facebook广告主, 2:店铺/网站 |
| facebook_page_id |
string |
fb广告主id |
| facebook_page_url |
string |
fb广告主Url |
| facebook_shop_url |
string |
fb店铺url |
| facebook_shop_search_url |
string |
fb店铺搜索url |
| name |
string |
监控对象名称 |
| avatar_url |
string |
监控对象头像 |
| category |
string |
广告主展示fb ad library上的类别, 店铺/网站没有 |
| country |
string |
广告主国家(部分有), 店铺国家 |
| ad_total_count |
integer |
总广告数 |
| ad_total_active_count |
integer |
总活跃 |
| ad_today_count |
integer |
今日新增广告数 |
| ad_yesterday_count |
integer |
昨日新增广告数 |
| landing_page_total_count |
integer |
落地页总数 |
| landing_page_today_count |
integer |
落地页今日新增 |
| landing_page_yesterday_count |
integer |
落地页昨日新增 |
| product_total_count |
integer |
总产品数 |
| product_today_count |
integer |
产品今日新增 |
| product_yesterday_count |
integer |
产品昨日新增 |
| latest_ad_data |
array [object {3}] |
最新广告数据 |
| latest_ad_data[].id |
string |
广告id |
| latest_ad_data[].cover_url |
string |
封面 |
| latest_ad_data[].ad_started_at |
integer |
发布时间时间戳 ,单位s |
| latest_ad_data[].video_url |
string |
广告视频URL |
| latest_ad_data[].duration |
integer |
广告时长,单位秒 |
| latest_ad_data[].type |
integer |
广告类型 |
| monitored_days |
integer |
已监控天数 |
| started_at |
integer |
监控开始时间,时间戳,单位s |
| stoped_at |
integer |
监控结束时间,时间戳,单位s |
| status |
integer |
监控状态 1: 监控中, 2: 已取消监控 |
| monitor_expire_time |
integer |
监控到期时间,时间戳,单位s |
| updated_at |
integer |
更新时间,时间戳,单位s |
| ad_seven_day_count |
integer |
近7日新增广告数 |
| landing_page_seven_day_count |
integer |
落地页近7日新增数 |
| product_seven_day_count |
integer |
产品近7日新增数 |
| videos_ad_total_count |
integer |
视频广告总数 |
| cards_ad_total_count |
integer |
卡片广告总数 |
| images_ad_total_count |
integer |
图片广告总数 |
响应示例
{
"code": 200,
"message": "success",
"data": {
"country": "NL",
"latest_ad_data": [
{
"duration": 13,
"cover_url": "https://cdn.pipidata.com/images/439074ded5f202adb25735dd6fe314746e915da78ad5943c74f654b371c3805e.png",
"video_url": "https://cdn.pipidata.com/videos/817e5577729a49b4209146b7d861c34666614027da845e7a8a506531b7174572.mp4",
"id": "1502412787841300",
"ad_started_at": 1758092400,
"type": 1
},
{
"duration": 15,
"cover_url": "https://cdn.pipidata.com/images/628ccca0f5a5c970ba0d10e883f7056d0e3c4127e228a90ba9757a8a178d2de4.png",
"video_url": "https://cdn.pipidata.com/videos/e40e5c23b76ebf4032fb62ca94e427ceba056d4d53d2b57366555daec8ae40ef.mp4",
"id": "1113997597539089",
"ad_started_at": 1758092400,
"type": 1
},
{
"duration": 15,
"cover_url": "https://cdn.pipidata.com/images/257cdc076722895d58a40ba8ab31038e7033956180ad6ceb21a86bcd9b62358b.png",
"video_url": "https://cdn.pipidata.com/videos/26b6953b738b4d1698495c3ec6a7cf7bcb1040f4aeeecbcf59909e06a82bbbba.mp4",
"id": "1958643064678656",
"ad_started_at": 1758092400,
"type": 1
},
{
"duration": 15,
"cover_url": "https://cdn.pipidata.com/images/f913d72811a64528338eedd8062f908ff1324059db412536e077851b386ccd62.png",
"video_url": "https://cdn.pipidata.com/videos/91193fc731d22c8cfd3206aad35a4e4c902a4bd955449c8ee39a47892cb565f0.mp4",
"id": "1545429736453611",
"ad_started_at": 1758092400,
"type": 1
},
{
"duration": 15,
"cover_url": "https://cdn.pipidata.com/images/7fad186aba7636ae10c51debf09247e0f2bb372468fd36daa1e06364c0d6dd94.png",
"video_url": "https://cdn.pipidata.com/videos/0dc52f548ebca789e3ee2d0d982a524ae7be2edbd2ada28e58119b6792c5f4cc.mp4",
"id": "1421665719390535",
"ad_started_at": 1758092400,
"type": 1
},
{
"duration": 13,
"cover_url": "https://cdn.pipidata.com/images/192a8d2f8ccfecd7a68bd99c00589024a649e196e88cead34cb24fcd54528aaa.png",
"video_url": "https://cdn.pipidata.com/videos/5a38836f6260e70900973cc3b84e8417f2721936cc7cff7685e35498b8ff1eba.mp4",
"id": "2223893774765270",
"ad_started_at": 1758092400,
"type": 1
},
{
"duration": 15,
"cover_url": "https://cdn.pipidata.com/images/9ac2e9f2046d112bd8e01cba9f2a29d137d93b895e88c48daf6b575c008c16b2.png",
"video_url": "https://cdn.pipidata.com/videos/707d0c738b84c5bc9ce1d74043bd214445826c35b9edc29e98d3753a3f1dd01b.mp4",
"id": "1455369045677992",
"ad_started_at": 1758092400,
"type": 1
},
{
"duration": 13,
"cover_url": "https://cdn.pipidata.com/images/9b0a36757a739ff863e76ecad274d3616df96864dd94434394ada290c709e0bb.png",
"video_url": "https://cdn.pipidata.com/videos/a8af033b5617edc148b86b88b98c3bf02c3e48640e010f72e6b5bd507cd3b42f.mp4",
"id": "1321866939415735",
"ad_started_at": 1758092400,
"type": 1
}
],
"product_seven_day_count": 0,
"landing_page_yesterday_count": 0,
"task_id": "68fa2e36789edb5700215e03",
"product_yesterday_count": 0,
"videos_ad_total_count": 13479,
"ad_yesterday_count": 0,
"updated_at": 1761235805,
"monitor_task_type": 1,
"product_today_count": 0,
"ad_total_active_count": 7143,
"monitored_days": 1,
"facebook_page_url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=ALL&is_targeted_country=false&media_type=all&search_type=page&view_all_page_id=422603325536",
"ad_seven_day_count": 0,
"landing_page_seven_day_count": 0,
"product_total_count": 0,
"cards_ad_total_count": 852,
"images_ad_total_count": 52,
"facebook_page_id": "422603325536",
"ad_total_count": 14383,
"landing_page_today_count": 0,
"landing_page_total_count": 1294,
"avatar_url": "https://cdn.pipidata.com/images/b467aa4e0f396674a14f1ffaa99a1d76.png",
"ad_today_count": 0,
"name": "Coolblue",
"started_at": 1761228363,
"stoped_at":null,
"status": 1,
"monitor_expire_time": 1763821563,
"category": "Retail Company"
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 0,
"success": true,
"fail": false
}
错误码说明
| 错误码 |
描述 |
| 200 |
成功 |
| 400 |
请求参数错误 |
| 500 |
服务器内部错误 |