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

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

```json
{
  "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

```json
{
  "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 |