Pipispy APIEnglish

监控任务的最新广告商品

接口信息

  • 接口名称: 监控任务的最新广告商品
  • 请求方法: POST
  • 接口地址: open-api/v1/monitor/data
  • 接口路径: /v3/api/ad-monitor-task/latest-products
  • 接口描述:
    • 获取监控任务中最新的广告商品数据
    • 支持限制返回商品数量
    • 提供最新的商品监控信息
    • 价格说明: 免费

请求头:

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

请求参数

请求结构

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

请求体参数 (params 对象)

参数名 类型 必填 描述
task_id
String
true
任务id
limit
integer
false
查询数量限制(默认6)

请求示例

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/latest-products",
    "params": {
      "task_id": "68f98898850c5345a4c87e66"
    }
  }'

响应参数

响应体结构

{
  "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
请求是否失败

响应结果信息字段

字段名 类型 描述
data
array [object {5}]
数据
data.product_id
string
商品ID
data.product_url
string
产品地址
data.product_name
string
商品名称
data.product_image_url
string
商品图片URL
data.ad_start_date
integer
广告开始日期，时间戳，单位s

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      {
        "product_url": "https://atoleajewelry.com/collections/waterproof-jewelry/products/initial-birthstone-charm-necklace",
        "product_id": "016ffe77783899d006894f28ab736904",
        "product_image_url": "https://fb-cdn.pipiads.com/images/pimg_e20d63ffa1cc4f3512f02.png",
        "ad_start_date": 1753340400,
        "product_name": "Initial & Birthstone Charm Necklace"
      },
      {
        "product_url": "https://atoleajewelry.com/products/wave-bracelet?utm_content=Facebook_UA&utm_source=facebook&variant=35676557574312",
        "product_id": "cd588be1dcdf69d195e0c40ee5aaa912",
        "product_image_url": "https://fb-cdn.pipiads.com/images/pimg_a163906dd1d756d701123.png",
        "ad_start_date": 1747897200,
        "product_name": "Wave Bracelet"
      },
      {
        "product_url": "https://atoleajewelry.com/products/wave-ring?utm_content=Facebook_UA&utm_source=facebook&variant=35675080949928",
        "product_id": "6e22078c8e5c62c2b289a659c416691a",
        "product_image_url": "https://fb-cdn.pipiads.com/images/pimg_4d798a9d7a717596bdf2b.png",
        "ad_start_date": 1747897200,
        "product_name": "Wave Ring"
      },
      {
        "product_url": "https://atoleajewelry.com/products/whale-tail-necklace?utm_content=Facebook_UA&utm_source=facebook&variant=35678917034152",
        "product_id": "994f3ac901bd98555ce6efc13aaebff4",
        "product_image_url": "https://fb-cdn.pipiads.com/images/pimg_fda32dd4d136fefc687e0.png",
        "ad_start_date": 1747897200,
        "product_name": "Whale Tail Necklace"
      },
      {
        "product_url": "https://atoleajewelry.com/products/summer-night-earrings?utm_content=Facebook_UA&utm_source=facebook&variant=35675114176680",
        "product_id": "2bdae269a2ec12bb6c6141772f3be055",
        "product_image_url": "https://fb-cdn.pipiads.com/images/pimg_845004d97b0143d774ed4.png",
        "ad_start_date": 1747897200,
        "product_name": "\"Summer Night\" Earrings"
      }
    ]
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "fail": false,
  "success": true
}

错误码说明

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