Skip to content
DataXAPI
All YouTube APIs
Posts & videosYouTubeChannel · Profile

YouTube channel profile

Read a public YouTube channel's name, handle, description, subscriber count, and video count by channel ID.

POST/v1/youtube/channels/profile

Chinese name: YouTube 频道资料 · 频道 · 资料 按频道 ID 读取 YouTube 公开频道的名称、handle、简介、订阅数和视频数。
youtube.channels.profile@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"

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}$"
    }
  },
  "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/profile \
  -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_profile",
  "message": "success",
  "data": {
    "item": {
      "channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw",
      "title": "Rick Astley",
      "handle": "RickAstleyYT",
      "subscriber_count": "4.2M subscribers",
      "video_count": "400 videos",
      "verified": true
    }
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [],
  "meta": {
    "listing_id": "youtube.channels.profile",
    "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": {
        "item": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "channel_id": {},
                "title": {},
                "handle": {},
                "description": {},
                "subscriber_count": {},
                "video_count": {},
                "keywords": {},
                "channel_url": {},
                "vanity_url": {},
                "is_family_safe": {},
                "verified": {}
              },
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "item"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "type": "null"
        }
      },
      "required": [
        "next_cursor"
      ],
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "const": "youtube.channels.profile"
        },
        "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 when you have a channel ID starting with UC and need its public profile and scale.

Not for

  • Do not use it for channel revenue, audience demographics, or private data.

Known limitations

  • Subscriber and video counts are the display text the platform shows.
  • Join date, country, and total views are not returned here.
  • 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 →