Pipispy API中文

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

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