Pipispy APIEnglish

监控任务落地页概况

接口信息

  • 接口名称: 监控任务落地页概况
  • 请求方法: POST
  • 接口地址: open-api/v1/monitor/data
  • 接口路径: /v3/api/ad-monitor-task/landing-pages-overview
  • 接口描述:
    • 获取监控任务中落地页的概览数据
    • 统计不同落地页的广告数量及其占比
    • 支持分页查询落地页数据
    • 分析落地页的广告分布情况
    • 价格说明: 免费

请求头:

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

请求参数

请求结构

参数名 类型 描述 示例 必填 默认值
key
string
用户申请的外部 api 请求 key
"your_api_key_here"
是
uri
string
接口路径
"/v3/api/ad-monitor-task/landing-pages-overview"
是
params
object
接口入参对象
见参数列表
是

请求体参数 (params 对象)

参数名 类型 必填 描述
task_id
String
true
任务id
page
integer
false
页码(默认1)
per_page
integer
false
分页大小(默认10)

请求示例

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/landing-pages-overview",
    "params": {
      "task_id": "68fa2e36789edb5700215e03",
      "page": 1,
      "per_page": 10
    }
  }'

响应参数

响应体结构

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

响应字段说明

字段名 类型 描述
code
Integer
响应状态码，200 表示成功
message
String
响应消息
data
Object
响应数据
version
String
API 版本
timestamp
String
响应时间戳
sign
String
响应签名
remaining_credits
Long
当前请求后的剩余可用积分
consumed_credits
Long
本次请求消耗的积分
success
Boolean
请求是否成功
fail
Boolean
请求是否失败

响应结果信息字段

字段名 类型 描述
per_page
integer
每页显示条数
total
integer
总记录数
last_page
integer
最后一页页码
current_page
integer
当前页码
data
落地页数据字段（data数组中的每个对象
data[].proportion
double
该落地页的广告占比（0-1之间的小数）
data[].ad_count
integer
该落地页的广告数量
data[].landing_page_url
string
落地页URL地址

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "per_page": 10,
    "total": 1294,
    "data": [
      {
        "proportion": 0.95,
        "ad_count": 136,
        "landing_page_url": "https://www.coolblue.nl/product/181901/bk-conical-deluxe-wokpan-30-cm.html"
      },
      {
        "proportion": 0.83,
        "ad_count": 119,
        "landing_page_url": "https://www.coolblue.nl/product/945962/philips-lattego-5500-ep5547-90.html"
      },
      {
        "proportion": 0.79,
        "ad_count": 114,
        "landing_page_url": "https://www.coolblue.nl/product/691068/bosch-pks-66-af.html"
      },
      {
        "proportion": 0.62,
        "ad_count": 89,
        "landing_page_url": "https://www.coolblue.nl/product/961870/arlo-essential-2k-outdoor-camera-hd-wireless-video-doorbell.html"
      },
      {
        "proportion": 0.57,
        "ad_count": 82,
        "landing_page_url": "https://www.coolblue.nl/product/958921/hp-pavilion-oled-16-af0971nd.html"
      },
      {
        "proportion": 0.56,
        "ad_count": 80,
        "landing_page_url": "https://www.coolblue.nl/product/951042/siemens-eq700-integral-roestvrijstaal-tq717r03.html"
      },
      {
        "proportion": 0.56,
        "ad_count": 80,
        "landing_page_url": "https://www.coolblue.nl/product/952302/pocketbook-verse-pro-color-grijs.html"
      },
      {
        "proportion": 0.54,
        "ad_count": 77,
        "landing_page_url": "https://www.coolblue.nl/product/946245/kobo-clara-bw-zwart.html"
      },
      {
        "proportion": 0.5,
        "ad_count": 72,
        "landing_page_url": "https://www.coolblue.nl/product/948455/samsung-galaxy-book4-edge-copilot-pc-np960xma-kb1nl.html"
      },
      {
        "proportion": 0.49,
        "ad_count": 71,
        "landing_page_url": "https://www.coolblue.nl/product/181892"
      }
    ],
    "last_page": 130,
    "current_page": 1
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "fail": false,
  "success": true
}

错误码说明

错误码 描述
200
成功
400
请求参数错误
500
服务器内部错误