YouTube hub

YouTube Channel Search API

YouTube's own in-channel search: find a channel's videos, Shorts, streams and playlists that match a keyword.

GET /v1/youtube/channels/search

1 credit Failed requests are free

About this endpoint

GET /v1/youtube/channels/search takes a channel handle and a query, and returns what YouTube's search box on that channel returns: data.videos, data.shorts, data.liveStreams and data.playlists, each row with id, url, title, thumbnail, views, publish time, duration and badges. Pass data.page.nextCursor as cursor while data.page.hasMore is true.

There are no sort or date filters: results come in YouTube's order. For all of YouTube, use GET /v1/youtube/search. For a channel's full upload list, use GET /v1/youtube/channels/videos.

YouTube Channel Search API FAQ

How do I search inside a YouTube channel via API?

Call GET /v1/youtube/channels/search with your Social Fetch API key (x-api-key), the channel handle and a query. Read data.videos, data.shorts, data.liveStreams and data.playlists, then page with data.page.nextCursor.

How much does the YouTube Channel Search API cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Can I search by channel id instead of handle?

No, this route takes the handle (with or without @). To find a channel's handle from its id, call GET /v1/youtube/channel.

Can I sort or filter the results by date?

No. Results come in the order YouTube's in-channel search returns them. To list a channel's newest uploads, use GET /v1/youtube/channels/videos with sortBy=latest.