# 获取监控任务详情 ## 接口信息 - **接口名称**: 获取监控任务详情 - **请求方法**: 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 | ### 请求示例 ```bash 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" } }' ``` ## 响应参数 ### 响应体结构 ```json { "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 | 图片广告总数 | ## 响应示例 ```json { "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 | 服务器内部错误 |