youtube/
search-channels

Use the YouTube Channel Search API to search YouTube channels by keyword and get channel IDs, names, subscriber counts, avatars, and the description snippet YouTube shows, in search order.

YouTube Channel Search API

Keyword input
Subscriber counts
Up to 200 channels
0.6 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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

ParametersRequiredDescription
queryRequiredThe keyword to find channels for, up to 100 characters.
results_limitOptionalHow 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.

  1. POST {"query": "home cooking", "results_limit": 20} to /v1/youtube/search-channels.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. 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.

Beyond the YouTube Channel Search API, use these APIs when you need a different type of public YouTube data.

Explore other platforms

Combine YouTube data with public data from other supported social platforms.

YouTube Channel Search API — FAQ

YouTube Channel Search API is a programmatic interface for finding YouTube channels that match a keyword. It returns channel IDs, names, subscriber counts, avatars and description snippets in YouTube's search order.

Set results_limit from 1 to 200; it defaults to 20. Results are paged automatically until the limit or the end of YouTube's results.

Search results identify channels by their UC channel ID and channel URL. Send that URL to YouTube Channels to get the handle and full profile.

No. Requests use your SocQ API key and are billed in credits per channel returned, so there is no Google Cloud project or daily quota to manage.

The YouTube Channel Search API charges 0.6 credits for each channel returned, so the default 20 channels cost 12 credits.