List Video Monitoring Tasks

Returns the monitoring tasks owned by your account, newest first, so you can audit what is being tracked and pick task ids for the detail, refresh and stop endpoints.

GET/api/v1/monitor/video/tasks/list

Quota usage: Each successful request to this endpoint deducts 1500 quota units from your plan.

Request Parameters

Required Parameters

This endpoint has no required parameters.

Optional Parameters

Name	In	Type	Description
`platform`	query	string	Platform filter: tiktok, youtube, instagram
`monitor_status`	query	string	Status filter: 0 = monitoring, 10 = completed, 20 = stopped
`page`	query	integer	Page number
`page_size`	query	integer	Items per page

Response Fields

Name	Type	Description
`success`	boolean	Success
`code`	integer	Code
`message`	string	Message
`data`	object	-
`data.items`	array<object>	Items
`data.total`	integer	Total
`data.page`	integer	Page
`data.page_size`	integer	Page Size
`data.total_pages`	integer	Total Pages

Try It

Request URL

https://openapi.scdata.cc/api/v1/monitor/video/tasks/list

Authorization

Select an API key from Dashboard

Add an API key before sending a request.Go to Dashboard

Query Params

platform

monitor_status

page

page_size

cURL Example

bash

curl -X GET "https://openapi.scdata.cc/api/v1/monitor/video/tasks/list" \
  -H "Authorization: YOUR_API_KEY"

Response Example (200 application/json)

json

{
  "success": true,
  "code": 200,
  "message": "Request successful",
  "data": {
    "items": [
      {
        "monitor_id": "string",
        "platform": "string",
        "video_id": "string",
        "video_title": "string",
        "video_description": "string",
        "video_publish_at": "2019-08-24T14:15:22.123Z",
        "video_url": "string",
        "video_cover": "string",
        "video_type": "string",
        "author_id": "string",
        "author_name": "string",
        "monitor_status": 0,
        "monitor_start_date": "2019-08-24",
        "monitor_end_date": "2019-08-24",
        "last_snapshot_time": "2019-08-24T14:15:22.123Z",
        "snapshot_count": 0,
        "created_time": "2019-08-24T14:15:22.123Z"
      }
    ],
    "total": 0,
    "page": 0,
    "page_size": 0,
    "total_pages": 0
  }
}

Use Cases

Task housekeeping — Find long-running tasks that are no longer needed and stop them to save quota.
Dashboard listing — Populate an internal dashboard with every video currently under monitoring.