Channel Data API Reference

The GET /api/channel/{identifier} endpoint returns channel metadata as JSON. No authentication required.

Endpoint

GET https://banner.yt/api/channel/{identifier}

Parameters

Parameter	Type	Default	Values
identifier	path	required	Channel ID (UCxxxx), username, or @handle
type	query	id	id, username, handle

Looking up by channel ID

GET /api/channel/UCX6OQ3DkcsbYNE6H8uQQuVA

Looking up by username

GET /api/channel/mrbeast?type=username

Looking up by @handle

GET /api/channel/mrbeast?type=handle

Example response

{
  "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
  "title": "MrBeast",
  "description": "SUBSCRIBE FOR A COOKIE",
  "customUrl": "@MrBeast",
  "publishedAt": "2012-02-19T23:29:16Z",
  "country": "US",
  "subscriberCount": "340000000",
  "viewCount": "60000000000",
  "videoCount": "800",
  "bannerUrl": "https://banner.yt/api/banner/UCX6OQ3DkcsbYNE6H8uQQuVA",
  "avatarUrl": "https://banner.yt/api/banner/UCX6OQ3DkcsbYNE6H8uQQuVA?type=avatar",
  "bannerUrls": {
    "default": "https://banner.yt/api/banner/UCX6OQ3DkcsbYNE6H8uQQuVA",
    "tv": "https://banner.yt/api/banner/UCX6OQ3DkcsbYNE6H8uQQuVA?type=tv",
    "desktop": "https://banner.yt/api/banner/UCX6OQ3DkcsbYNE6H8uQQuVA?type=desktop",
    "tablet": "https://banner.yt/api/banner/UCX6OQ3DkcsbYNE6H8uQQuVA?type=tablet",
    "mobile": "https://banner.yt/api/banner/UCX6OQ3DkcsbYNE6H8uQQuVA?type=mobile",
    "avatar": "https://banner.yt/api/banner/UCX6OQ3DkcsbYNE6H8uQQuVA?type=avatar"
  },
  "links": [
    { "title": "Instagram", "url": "https://instagram.com/mrbeast" }
  ]
}

Error responses

Status	Meaning
200	Success
400	Missing or invalid identifier
404	Channel not found
429	Rate limit hit (10 req/30s)
500	Internal error

Caching

Channel data is cached for 1 hour (3600 seconds) on the server. The response includes Cache-Control: public, max-age=3600.

Rate limits

10 requests per 30 seconds per IP. If you exceed this you get a 429 response. For higher limits, reach out to us at [email protected].