监控任务的广告列表

接口信息

• 接口名称: 监控任务的广告列表
• 请求方法: POST
• 接口地址: open-api/v1/monitor/data
• 接口路径: /v3/api/ad-monitor-task/ad-library-list
• 接口描述:
  • 广告库查询 - 根据监控任务ID查询该任务下的所有广告数据
  • 维度筛选 - 支持按多种条件筛选广告，包括：
    • 关键字搜索
    • 广告创建时间范围
    • 广告预测状态（Testing/Scaling/Winning）
    • 广告组数量范围
    • 广告结束时间范围
    • 广告投放时长范围
    • 覆盖人数范围
    • 广告花费范围
    • 媒体格式（视频/图片/轮播图）
    • 视频时长范围
    • 按钮文本（CTA）
    • 广告平台（Facebook/Instagram等）
    • 广告状态（活跃/不活跃/下架）
    • 产品价格范围
    • 产品创建时间范围
    • 落地页URL
    • 广告文案内容
    • 关联产品ID列表
  • 排序和分页 - 支持按多种字段排序和分页查询
  • 价格说明: 免费

请求头:

• Content-Type: application/json
• Accept: application/json

请求参数

请求结构

请求体参数 (params 对象)

请求示例

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-library-list",
    "params": {
        "order_by": "ad_started_at",
        "direction": "desc",
        "page": 1,
        "ad_started_at_start": 1753574400,
        "ad_started_at_end": 1761350399,
        "per_page": 20,
        "task_id": "68fa2e36789edb5700215e03",
        "media_format_list": [
            1,
            2,
            3
        ],
        "button_text_list": [
            "Add to cart",
            "Apply now",
            "Book now",
            "Buy now"
        ]
    }
  }'

响应参数

响应体结构

{
  "code": 200,
  "message": "success",
  "data": {},
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "success": true,
  "fail": false
}

响应字段说明

响应结果信息字段

分页信息字段

广告数据字段（data数组中的对象）

视频信息字段（videos数组中的对象）

广告主信息字段（advertiser对象）

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "per_page": 20,
    "total": 1,
    "data": [
      {
        "country": [
          "NL"
        ],
        "ad_caption": "werkenbijcoolblue.nl/winkel-alkmaar",
        "button_type": "APPLY_NOW",
        "videos": [
          {
            "duration": 15,
            "cover_url": "https://cdn.pipidata.com/images/0e62b0d751f21752a0b1ab5b69f7a183949b87627d7f59a1638890cd01331b19.png",
            "width": 720,
            "url": "https://cdn.pipidata.com/videos/810468b5afa64b5f8ab521d319f02e9edc81e5de50df84b1f8a6c2966f805009.mp4",
            "height": 1280
          }
        ],
        "ad_content": "Wil je werken met de leukste collega’s? Word onderdeel van ons team. #WerkenbijCoolblue #Alkmaar",
        "last_discovered_at": 1755532885,
        "ad_title": "Word onderdeel van ons team.",
        "ad_ended_at": 1755500400,
        "ad_link": "https://www.facebook.com/ads/library/?id=1779094526050412",
        "ad_forecast": 2,
        "id": "1779094526050412",
        "latest_actived_at": 1755500400,
        "landing_page_type": 3,
        "advertiser": {
          "like_count": 463298,
          "profile_picture_url": "https://cdn.pipidata.com/images/b467aa4e0f396674a14f1ffaa99a1d76.png",
          "ad_count": 14383,
          "source_advertiser_id": "422603325536",
          "name": "Coolblue",
          "id": "422603325536",
          "ad_country": [
            "NL",
            "BE",
            "DE",
            "ES",
            "HU"
          ],
          "ads_library_link": "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_cost": 1559.74,
        "first_discovered_at": 1755532885,
        "landing_pages": [
          "https://www.werkenbijcoolblue.nl/winkels/?location=alkmaar"
        ],
        "ad_audience_reach": 11192,
        "adset_count": 1,
        "ad_status": 1,
        "media_format": 1,
        "ad_platform": [
          "FACEBOOK",
          "INSTAGRAM"
        ],
        "button_text": "Apply now",
        "ad_started_at": 1755500400,
        "active_days": 1
      }
    ],
    "last_page": 1,
    "current_page": 1
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "success": true,
  "fail": false
}

错误码说明