Monitor Task Landing Pages Overview
- API Name: Monitor Task Landing Pages Overview
- Request Method: POST
- API URL:
open-api/v1/monitor/data
- Endpoint Path:
/v3/api/ad-monitor-task/landing-pages-overview
- Description:
- Get landing pages overview data for monitor task
- Statistics of ad count and its proportion for different landing pages
- Support pagination query for landing page data
- Analyze ad distribution for landing pages
- Usage Note:
Free
Request Headers:
- Content-Type: application/json
- Accept: application/json
Request Parameters
Request Structure
| Parameter |
Type |
Description |
Example |
Required |
Default |
| key |
string |
User's external API request key |
"your_api_key_here" |
Yes |
|
| uri |
string |
Endpoint path |
"/v3/api/ad-monitor-task/landing-pages-overview" |
Yes |
|
| params |
object |
Request parameters object |
See parameter list |
Yes |
|
Request Body Parameters (params object)
| Parameter |
Type |
Required |
Description |
| task_id |
String |
true |
Task ID |
| page |
integer |
false |
Page number (default 1) |
| per_page |
integer |
false |
Page size (default 10) |
Request Example
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
}
}'
Response Parameters
Response Structure
{
"code": 200,
"message": "success",
"data": {},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 0,
"fail": false,
"success": true
}
Response Field Description
| Field Name |
Type |
Description |
| code |
Integer |
Response status code, 200 means success |
| message |
String |
Response message |
| data |
Object |
Response data |
| version |
String |
API version |
| timestamp |
String |
Response timestamp |
| sign |
String |
Response signature |
| remaining_credits |
Long |
Current remaining available credits after this request |
| consumed_credits |
Long |
Credits consumed by this request |
| success |
Boolean |
Request success status |
| fail |
Boolean |
Request failure status |
| Field Name |
Type |
Description |
| per_page |
integer |
Items per page |
| total |
integer |
Total records |
| last_page |
integer |
Last page number |
| current_page |
integer |
Current page number |
| data |
|
Landing page data fields (each object in data array) |
| data[].proportion |
double |
Ad proportion for this landing page (decimal between 0-1) |
| data[].ad_count |
integer |
Ad count for this landing page |
| data[].landing_page_url |
string |
Landing page URL address |
Response Example
{
"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
}
Error Codes
| Error Code |
Description |
| 200 |
Success |
| 400 |
Invalid request parameters |
| 500 |
Internal server error |