Get YouTube Channel Profile, Subscriber Count & Social Links

GET/v1/youtube/channel

Resolves a YouTube channel by @handle, UC... channel ID, or full URL and returns subscriber count, total lifetime views, video count, verification status, country, keywords, and external links. Cost: 10 Credits ($0.001) per call.

Query Parameters

handlestring
YouTube channel handle (e.g. @MrBeast, mrbeast, or @googledevelopers). Provide either handle, channel_id, or url.
channel_idstring
YouTube channel ID starting with UC (e.g. UCX6OQ3DkcsbYNE6H8uQQuVA).

Example Request (cURL / Python / JavaScript)

curl "https://api.youtubeapi.io/v1/youtube/channel" \
  -H "x-api-key: yt_live_your_api_key"

Live Response Preview

{
  "code": 0,
  "provider": "https://youtubeapi.io",
  "status": "ok",
  "msg": "success",
  "data": {
    "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
    "handle": "mrbeast",
    "title": "MrBeast",
    "description": "SUBSCRIBE FOR A COOKIE!",
    "subscriberCount": 345000000,
    "subscriberText": "345M subscribers",
    "videosCount": 842,
    "viewCount": 68500000000,
    "country": "US",
    "joinedDate": "Feb 19, 2012",
    "avatarUrl": "https://yt3.googleusercontent.com/fxGKYucJAVme-Yz4fsdCroCFCrANWqw0ql4GYuvx8Uq4l_euNJHgE-w9MTkLQA805vWCi-kE0g=s176-c-k-c0x00ffffff-no-rj",
    "bannerUrl": null,
    "isVerified": true,
    "keywords": [
      "mrbeast",
      "challenge",
      "philanthropy"
    ],
    "links": [
      {
        "title": "Shop MrBeast",
        "url": "https://mrbeast.store"
      }
    ],
    "url": "https://www.youtube.com/@mrbeast"
  },
  "meta": {
    "request_id": "4d5e6f70-4444-5555-6666-777788889999",
    "endpoint": "/v1/youtube/channel",
    "cached": true,
    "source": "pg",
    "items_count": 1,
    "credits_charged": 10,
    "latency_ms": 5
  }
}

Response Fields

Successful channel profile response

Field	Type	Sample / Notes
`code`	integer
`provider`	string
`status`	string
`msg`	string
`data`	ChannelData
`channelId`	string	YouTube channel ID (`UC...`).
`handle`	stringnull	Lowercase channel handle without `@`.
`title`	string	Channel title.
`description`	string	Full channel about description.
`subscriberCount`	integer	Parsed integer subscriber count.
`subscriberText`	string	Formatted subscriber count string (e.g. `345M subscribers`).
`videosCount`	integer	Total public videos count.
`viewCount`	integer	Total channel lifetime views.
`country`	stringnull	Channel country code.
`joinedDate`	stringnull	Channel creation date.
`avatarUrl`	stringnull	Channel avatar image URL.
`bannerUrl`	stringnull	Channel banner image URL.
`isVerified`	boolean	Whether the channel has a verification badge.
`keywords`	array of string
`links`	array of object
`title`	string
`url`	string
`url`	string	Canonical YouTube channel URL.
`meta`	ResponseMeta
`request_id`	string	Unique UUID for tracing and support.
`endpoint`	string	Canonical endpoint path.
`cached`	boolean	True if served from L1 Redis or L2 PostgreSQL 16 asset sink.
`source`	string	Data source tier (`redis`, `pg`, `upstream_primary`, `upstream_fallback`, `oembed`).
`items_count`	integer	Number of records returned in `data`.
`credits_charged`	integer	Credits deducted for this request ($1 = 10,000 Credits).
`has_more`	boolean	Whether additional pages are available via `next_cursor`.
`next_cursor`	stringnull	Continuation cursor for the next page.
`latency_ms`	integer	End-to-end gateway latency in milliseconds.

Status Codes

200: Successful channel profile response