YouTube Channel Description

Name: YouTube Channel Description
Price: 0.0015 USD
Availability: InStock
Author: YouTube

https://api.sandbase.ai/v1/api/youtube/web-v2/channel-description

Returns YouTube channel details including subscriber counts, video totals, view counts, joined date, and social links. Filter by country and language.

Try this API Get API key

Price: $0.0015USD / callFirst 100 calls per day free (shared per organization)
Method: POST
Response: JSON
Parameters: 0 required · 5 optional

Production route

Try the model

Playground

Open playground

Input

Channel Id(string)

**Purpose**: Channel ID for first request to get basic channel info

Continuation Token(string)

**Purpose**: Pagination token for second request to get advanced info

Country Code(string)

**Purpose**: Set region code

Language Code(string)

**Purpose**: Set language preference

Need Format(boolean)

**Purpose**: Whether to return cleaned simplified data

OutputExample

Responseoutputs · 4.3 KB · 79 lines

[
  {
    "data": {
      "avatar": [
        {
          "height": 900,
          "url": "https://yt3.googleusercontent.com/jwfgqnpI22YpsFDz25QtgITBf5tX7mFHqXWVhHoWzbk3ddAz9FabBDIx-eFaLrXlrhcpo5G0qBI=s900-c-k-c0x00ffffff-no-rj",
          "width": 900
        },
        {
          "height": 72,
          "url": "https://yt3.googleusercontent.com/jwfgqnpI22YpsFDz25QtgITBf5tX7mFHqXWVhHoWzbk3ddAz9FabBDIx-eFaLrXlrhcpo5G0qBI=s72-c-k-c0x00ffffff-no-rj",
          "width": 72
        },
        {
          "height": 120,
          "url": "https://yt3.googleusercontent.com/jwfgqnpI22YpsFDz25QtgITBf5tX7mFHqXWVhHoWzbk3ddAz9FabBDIx-eFaLrXlrhcpo5G0qBI=s120-c-k-c0x00ffffff-no-rj",
          "width": 120
        },
        {
          "height": 160,
          "url": "https://yt3.googleusercontent.com/jwfgqnpI22YpsFDz25QtgITBf5tX7mFHqXWVhHoWzbk3ddAz9FabBDIx-eFaLrXlrhcpo5G0qBI=s160-c-k-c0x00ffffff-no-rj",
          "width": 160
        }
      ],
      "banner": [
        {
          "height": 175,
          "url": "https://yt3.googleusercontent.com/g9zR1vL-i8QnAWLs08CHvjci79h2AXAps29dGIOLyB9T7ZWESgTzNFzfhCvc8T9p1H7fWWeKCw=w1060-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
          "width": 1060
        },
        {
          "height": 188,
          "url": "https://yt3.googleusercontent.com/g9zR1vL-i8QnAWLs08CHvjci79h2AXAps29dGIOLyB9T7ZWESgTzNFzfhCvc8T9p1H7fWWeKCw=w1138-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
          "width": 1138
        },
        {
          "height": 283,
          "url": "https://yt3.googleusercontent.com/g9zR1vL-i8QnAWLs08CHvjci79h2AXAps29dGIOLyB9T7ZWESgTzNFzfhCvc8T9p1H7fWWeKCw=w1707-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
          "width": 1707
        },
        {
          "height": 351,
          "url": "https://yt3.googleusercontent.com/g9zR1vL-i8QnAWLs08CHvjci79h2AXAps29dGIOLyB9T7ZWESgTzNFzfhCvc8T9p1H7fWWeKCw=w2120-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
          "width": 2120
        },
        {
          "height": 377,
          "url": "https://yt3.googleusercontent.com/g9zR1vL-i8QnAWLs08CHvjci79h2AXAps29dGIOLyB9T7ZWESgTzNFzfhCvc8T9p1H7fWWeKCw=w2276-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
          "width": 2276
        },
        {
          "height": 424,
          "url": "https://yt3.googleusercontent.com/g9zR1vL-i8QnAWLs08CHvjci79h2AXAps29dGIOLyB9T7ZWESgTzNFzfhCvc8T9p1H7fWWeKCw=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
          "width": 2560
        }
      ],
      "channel_id": "UCeu6U67OzJhV1KwBansH3Dg",
      "channel_url": "https://www.youtube.com/channel/UCeu6U67OzJhV1KwBansH3Dg",
      "continuation_token": "4qmFsgJgEhhVQ2V1NlU2N096SmhWMUt3QmFuc0gzRGcaRDhnWXJHaW1hQVNZS0pEY3dNekZsTnpoakxUQXdNREF0TW1RNE1pMWlORGhsTFRFME1qSXpZbUl5TWpneU5nJTNEJTNE",
      "country": null,
      "creation_date": null,
      "description": "Minecraft ambience and cozy visuals for sleep, relaxing, studying, etc 🌿\n\nHi, I’m glad you’re here! I create peaceful Minecraft ambience to help you slow down, breathe, and feel at home. From cozy cabins in the forest to rainy lakeside docks, cherry blossom villages, and underwater reefs, I build and explore with the goal of bringing you comfort.\n\nIf you love cozy Minecraft builds, gentle rain, crackling fireplaces, and relaxing soundscapes, you’ll feel right at home here.\nHope you enjoy! -Cozy",
      "handle": "CozyCraftYT",
      "has_business_email": false,
      "has_membership": true,
      "is_family_safe": true,
      "keywords": "Minecraft Ambience Rain Thunderstorm \"Relaxing Music\" C418 ASMR Sleep Study Relax Thunder 1.21.8 CozyCraft \"minecraft music\" \"minecraft longplay\" \"heavy rain\" \"sleep sounds\" \"white noise\" \"minecraft ambiance\" \"minecraft update\" ambient background \"minecraft soundtrack\" \"minecraft playlist\" \"8 hours\" \"white noise\" peaceful campfire \"minecraft build\" \"minecraft shaders\" \"music for studying\" \"study mix\" \"lena raine\" \"cozy house build\" \"minecraft sounds\" \"minecraft mods\" \"sleep music\" nostalgia cozy",
      "links": [],
      "rss_url": "https://www.youtube.com/feeds/videos.xml?channel_id=UCeu6U67OzJhV1KwBansH3Dg",
      "subscriber_count": "12万位订阅者",
      "title": "CozyCraft",
      "vanity_url": "http://www.youtube.com/@CozyCraftYT",
      "verified": false,
      "video_count": "222 个视频",
      "view_count": null
    }
  }
]

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price: $0.0015 / run
Daily free calls: First 100 calls per day free (shared per organization)

Request & response

Method: POST
Request body: application/json
Response: application/json
Execution: sync

Parameters

channel_id: string · optional
continuation_token: string · optional
country_code: string · optional
language_code: string · optional
need_format: boolean · optional

Access

Provider: YouTube
API: Platform API
Base URL: https://api.sandbase.ai
Endpoint: /v1/api/youtube/web-v2/channel-description
Authentication: Bearer API key

API README

YouTube Channel Description API

Look up metadata and profile details for a YouTube channel using channel_id. Supports regional localization and pagination via continuation_token.

Use cases

Retrieve channel statistics such as view counts and subscriber metrics.
Extract social links and about-page text from channel profiles.
Review channel join dates and metadata localized by region or language.

Request

curl -X POST "https://api.sandbase.ai/v1/api/youtube/web-v2/channel-description" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Parameters

Name	Type	Required	Description
`channel_id`	string	No	Purpose: Channel ID for first request to get basic channel info
`need_format`	boolean	No	Purpose: Whether to return cleaned simplified data
`country_code`	string	No	Purpose: Set region code
`language_code`	string	No	Purpose: Set language preference
`continuation_token`	string	No	Purpose: Pagination token for second request to get advanced info

Notes

Set need_format to true to receive cleaned, simplified channel data.
Supply continuation_token on follow-up calls to fetch advanced information.

Related APIs

YouTube Channel Community Posts: Returns community posts from a specific YouTube channel, including text content, polls, votes, and comment counts.
YouTube Channel ID from URL: Resolves a YouTube channel URL to its canonical channel ID.
YouTube Channel Shorts: Returns a list of YouTube Shorts from a specified channel.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

https://api.sandbase.ai/v1/api/youtube/web-v2/channel-description

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/youtube/web-v2/channel-description" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "channel_id": "UCeu6U67OzJhV1KwBansH3Dg",
  "need_format": true,
  "country_code": "US",
  "language_code": "zh-CN"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
YouTube Channel DescriptionThis API `YouTube`	$0.0015 per call	JSON	Jul 31, 2026
YouTube Channel Community Posts `YouTube`	$0.0015 per call	JSON	Jul 31, 2026
YouTube Channel ID from URL `YouTube`	$0.0015 per call	JSON	Jul 31, 2026
YouTube Channel Shorts `YouTube`	$0.0015 per call	JSON	Jul 31, 2026
YouTube Channel URL by ID `YouTube`	$0.0015 per call	JSON	Jul 31, 2026
YouTube Channel Videos `YouTube`	$0.0015 per call	JSON	Jul 31, 2026

Questions

FAQ

How do I use the YouTube Channel Description API?

Send a POST request to https://api.sandbase.ai/v1/api/youtube/web-v2/channel-description with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the YouTube Channel Description API cost?

$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the YouTube Channel Description API accept?

No parameters are required. Optional: channel_id (string), continuation_token (string), country_code (string), language_code (string) and need_format (boolean). The Parameters table and the Playground on this page list every field.

What does the YouTube Channel Description API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a YouTube developer account or API key?

No. YouTube Channel Description runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for YouTube API access separately.