# YouTube Channel Search Scraper (`parseforge/youtube-channel-search-scraper`) Actor

Find YouTube channels by keyword: name, handle, channel ID, subscribers, verified badge, search rank, plus optional country, total views, links. Export CSV, Excel, JSON.

- **URL**: https://apify.com/parseforge/youtube-channel-search-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Videos, Social media, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.47 / 1,000 youtube channels

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

## 📺 YouTube Channel Search Scraper

> 🚀 **Export YouTube channels by keyword in seconds.** Type a topic, get every channel YouTube lists for it: name, handle, channel ID, subscribers, verified badge and search rank, plus 12 optional About page columns such as country, exact total views, video count, join date and external links.

YouTube Channel Search Scraper runs YouTube's own channel search (the "Type: Channel" filter on youtube.com) for each keyword you give it and returns one clean row per channel. It is built for discovery: you do not need to know any channel yet. Type "fitness coach", "crypto news" or "vegan recipes" and you get the creators who own that topic, ranked the way YouTube ranks them.

Every row has 14 search columns, and switching on About page details adds 12 more (26 in total). A single keyword returns up to a few hundred distinct channels (367 for "fitness" in our tests, deduplicated), and you can add as many keywords as you like. Subscriber and verified filters let you keep only the creators you would actually contact, and skipped channels are never billed.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| Influencer marketing agencies, brand partnership managers, media buyers, YouTube growth consultants, market researchers, data teams | Influencer discovery, creator shortlists by niche, competitor channel mapping, outreach lists, market sizing, channel datasets |

### 📋 What the YouTube Channel Search Scraper does

- 🔎 **Keyword to channels.** Each search term runs YouTube's channel search and pages through every result YouTube hands out.
- 👥 **Audience size on every row.** Subscriber count as a number (from the figure YouTube shows, for example 20.3K = 20,300) plus the original text.
- ✅ **Badges.** Verified and Official Artist Channel flags.
- 🥇 **Search rank.** Where the channel sits in YouTube's results for that keyword, so you can see who owns a topic.
- 🧹 **Filters.** Minimum subscribers, maximum subscribers (great for micro creators) and verified only. Channels you filter out are not billed.
- 📄 **About page details (optional).** Full description, exact lifetime views, video count, average views per video, country, join date, keywords, business email flag, family safe flag, RSS feed, banner and every external link (Instagram, TikTok, websites, booking pages).
- 🔁 **No duplicates.** YouTube repeats channels across result pages; each channel appears once per run.

> 💡 **Why it matters:** the hardest part of influencer marketing is finding the creators, not reading their stats. This Actor turns a list of keywords into a ranked, filterable list of channels you can sort by audience size and contact through their own links.

### 🎬 Full Demo (🚧 Coming soon)

### 📊 Output

The 12 search columns plus scrapedAt and error are on every row. The 12 About page columns appear when **Add About page details** is on. A hidden subscriber count reads `-1`, a missing handle reads `N/A` and values the channel does not publish read `Not Disclosed`. YouTube's own auto-generated channels (for example "Gaming") have no About page: their row keeps every search column and `error` says the About page was empty.

| Field | Description |
|---|---|
| 🖼 imageUrl | Channel avatar |
| 📺 channelName | Channel name |
| 🏷 handle | @handle, or N/A when the channel has none |
| 🆔 channelId | YouTube channel ID (UC...) |
| 🔗 channelUrl | Channel link |
| ✅ isVerified | Verified badge |
| 🎵 isArtist | Official Artist Channel |
| 👥 subscribers | Subscribers as a number, from YouTube's rounded figure |
| 👥 subscribersText | Subscribers exactly as YouTube shows them |
| 📝 description | Description snippet from the search result |
| 🔎 searchQuery | Keyword that found the channel |
| 🥇 searchRank | Position in YouTube's channel results for that keyword |
| 📄 fullDescription | Full About page description |
| 👁 totalViews | Exact lifetime views |
| 🎬 videoCount | Public videos |
| 📈 avgViewsPerVideo | Total views divided by videos |
| 🌍 country | Channel country |
| 📅 joinedDate | Channel creation date (YYYY-MM-DD) |
| 🔑 keywords | Channel keywords set by the creator |
| 📧 hasBusinessEmail | The channel lists a business email (YouTube shows it only to signed-in users) |
| 👪 isFamilySafe | YouTube family safe flag |
| 📡 rssUrl | RSS feed of the channel's uploads |
| 🖼 bannerUrl | Channel banner |
| 🔗 links | External links (title and URL) |
| 🕒 scrapedAt | Scrape time |
| ❌ error | null on success |

Real rows from a run with the search term "fitness coach" and About page details on:

```json
[
  {
    "imageUrl": "https://yt3.ggpht.com/SbDnKN2tucIOCoFpB5rDF-OZHnJBo_nRIVhoT7B5e2jx46sWFt9axpTnKxjThEFECI64YANfOQ=s176-c-k-c0x00ffffff-no-rj-mo",
    "channelName": "Jaquan Newsome - Fitness Coach",
    "handle": "@JaquanNewsomeChannel",
    "channelId": "UCU-77OvG_cVP7isv12etK2A",
    "channelUrl": "https://www.youtube.com/@JaquanNewsomeChannel",
    "isVerified": false,
    "isArtist": false,
    "subscribers": 20300,
    "subscribersText": "20.3K subscribers",
    "description": "I'm Jaquan Newsome, a Nutrition Scientist (M.S. Dietetics) and Kinesiologist. I specialize in helping successful, driven men go ...",
    "searchQuery": "fitness coach",
    "searchRank": 2,
    "fullDescription": "I’m Jaquan Newsome, a Nutrition Scientist (M.S. Dietetics) and Kinesiologist. I specialize in helping successful, driven men go from \"frustrated beginner\" to \"physically dominant\" without spending hours in the gym.\n\nYou’ve mastered your career, but the gym feels like a puzzle you can’t solve. You’re fed up with stubborn belly fat, low energy, and the feeling that you're \"getting old.\"\n\nMy Goal: Make Fitness Simple Again.\nI use my 11+ years of experience to strip away the fluff and give you a clear, science-backed path to results.\n\n🧪 Zero-Guesswork Nutrition: Lose the gut without restrictive dieting or complicated apps.\n⚡ The Beginner-to-Pro Blueprint: Master the right movements so you can walk into any gym with total confidence.\n🧠 The 45-Minute Protocol: High-efficiency routines designed for a high-stakes lifestyle.\n",
    "totalViews": 1815132,
    "videoCount": 455,
    "avgViewsPerVideo": 3989,
    "country": "United States",
    "joinedDate": "2016-03-20",
    "keywords": [
      "health and fitness",
      "fitness coach",
      "online fitness coaching",
      "quick workouts",
      "health and wellness",
      "befitnomenal",
      "jaquannewsome",
      "mens fitness",
      "personal trainer",
      "health",
      "mens fitness",
      "weight loss tips"
    ],
    "hasBusinessEmail": true,
    "isFamilySafe": true,
    "rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UCU-77OvG_cVP7isv12etK2A",
    "bannerUrl": "https://yt3.googleusercontent.com/y55T6Il4zF72VfyC2DonamiENgrvI4nIIgj65EV1WvGrHvtN-Zcev5ee4fO1928vHcK2V-mJ=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
    "links": [
      {
        "title": "Schedule a Call 📞",
        "url": "https://calendly.com/befitnomenal/befitnomenal-strategy-session-clone?fbclid=IwAR3D2fykHFC7fsLDAlCdQC_C3mhxaLKQ2z6jnhVTmOLZAUeAOvKH4PznfeY&month=2024-01"
      }
    ],
    "scrapedAt": "2026-09-25T16:09:33.117Z",
    "error": null
  },
  {
    "imageUrl": "https://yt3.ggpht.com/PxwYAxLukEhj0eHcurSxp2AvLFueUMj7Jb-OrPuMcVM1hfuV7eRKyCIt1ueaBGJ5DLcXB4L6CQ=s176-c-k-c0x00ffffff-no-rj-mo",
    "channelName": "Darren Liu, Fitness Coach",
    "handle": "@Darrenliufitness",
    "channelId": "UCxjuAliYDCJdPG8Ya61CbEA",
    "channelUrl": "https://www.youtube.com/@Darrenliufitness",
    "isVerified": false,
    "isArtist": false,
    "subscribers": 17100,
    "subscribersText": "17.1K subscribers",
    "description": "Fat loss for the last time with 1:1 online coaching Lose fat, build muscle, and achieve food freedom ☝️ #1 Body transformation ...",
    "searchQuery": "fitness coach",
    "searchRank": 3,
    "fullDescription": "📉 Fat loss for the last time with 1:1 online coaching\n🏆 Lose fat, build muscle, and achieve food freedom\n☝️ #1 Body transformation coach in Thailand\n\nDaily fat loss, nutrition, and training tips on IG 👇\nwww.instagram.com/darrenliufitness",
    "totalViews": 1231210,
    "videoCount": 259,
    "avgViewsPerVideo": 4754,
    "country": "Not Disclosed",
    "joinedDate": "2007-07-06",
    "keywords": [],
    "hasBusinessEmail": true,
    "isFamilySafe": true,
    "rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UCxjuAliYDCJdPG8Ya61CbEA",
    "bannerUrl": "https://yt3.googleusercontent.com/zzQ0Kk-KpOZmZFmhpCHGHQGiz8jBTI45jlGNGFQ4y7O4SdlKxknETogfq5Bjo_ffN6selMKSTjU=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
    "links": [
      {
        "title": "Instagram",
        "url": "www.instagram.com/darrenliufitness"
      },
      {
        "title": "Facebook",
        "url": "www.facebook.com/groups/breakthroughbodymastermind"
      }
    ],
    "scrapedAt": "2026-09-25T16:09:33.483Z",
    "error": null
  },
  {
    "imageUrl": "https://yt3.ggpht.com/aevf0xOT9Sv8pWLSP6t9N6nfHD30CBSd4gXGmJr8njrM24yDwhlCRYixaukdnbCNcTNJ34Hp8Q=s176-c-k-c0x00ffffff-no-rj-mo",
    "channelName": "ZEROX FITNESS COACH",
    "handle": "@ZEROXFITNESSCOACH",
    "channelId": "UCp9IKw3QL6t8io9f71FYF5Q",
    "channelUrl": "https://www.youtube.com/@ZEROXFITNESSCOACH",
    "isVerified": false,
    "isArtist": false,
    "subscribers": 182000,
    "subscribersText": "182K subscribers",
    "description": "【 WELCOME TO TABATA 】 Here's a killer Calorie Killer workout for you all! Time to get the heart pumping, burn some calories ...",
    "searchQuery": "fitness coach",
    "searchRank": 5,
    "fullDescription": "【 WELCOME TO TABATA 】\nHere's a killer Calorie Killer workout for you all! Time to get the heart pumping, burn some calories and tone your Body Shape.\nEverything You Need to Know About Tabata, the Best Fat-Burning Workout.\nIn fact, perhaps the most effective workout can only take four minutes. It’s called Tabata. Before you get too excited about your new express workout, know those four minutes will be the most heart-pounding, sweat-dripping four minutes of your life.\n",
    "totalViews": 34937183,
    "videoCount": 23,
    "avgViewsPerVideo": 1519008,
    "country": "Not Disclosed",
    "joinedDate": "2016-05-28",
    "keywords": [
      "fitness",
      "workout",
      "beginner",
      "healthylifestyle",
      "fit",
      "fat lose",
      "weight lose",
      "rehab",
      "tabata",
      "4 minute workout",
      "home workout",
      "beginner",
      "full body",
      "six pac",
      "intermediate",
      "gym",
      "healthy",
      "easier",
      "do this at home",
      "12 minute workout",
      "coach",
      "personal trainer",
      "keep fit",
      "warm up",
      "cardio",
      "body weight training",
      "hiit",
      "abs",
      "easy"
    ],
    "hasBusinessEmail": true,
    "isFamilySafe": true,
    "rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UCp9IKw3QL6t8io9f71FYF5Q",
    "bannerUrl": "https://yt3.googleusercontent.com/Rsh36Wzb5qSO3UAaPh1SPLZHAv2KX-i88yej2C7ofas-M-0Pau0Qy7croZirOc3igJ6-Pi5uSPo=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
    "links": [
      {
        "title": "MJ Fitness",
        "url": "https://www.youtube.com/channel/UCp9IKw3QL6t8io9f71FYF5Q"
      }
    ],
    "scrapedAt": "2026-09-25T16:09:34.185Z",
    "error": null
  }
]
```

### ✨ Why choose this Actor

- 🧭 **Discovery, not lookup.** Most channel tools need you to paste channel links. This one starts from a keyword.
- 📊 **Rank and audience in one row.** Search position, subscribers and verified badge side by side, ready to sort.
- 🧹 **Pay only for channels you keep.** Subscriber and verified filters run before billing.
- 📄 **About page on demand.** Country, exact views, video count, join date and links when you need them, off when you only need the list.
- 🔗 **Same field names as our other YouTube Actors** (channelId, channelName, channelUrl, subscribers, totalViews, videoCount), so the output joins cleanly with them.
- ⚡ **Fast and light.** Plain HTTP, no browser: 20 channels per request, a few hundred channels in under 30 seconds.

### 📈 How it compares to alternatives

| | This Actor | Typical YouTube channel search tools |
|---|---|---|
| Channels by keyword | ✅ | ✅ |
| Search rank per keyword | ✅ | Rarely |
| Subscriber and verified filters before billing | ✅ | Rarely |
| Country, exact views, video count, join date | ✅ optional | Some, often a separate Actor |
| External links from the About page | ✅ optional | Rarely |
| Exact subscriber count | ❌ YouTube only publishes rounded counts | ❌ |
| Business email address | ❌ YouTube shows it only after sign-in and a captcha | Some, by other means |

Honest ceilings: YouTube stops handing out results after a few hundred channels per keyword (97 to 367 in our tests, depending on the topic), so use several related keywords for a bigger list. Subscriber counts are the rounded figures YouTube shows publicly (20.3K, 2.07M). Results follow YouTube's English interface ranking.

### 🚀 How to use

1. Create a free Apify account with $5 of credit: [sign up here](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open YouTube Channel Search Scraper and type one or more keywords into **Search terms**.
3. Set **Max Items**, and optionally the subscriber range, **Verified channels only** and **Add About page details**.
4. Click **Start** and download the dataset as CSV, Excel, JSON or XML.

Example:

```json
{ "searchQueries": ["fitness coach", "home workout"], "maxItems": 200, "minSubscribers": 10000, "maxSubscribers": 500000, "includeChannelDetails": true }
```

### 💼 Business use cases

#### 📣 Influencer discovery

Search 10 keywords around your product, keep channels between 10K and 500K subscribers, and get a shortlist of mid-size creators with their country and links in one export.

#### 🤝 Outreach lists

Turn on About page details to get each creator's website, Instagram, TikTok and booking links, plus a flag for channels that publish a business email.

#### 🕵️ Competitor mapping

See which channels rank for the keywords you care about, how big they are, and how their search rank moves when you run the same search every week.

#### 📊 Market sizing

Count channels, total subscribers and total views per topic and country to size a niche before you enter it.

### 🔌 Automating YouTube Channel Search Scraper

- **Make** and **Zapier**: run it on a schedule and push new channels into Google Sheets, Airtable or HubSpot.
- **Slack**: post new channels that match your filters to a channel for your partnerships team.
- **Airbyte**: sync the dataset into BigQuery, Snowflake or Postgres.
- **GitHub Actions**: trigger runs from your data pipeline through the Apify API.
- **Google Drive**: save each run's CSV or Excel export to a shared folder.

### 🌟 Beyond business use cases

- 🎓 **Research:** study how creator ecosystems form around a topic, with rank and audience data.
- 🙋 **Personal:** find new channels to follow in a niche you love, sorted by size.
- 🤝 **Non-profit:** find the creators who already talk about your cause.
- 🧪 **Experimentation:** build channel datasets for ranking or recommendation experiments.

### 🤖 Ask an AI assistant about this scraper

Paste this page into ChatGPT, Claude or Gemini and ask things like "Which inputs find verified cooking channels under 1 million subscribers?" or "How do I get the Instagram links of the top 100 fitness channels?".

### ❓ Frequently Asked Questions

#### 🔑 Do I need a YouTube account or API key?

No. The Actor reads only publicly available data and needs no login, cookie or API key, so there is no YouTube API quota to worry about.

#### 🔎 Is this the same as searching on youtube.com?

Yes. It runs the same search with the "Type: Channel" filter and returns the channels in the same order.

#### 📚 How many channels can one keyword return?

YouTube stops after a few hundred. In our tests "fitness" returned 367 distinct channels and "lofi music" 97. Add related keywords to go further; each channel is delivered once per run.

#### 👥 Why are subscriber counts rounded?

YouTube publishes only rounded counts (for example 20.3K) to logged-out visitors, and no public page shows the exact number. The `subscribers` column converts that figure to a number so you can sort and filter.

#### 📧 Does it return business email addresses?

No. YouTube hides the business email behind sign-in and a captcha. `hasBusinessEmail` tells you which channels list one, and `links` gives you their websites and social profiles.

#### 🧹 Are filtered channels billed?

No. Channels removed by the subscriber or verified filters are never written to the dataset and never charged.

#### 📄 What does "Add About page details" cost?

It reads one extra page per channel and is billed as a separate event per channel on top of the row. Leave it off when you only need the list.

#### 🌍 Can I search in another language?

Type your keywords in any language: YouTube matches channels by the words you use. The interface language of the search is English.

#### 🎵 What are artist channels?

Official Artist Channels merge a musician's channel and their Topic channel. `isArtist` flags them so you can include or exclude musicians.

#### 🚫 What if a keyword returns nothing?

The run keeps going with your other keywords and logs which one was empty. Nothing is charged for it.

#### 🛡 Do I need a proxy?

No. YouTube answers Apify's servers directly. You can switch the Apify proxy on for very large runs.

### 🔌 Integrate with any app

Use the Apify API, the JavaScript and Python clients, webhooks or the Make, Zapier and n8n integrations to send channel data wherever you work.

### ➡️ Next step

Found your channels? Take them further with our other YouTube Actors:

- [YouTube Scraper](https://apify.com/parseforge/youtube-scraper): the videos of each channel, with views, duration and upload date.
- [YouTube Channel Email Scraper](https://apify.com/parseforge/youtube-channel-email-scraper): the public business email of each channel.
- [YouTube Comments Scraper](https://apify.com/parseforge/youtube-comments-scraper): what their audience says under each video.
- [YouTube Transcript Scraper](https://apify.com/parseforge/youtube-transcript-scraper): what they actually say in their videos.
- [YouTube Shorts Scraper](https://apify.com/parseforge/youtube-shorts-scraper): their Shorts with views, likes and music credits.

### 🔗 Recommended Actors

- [YouTube Scraper](https://apify.com/parseforge/youtube-scraper)
- [YouTube Channel Email Scraper](https://apify.com/parseforge/youtube-channel-email-scraper)
- [YouTube Comments Scraper](https://apify.com/parseforge/youtube-comments-scraper)
- [YouTube Transcript Scraper](https://apify.com/parseforge/youtube-transcript-scraper)
- [YouTube Hashtag Scraper](https://apify.com/parseforge/youtube-hashtag-scraper)

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge).

**🆘 Need Help?** [Open our contact form](https://tally.so/r/BzdKgA)

> **⚠️ Disclaimer:** this is an independent tool, not affiliated with YouTube or Google. It collects only publicly available data.

# Actor input Schema

## `searchQueries` (type: `array`):

Keywords to search YouTube channels for, one per line (for example: fitness coach, crypto news, vegan recipes). Each term runs YouTube's own channel search, the same as the Channel filter on youtube.com.

## `maxItems` (type: `integer`):

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000. The total is shared across your search terms. YouTube lists a few hundred channels per term at most, so add more terms for bigger lists.

## `minSubscribers` (type: `integer`):

Skip channels below this subscriber count. YouTube shows rounded counts (for example 92.6K), and the filter uses that number. Leave empty for no minimum. Channels that hide their subscriber count are skipped whenever a subscriber filter is set.

## `maxSubscribers` (type: `integer`):

Skip channels above this subscriber count, handy for finding micro creators. Leave empty for no maximum.

## `verifiedOnly` (type: `boolean`):

Keep only channels that carry YouTube's verified badge.

## `includeChannelDetails` (type: `boolean`):

Adds 12 columns per channel: full description, exact total views, video count, average views per video, country, join date, keywords, business email flag, family safe flag, RSS feed, banner and external links. One extra page per channel, billed as a separate event.

## `proxyConfiguration` (type: `object`):

Apify proxy settings. YouTube answers without a proxy, so leave it off unless a large run gets throttled.

## Actor input object example

```json
{
  "searchQueries": [
    "fitness coach"
  ],
  "maxItems": 10,
  "verifiedOnly": false,
  "includeChannelDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

Key channel fields

## `fullData` (type: `string`):

Complete dataset with all 26 fields

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "fitness coach"
    ],
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/youtube-channel-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["fitness coach"],
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/youtube-channel-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "fitness coach"
  ],
  "maxItems": 10
}' |
apify call parseforge/youtube-channel-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/youtube-channel-search-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Mff9wJC99Hy49lzrZ/builds/reXvd9Hl4tAVrLqEA/openapi.json