Pipispy API中文

Monitor Task Daily Overview

API Information

  • 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

Response Data Information Fields

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