# Monitor Task Ad Count Statistics

## API Information

- **API Name**: Monitor Task Ad Count Statistics
- **Request Method**: POST
- **API URL**: `open-api/v1/monitor/data`
- **Endpoint Path**: `/v3/api/ad-monitor-task/ad-count-statistics`
- **Description**:
    - Get ad count statistics information for monitor task
    - Support querying ad statistics by time range
    - Provide time series data of ad counts
    - 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/ad-count-statistics" | Yes      |         |
| params    | object | Request parameters object         | See parameter list                     | Yes      |         |

### Request Body Parameters (params object)

| Parameter   | Type    | Required | Description                                    |
|-------------|---------|----------|------------------------------------------------|
| task_id     | string  | true     | Monitor task ID                                 |
| date_start  | integer | false    | Start date (timestamp in seconds)               |
| date_end    | integer | false    | End date (timestamp in seconds)                 |

### 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/ad-count-statistics",
    "params": {
      "task_id": "68fa2e36789edb5700215e03",
      "date_start": 1760745600,
      "date_end": 1761177600
    }
  }'
```

## Response Parameters

### Response Structure

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

| Field Name                     | Type        | Description                         |
|--------------------------------|-------------|-------------------------------------|
| data                           | array [object] | Ad statistics data list          |
| data[].date                    | integer     | Date, timestamp, unit: seconds     |
| data[].ad_total_count          | integer     | Total ad count                      |
| data[].ad_active_count          | integer     | Active ad count                     |
| data[].ad_new_count            | integer     | New ad count                        |
| data[].landing_page_total_count| integer     | Total landing page count            |
| data[].landing_page_new_count   | integer     | New landing page count              |
| data[].ad_product_total_count  | integer     | Total ad product count              |
| data[].ad_product_new_count    | integer     | New ad product count                |

## Response Example

```json
{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      {
        "date": 1761177600,
        "ad_active_count": 7143,
        "landing_page_total_count": 1294,
        "ad_product_active_count": 0,
        "ad_product_new_count": 0,
        "landing_page_new_count": 0,
        "ad_new_count": 0,
        "ad_total_count": 14383,
        "ad_product_total_count": 0
      },
      {
        "date": 1761091200,
        "ad_active_count": 7143,
        "landing_page_total_count": 1294,
        "ad_product_active_count": 0,
        "ad_product_new_count": 0,
        "landing_page_new_count": 0,
        "ad_new_count": 0,
        "ad_total_count": 14383,
        "ad_product_total_count": 0
      },
      {
        "date": 1761004800,
        "ad_active_count": 7143,
        "landing_page_total_count": 1294,
        "ad_product_active_count": 0,
        "ad_product_new_count": 0,
        "landing_page_new_count": 0,
        "ad_new_count": 0,
        "ad_total_count": 14383,
        "ad_product_total_count": 0
      },
      {
        "date": 1760918400,
        "ad_active_count": 7143,
        "landing_page_total_count": 1294,
        "ad_product_active_count": 0,
        "ad_product_new_count": 0,
        "landing_page_new_count": 0,
        "ad_new_count": 0,
        "ad_total_count": 14383,
        "ad_product_total_count": 0
      },
      {
        "date": 1760832000,
        "ad_active_count": 7143,
        "landing_page_total_count": 1294,
        "ad_product_active_count": 0,
        "ad_product_new_count": 0,
        "landing_page_new_count": 0,
        "ad_new_count": 0,
        "ad_total_count": 14383,
        "ad_product_total_count": 0
      },
      {
        "date": 1760745600,
        "ad_active_count": 7143,
        "landing_page_total_count": 1294,
        "ad_product_active_count": 0,
        "ad_product_new_count": 0,
        "landing_page_new_count": 0,
        "ad_new_count": 0,
        "ad_total_count": 14383,
        "ad_product_total_count": 0
      }
    ]
  },
  "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 |
| 404        | Monitor task not found |
| 500        | Internal server error |