监控任务的最新广告商品
接口信息
- 接口名称: 监控任务的最新广告商品
- 请求方法: 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 |
服务器内部错误 |