Monitor Task Landing Pages List

API Information

API Name: Monitor Task Landing Pages List
Request Method: POST
API URL: open-api/v1/monitor/data
Endpoint Path: /v3/api/ad-monitor-task/landing-page-list
Description:
- Monitor Task Landing Pages List
- 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-page-list"	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
keyword	string	false	Landing page keyword
first_ad_date_start	integer	false	First ad start date, timestamp, unit: seconds
first_ad_date_end	integer	false	First ad end date, timestamp, unit: seconds
min_active_ad_count	integer	false	Minimum active ad count
max_active_ad_count	integer	false	Maximum active ad count
min_ad_count	integer	false	Minimum ad count
max_ad_count	integer	false	Maximum ad count
min_ad_days	integer	false	Minimum delivery days
max_ad_days	integer	false	Maximum delivery days
recent_ad_date_start	integer	false	Recent ad start date, timestamp, unit: seconds
recent_ad_date_end	integer	false	Recent ad end date, timestamp, unit: seconds
order_by	string	false	Sortable field<br/>active_ad_count(active ad count)<br/>ad_count(ad count)<br/>ad_days(delivery days)<br/>recent_ad_date(recent ad date)<br/>first_ad_date(first ad date)
direction	string	false	Sort order, values: desc, asc
page	integer	false	Page number
per_page	integer	false	Page size

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-page-list",
    "params": {
      "order_by": "ad_count",
      "direction": "desc",
      "min_active_ad_count": 10,
      "max_active_ad_count": 1000,
      "max_ad_count": 1000,
      "per_page": 10,
      "page": 1,
      "first_ad_date_start": 1745798400,
      "first_ad_date_end": 1761350399,
      "task_id": "68f98898850c5345a4c87e66"
    }
  }'

Response Parameters

Response Structure

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

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
current_page	integer	Current page
total	integer	Total count
last_page	integer	Last page
per_page	integer	Items per page
data	array [object]	Data
data[].landing_page_id	string	Landing page ID
data[].landing_page_url	string	Landing page URL
data[].landing_page_screenshot_url	string	Landing page screenshot URL
data[].active_ad_count	integer	Active ad count
data[].ad_count	integer	Ad count
data[].ad_days	integer	Delivery days
data[].recent_ad_date	integer	Recent ad date (timestamp in seconds)
data[].first_ad_date	integer	First ad date (timestamp in seconds)

Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "per_page": 10,
    "total": 2,
    "data": [
      {
        "ad_count": 131,
        "recent_ad_date": 1757228400,
        "first_ad_date": 1753340400,
        "landing_page_id": "ee75647be0cb2c43437198e9396bef47",
        "ad_days": 46,
        "landing_page_url": "https://atoleajewelry.com/collections/waterproof-jewelry/products/initial-birthstone-charm-necklace",
        "active_ad_count": 131
      },
      {
        "ad_count": 11,
        "recent_ad_date": 1748761200,
        "first_ad_date": 1748761200,
        "landing_page_id": "97e93983753e8d6123b3740eef87b898",
        "ad_days": 1,
        "landing_page_url": "https://atoleajewelry.com/collections/summer-collection",
        "active_ad_count": 11
      }
    ],
    "last_page": 1,
    "current_page": 1
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "success": true,
  "fail": false
}

Error Codes

Error Code	Description
200	Success
400	Invalid request parameters
500	Internal server error