Pipispy APIEnglish

获取监控任务详情

接口信息

  • 接口名称: 获取监控任务详情
  • 请求方法: 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
服务器内部错误