Monitor Task Ad Count Statistics
- 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
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
{
"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
{
"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 |