Data usage rules: 1. Obtaining a data result consumes 1 data. Obtaining more detailed information about a data result does not consume data. 2. Ad Tracker: Each monitoring session costs $1/month. Each monitoring session is valid for one month and automatically expires after one month. Deleting a monitoring session does not restore the monitoring session, so please delete with caution. Monitoring sessions can be accessed at any time and are unlimited.
Monitor Task Daily Overview
- API Name: Monitor Task Daily Overview
- Request Method: POST
- API URL:
open-api/v1/monitor/data
- Endpoint Path:
/v3/api/ad-monitor-task/ad-daily-overview
- Description:
- Get monitor task ad data overview for specified date
- Provide daily ad statistics and analysis data
- Support querying detailed data of monitor task by date
- 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-daily-overview" |
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 |
| date |
integer |
true |
Query 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-daily-overview",
"params": {
"task_id": "68fa2e36789edb5700215e03",
"date": 1761264000
}
}'
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 |
| Field Name |
Type |
Description |
| date |
integer |
Date, timestamp in seconds |
| ad_total_count |
integer |
Total ad count |
| ad_active_count |
integer |
Active ad count |
| ad_new_count |
integer |
New ad count |
| landing_page_total_count |
integer |
Total landing page count |
| landing_page_new_count |
integer |
New landing page count |
| ad_product_total_count |
integer |
Total ad product count |
| ad_product_new_count |
integer |
New ad product count |
Response Example
{
"code": 200,
"message": "success",
"data": {
"date": 1761264000,
"ad_active_count": 7143,
"landing_page_total_count": 1294,
"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 |
| 500 |
Internal server error |