创建监控任务

本文档介绍如何通过广告主账号创建监控任务。创建监控任务支持以下四种方式：

优先级说明: 如果同时提交多个参数，系统按以下优先级使用: facebook_page_id_list > facebook_page_url_list > facebook_public_page_number_list > facebook_shop_url_list

接口一：广告主搜索

接口信息

• 接口名称: 广告主搜索
• 请求方法: POST
• 接口地址: open-api/v1/monitor/data
• 接口路径: /v3/api/ad-monitor-task/search-fb-ads-advertiser
• 接口描述: 根据关键词搜索广告主信息，返回匹配的广告主列表。用户可以根据返回的 facebook_page_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/search-fb-ads-advertiser",
    "params": {
      "name": "example"
    }
  }'

响应参数

响应体结构

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      {
        "facebook_page_id": "714739975064116",
        "name": "Example Advertiser",
        "avatar_url": "https://example.com/avatar.jpg",
        "category": "Digital creator",
        "country": null
      }
    ]
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "success": true,
  "fail": false
}

响应字段说明

响应结果信息字段

接口二：创建监控任务

接口信息

• 接口名称: 创建监控任务
• 请求方法: POST
• 接口地址: open-api/v1/monitor/data
• 接口路径: /v3/api/ad-monitor-task/create-monitor-task
• 接口描述: 批量创建广告主或店铺/网站的监控任务，支持四种输入方式，并返回每个任务的创建结果。
• 价格说明: 每成功创建一个监控任务，将扣除1积分

请求头:

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

请求参数

请求结构

请求体参数 (params 对象)

注意事项:

1. 以上四个参数不能全为 null 或空列表，至少需要提供一个
2. 每次最多可添加 50 个监控对象
3. 如果同时提交多个参数，系统按优先级使用: facebook_page_id_list > facebook_page_url_list > facebook_public_page_number_list > facebook_shop_url_list

请求示例

方式1：通过广告主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/create-monitor-task",
    "params": {
      "facebook_page_id_list": ["614178972053891", "714739975064116"]
    }
  }'

方式2：通过广告主链接创建

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/create-monitor-task",
    "params": {
      "facebook_page_url_list": ["https://www.facebook.com/example"]
    }
  }'

方式3：通过公共主页编号创建

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/create-monitor-task",
    "params": {
      "facebook_public_page_number_list": ["123456789"]
    }
  }'

方式4：通过店铺/网站链接创建

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/create-monitor-task",
    "params": {
      "facebook_shop_url_list": ["https://example.com"]
    }
  }'

响应参数

响应体结构

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "task_id": "1005",
      "facebook_page_id": "614178972053891",
      "facebook_page_url": null,
      "facebook_public_page_number": null,
      "facebook_shop_url": null,
      "error_message": null
    }
  ],
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "fail": false,
  "success": true
}

响应字段说明

响应结果信息字段

错误码说明