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 | Default |
|---|---|---|---|---|---|
| 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 active_ad_count(active ad count) ad_count(ad count) ad_days(delivery days) recent_ad_date(recent ad date) 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 |