Monitor Task Landing Pages Overview

API Information

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
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

Response Data Information Fields

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