Skip to content
All YouTube APIs
Accounts & creatorsYouTubeCreator Video · List

YouTube channel videos

Page through the long-form videos a YouTube channel publishes, with view-count text.

POST/v1/youtube/channels/videos

Chinese name: YouTube 频道视频 · 达人作品 · 列表 按频道 ID 分页读取 YouTube 频道发布的长视频和播放量文本。
youtube.channels.videos@v1

Price per call

¥0.02/ call

Nonempty complete results are charged; empty, partial, and failed results are not.

Current statusAvailableChecking live status
Checking live status

Try it

Sign in and run one real call. The result and charge appear right here.

Security check

Loading the security check…

Checking live execution status…

Execution result

// Result

Request parameters

channel_idstringrequired

pattern: "^UC[A-Za-z0-9_-]{22}$" · minLength: 1 · maxLength: 256

Example: "UCuAXFkgsw1L7xaCfnd5JJOw"

language_codestringoptional

enum: "en-US" | "zh-CN" | "ja-JP" | "ko-KR" · default: "en-US"

cursorstringoptional

minLength: 1

Request JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "channel_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^UC[A-Za-z0-9_-]{22}$"
    },
    "language_code": {
      "default": "en-US",
      "type": "string",
      "enum": [
        "en-US",
        "zh-CN",
        "ja-JP",
        "ko-KR"
      ]
    },
    "cursor": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "channel_id"
  ],
  "additionalProperties": false
}

Code samples

Install the SDK with npm i @dataxapi/sdk or pip install dataxapi, and put your API key in the DATAXAPI_API_KEY environment variable.

curl -X POST https://api.dataxapi.com/v1/youtube/channels/videos \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"channel_id":"UCuAXFkgsw1L7xaCfnd5JJOw"}'

Response example

200 · application/json
{
  "code": 200,
  "request_id": "req_example_youtube_channels_videos",
  "message": "success",
  "data": {
    "items": [
      {
        "video_id": "dQw4w9WgXcQ",
        "title": "Rick Astley - Never Gonna Give You Up (Official Video)",
        "duration": "3:33",
        "view_count": "1,700,000,000 views",
        "published_time": "16 years ago",
        "is_live": false,
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
      }
    ]
  },
  "page": {
    "next_cursor": "cursor_example"
  },
  "warnings": [],
  "meta": {
    "listing_id": "youtube.channels.videos",
    "version": "v1",
    "catalog_release_id": "catalog-production-2026-09-19.b069be57",
    "price_book_version": "pricebook-production-2026-09-19.4487e352",
    "result_status": "complete",
    "charged_amount": "0.02",
    "balance_after": "49.98",
    "currency": "CNY"
  }
}
Response fields
codenumber
const: 200
request_idstring
messagestring
const: "success"
dataobject
pageobject
warningsarray
metaobject
Response JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "code": {
      "type": "number",
      "const": 200
    },
    "request_id": {
      "type": "string"
    },
    "message": {
      "type": "string",
      "const": "success"
    },
    "data": {
      "type": "object",
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "video_id": {},
              "title": {},
              "duration": {},
              "view_count": {},
              "short_view_count": {},
              "published_time": {},
              "description": {},
              "is_live": {},
              "url": {}
            },
            "additionalProperties": false
          }
        }
      },
      "required": [
        "items"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "next_cursor"
      ],
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "const": "youtube.channels.videos"
        },
        "version": {
          "type": "string",
          "const": "v1"
        },
        "catalog_release_id": {
          "type": "string",
          "minLength": 1
        },
        "price_book_version": {
          "type": "string",
          "minLength": 1
        },
        "result_status": {
          "type": "string",
          "enum": [
            "complete",
            "empty",
            "partial"
          ]
        },
        "charged_amount": {
          "type": "string"
        },
        "balance_after": {
          "type": "string"
        },
        "currency": {
          "type": "string",
          "const": "CNY"
        }
      },
      "required": [
        "listing_id",
        "version",
        "catalog_release_id",
        "price_book_version",
        "result_status",
        "charged_amount",
        "balance_after",
        "currency"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "code",
    "request_id",
    "message",
    "data",
    "page",
    "warnings",
    "meta"
  ],
  "additionalProperties": false
}

Usage notes

Good for

  • Use it to review a channel's public videos and publishing cadence.

Not for

  • Do not use it for Shorts, complete live-replay lists, or downloads.

Known limitations

  • View count, duration, and publish time are the platform's display text.
  • Stream URLs are not returned.
  • Only the returned DataXAPI cursor can continue the same query.
  • Counts are point-in-time public snapshots, not live or historical trends.

Billing

¥0.02 per call. Nonempty complete results are charged; empty, partial, and failed results are not.

See all pricing →