Docs / API reference

POST/v1/data/youtube/channel

YouTube Channel

Get detailed channel metadata including subscriber count, video count, verification status, avatar, banner, country, and keywords. Accepts @handle or UC... channel ID.

Execution model

Live request

Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.

Credit weight

Live catalog

Current weights are managed from the Data API Weights admin table and shown on pricing before use.

Parameters

NameTypeRequirementDescription
identifierstringRequiredChannel ID (UC...), @handle, or username. 1-100 characters.
countrystringOptionalYouTube country/region code (maps to gl).
languagestringOptionalYouTube result language.

Request and response

curl -X POST "https://api.datablue.dev/v1/data/youtube/channel" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "identifier": "@mkbhd",
  "country": "us",
  "language": "en"
}'
Example response
{
  "success": true,
  "time_taken": 2.31,
  "channel": {
    "id": "UCBJycsmduvYEL83R_U4JriQ",
    "title": "MKBHD",
    "handle": "@mkbhd",
    "description": "Quality Tech Videos | Updated weekly.",
    "subscriber_count": 19800000,
    "subscriber_count_text": "19.8M subscribers",
    "subscriber_count_status": "rounded",
    "video_count": 1847,
    "video_count_text": "1.84K videos",
    "video_count_status": "rounded",
    "total_view_count": 4600000000,
    "total_view_count_text": "4,600,000,000 views",
    "total_view_count_status": "exact",
    "joined_date": "2008-03-21",
    "joined_date_text": "Joined Mar 21, 2008",
    "verified": true,
    "avatar_url": "https://yt3.googleusercontent.com/lkBjk_ZQ...",
    "banner_url": "https://yt3.googleusercontent.com/banner_ZQ...",
    "channel_url": "https://www.youtube.com/@mkbhd",
    "country": "US",
    "keywords": "tech reviews gadgets smartphones MKBHD Marques Brownlee",
    "rss_url": "https://www.youtube.com/feeds/videos.xml?channel_id=UCBJycsmduvYEL83R_U4JriQ",
    "is_family_safe": true,
    "external_links": [
      {
        "title": "MKBHD.com",
        "url": "https://mkbhd.com"
      }
    ],
    "about_complete": true,
    "about_stop_reason": "source_exhausted"
  }
}