ChannelCrawler API
Guides

Programmatic YouTube Advertising

How to run targeted ads programmatically on YouTube

Goal:

Find high-quality YouTube channels that match your targeting criteria, so you can run programmatic ads without relying on vague keyword matches or overpriced agency whitelists.

Problems you're solving

Running YouTube ads via keyword targeting, auto-placement often or through agencies, often leads to:

  • Ads showing on kids channels (low intent, no conversions)
  • VPN-spoofed locations, leading to incorrect country targeting
  • Russian-language or off-topic channels, even if your keyword matches
  • Lack of control - YouTube decides, you just pay
  • Agencies charging 10–50% markups for whitelists you could build yourself
  • No way to find channels who’ve talked about your topic recently

Using ChannelCrawler API to Build a Targeted Channel List

You’ll use the /v1/channels/search discovery pathway to filter by:

  • Country & language (for broad targeting)
  • Category & keyword (for topic-relevance)
  • View thresholds (to match your scale & budget)

Example A — Broad targeting by language & location

curl -X POST \
  -H "Authorization: Bearer $CC_API_KEY" \
  -H "Content-Type: application/json" \
  https://api.channelcrawler.com/v1/channels/search \
  -d '{
    "language": ["English", "Spanish", "Dutch", "French"],
    "country": ["United Kingdom", "United States", "Spain", "France", "Netherlands"]
  }'

This returns a list of creators speaking your preferred languages and based in the right locations — ideal for running ads at scale.


Example B — Target a specific interest category (e.g., Yoga & Pilates)

curl -X POST \
  -H "Authorization: Bearer $CC_API_KEY" \
  -H "Content-Type: application/json" \
  https://api.channelcrawler.com/v1/channels/search \
  -d '{
    "ai_subcategory": ["Yoga, Pilates & Barre", "Nutrition & Supplements"],
    "language": ["English"],
    "country": ["United Kingdom", "United States"]
  }'

This finds creators specifically covering Yoga & Pilates, or Nutrition & Supplements speaking English in the US & UK — useful if you’re running ads in a targeted vertical.


📝 Note

You can either:

  • Combine countries/languages for broader targeting
  • Or split them into separate campaigns (e.g., "Spanish" + "Spain")

Both work — it depends how granular you want your targeting to be, and how you manage your campaigns.

Using ChannelCrawler to Look for Mentions of a Certain Topic

Sometimes, you’re not just looking for channels in a general niche, you’re looking for those that have actually mentioned a specific topic.

That might mean finding channels who’ve mentioned housing if you’re running political ads, or weights if your product is designed for weightlifters.

In short: you’re trying to reach a hyper-specific audience of channels who’ve already covered your subject in their recent videos, so your ads have more impact.


Example A — Search against known channels

If you already have a list of channels (via an import or direct URLs), you can check which of them have talked about your chosen topic recently.

Example: Housing topic across imported channels

curl -X POST \
  -H "Authorization: Bearer $CC_API_KEY" \
  -H "Content-Type: application/json" \
  https://api.channelcrawler.com/v1/channels/search \
  -d '{
    "import_id": "imp_2a7x9df",
    "q": ["housing"]
  }'

You can also search by channel URLs directly

This checks each selected channel’s recent videos and returns any that have mentioned “housing” — whether in the video title, description, or tags, or within the channel’s title, bio, or tags.


Example B — Broader discovery

If you don’t already have channels, you can discover new ones that have mentioned your topic in recent videos — filtered by country, category, or other parameters.

Example: Discover weightlifting channels

curl -X POST \
  -H "Authorization: Bearer $CC_API_KEY" \
  -H "Content-Type: application/json" \
  https://api.channelcrawler.com/v1/channels/search \
  -d '{
    "q": ["weights", "weightlifting"],
    "country": ["United States"],
    "ai_category": ["Fitness"]
  }'

This returns YouTube channels that have talked about weightlifting in recent uploads, within the Fitness category and based in the US, ideal for reaching the right creators when your product fits that exact niche.