Channel Endpoints

Resolve handles, search inside a channel, list every upload, and track new ones.

The Channel endpoints expose four operations against a single channel: resolve a @handle or URL to a canonical UC… ID, search videos within that channel, paginate through every upload (~100 per page), and pull the latest 15 uploads via RSS. Authenticate with Authorization: Bearer YOUR_API_KEY. Resolve and latest are free but require ≥1 active credit; search and videos charge 1 credit per successful call. 4xx, 5xx, and 429 responses never debit. The videos endpoint returns a continuation_token for the next page.

Resolve a channel

GET/api/v2/youtube/channel/resolveFree

Convert any @handle, full channel URL, or UC… ID to its canonical channel ID. Free endpoint — costs 0 credits but requires ≥1 active credit on your account.

Parameter	Type	Default	Description
inputreq	string	—	@handle, channel URL, or UC… ID. 1–200 chars.

bash

curl -X GET "https://youtubetranscriptapi.com/api/v2/youtube/channel/resolve?input=@TED" \
  -H "Authorization: Bearer YOUR_API_KEY"

json

{
  "channel_id": "UCAuUUnT6oDeKwE6v1NGQxug",
  "resolved_from": "@TED"
}

Search videos inside a channel

GET/api/v2/youtube/channel/search1 credit

Parameter	Type	Default	Description
channelreq	string	—	@handle, URL, or UC… ID.
qreq	string	—	Search query, 1–200 chars.
limit	integer	30	Max results (1–50).

bash

curl -X GET "https://youtubetranscriptapi.com/api/v2/youtube/channel/search?channel=@TED&q=review&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

List channel uploads

GET/api/v2/youtube/channel/videos1 credit / page

Paginated list of every upload (~100 per page). Provide channel on the first request, then pass continuation from the previous response for subsequent pages.

Parameter	Type	Default	Description
channel	string	—	@handle, URL, or UC… ID. Required for first page.
continuation	string	—	Token from a previous response. Required for next pages.

json

{
  "results": [
    {
      "videoId": "abc123xyz00",
      "title": "Latest Video",
      "channelId": "UCAuUUnT6oDeKwE6v1NGQxug",
      "channelTitle": "TED",
      "channelHandle": "@TED",
      "lengthText": "15:22",
      "viewCountText": "3.2M views 2 weeks ago",
      "thumbnails": [],
      "index": "0"
    }
  ],
  "playlist_info": {
    "title": "Uploads from TED",
    "numVideos": "5200",
    "ownerName": "TED",
    "viewCount": null
  },
  "continuation_token": "4qmFsgKlARIYVVV1QVhGa2dz...",
  "has_more": true
}

Track new uploads

GET/api/v2/youtube/channel/latestFree

RSS-backed list of the latest 15 uploads. Free endpoint, ideal for daily-recap or new-content alert pipelines.

Parameter	Type	Default	Description
channelreq	string	—	@handle, URL, or UC… ID.

bash

curl -X GET "https://youtubetranscriptapi.com/api/v2/youtube/channel/latest?channel=@TED" \
  -H "Authorization: Bearer YOUR_API_KEY"