YouTube Channel Search
Channel search results are the creator accounts YouTube matches to a keyword, each listed with its name, avatar, subscriber count and the opening lines of its description. Scanning them is the quickest way to size up who covers a topic, separate large channels from rising ones and assemble a first list for creator research or outreach.
YouTube Channel Search API Features
- Channels onlyThe search is restricted to channels, so a keyword like home cooking returns creator accounts instead of a mix of videos and playlists.
- Subscriber count per channelmetrics.followers_count holds the subscriber total parsed from YouTube's display, such as 3.69M.
- Stable channel IDs and linksEach result carries the UC channel ID and a channel URL built from it, ready for channel-level APIs.
- Description snippettext holds the description excerpt shown in search, which often names the niche or includes a business contact.
YouTube Channel Search API Parameters
| Parameters | Required | Description |
|---|---|---|
query | Required | The keyword to find channels for, up to 100 characters. |
results_limit | Optional | How many channels to return, from 1 to 200. Defaults to 20. |
How to Use the YouTube Channel Search API
Give the YouTube Channel Search API a keyword and page through the matching channels.
- POST {"query": "home cooking", "results_limit": 20} to /v1/youtube/search-channels.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- Read the channels from results.items and pass results.next_cursor back while has_more is true.
curl -X POST "https://api.socq.ai/v1/youtube/search-channels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"home cooking","results_limit":20}'
# Each item is one channel with name, text and metrics.followers_count.YouTube Channel Search API Use Cases
- Building a creator shortlist: Search the keywords of your niche and keep channels whose followers_count falls in the size range you work with.
- Seeing who owns a topic: Compare the subscriber counts of the top results for a keyword to judge whether a few large channels dominate it.
- Seeding channel research: Feed the returned channel URLs into YouTube Channels and YouTube Channel Videos to profile each creator in depth.
YouTube Channel Search API Pro Tips
- Subscriber counts come from rounded display text, so use YouTube Channels when you need the figure to the unit.
- Run several phrasings of a topic and merge the results by channel id to widen the list.
- Pass promising channels to YouTube Email Finder to see whether they publish a business contact.
Related APIs
Beyond the YouTube Channel Search API, use these APIs when you need a different type of public YouTube data.
- YouTube Channel Videos API — Collect regular public videos from channel URLs, excluding Shorts and live streams.
- YouTube Channels API — Retrieve public channel identity, images, verification, and visible audience statistics.
- YouTube Search API — Search public regular videos by keyword with supported metadata filters.
- YouTube Hashtag Search API — Find public videos from hashtag feeds with all-content or Shorts-only collection.
- YouTube Shorts Search API — Search Shorts by keyword, with links, captions, view counts, and vertical thumbnails.
- YouTube Email Finder API — Find public business emails for a channel URL, with the pages each address appears on.
- YouTube Comments API
- YouTube Transcripts API
- YouTube Videos API
- YouTube Shorts API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Search Suggestions API
- YouTube Trending Videos API