> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/youtube/channels-search>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/youtube/channels-search.mdx>

---

# 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` 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`.

## Request

- **Endpoint:** `GET /v1/youtube/channels/search`
- **Credits:** 1 credit
Failed requests are free
- **Input:** channel handle and query
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/youtube/channels/search/get)
- **Platform page:** [/platforms/youtube](https://www.socialfetch.dev/platforms/youtube)

## 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.