# Youtube Channel Finder (`scraperoka/youtube-channel-finder`) Actor

🔎 YouTube Channel Finder helps you discover the right channels fast—find niche creators, trending content, and growth opportunities. 🚀 Perfect for creators, marketers & researchers looking for targeted insights.

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

## Pricing

from $1.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### YouTube Channel Finder 🚀

Manually visiting profiles to discover relevant YouTube channels wastes hours you don’t have. **YouTube Channel Finder** helps you bulk-find channels by keyword, so you can build a target list fast. This YouTube channel finder tool is ideal for marketers, recruiters, and growth teams looking for a youtube channel lookup without friction—getting thousands of channel records in minutes.

***

### What You Get: Sample Output

Here’s a sample record from a single run:

```json
{
  "keyword": "fitness",
  "url": "https://www.youtube.com/@somefitnessbrand",
  "description_snippet": "Fitness tips, workouts, and nutrition advice for beginners.",
  "source": "Search Engine"
}
```

| Field | Type | What It Tells You |
|---|---|---|
| `keyword` | string | The exact search keyword used for this channel discovery |
| `url` | string | The normalized YouTube channel URL you can open and verify quickly |
| `description_snippet` | string | A short snippet that describes what the channel appears to be about |
| `source` | string | Where the channel entry was sourced from for transparency |
| `url` (validity behavior) | string | Only channel-style URLs are accepted; videos/shorts-style URLs are skipped |
| `description_snippet` (sometimes empty) | string | If no snippet is available, this may be an empty string rather than a hard failure |
| `keyword` (dedup intent) | string | Results are collected per keyword and aggregated into a single dataset |
| `source` (value) | string | Source is recorded as `"Search Engine"` in the dataset |
| `error_message` | string | This field is not present in the dataset output described for channels (channel-finder results are link/snippet based) |
| `status` | string | This field is not part of the dataset transformation for channel records |

Export your dataset as JSON, CSV, or Excel — straight from the Apify dashboard.

***

### Why YouTube Channel Finder?

There are a lot of ways to pull channel data from public web sources—here’s what sets YouTube Channel Finder apart.

#### Built for keyword-driven discovery

You provide `keywords` and an optional `country`, and the actor returns a channel list built around your search intent. This makes it a practical youtube channel search engine for lead research and creator prospecting.

#### Clear, dataset-first output

Each record is written to the dataset with consistent fields: `keyword`, `url`, `description_snippet`, and `source`. That means your youtube channel lookup results are immediately usable for spreadsheets, CRM imports, and further enrichment.

#### Resilient paging with run-level limits

The actor uses page-based collection with built-in stopping logic, including ending a keyword search after multiple consecutive empty pages. It also enforces a global lead cap per run to prevent runaway collection.

#### Country targeting included

You can set the target `country` to focus discovery. This is handy when you’re trying to find youtube channels by keyword in a specific market for localized outreach.

***

### Configuring Your Run

Drop this into your `input.json` to get started:

```json
{
  "keywords": ["fitness", "tech reviewer"],
  "country": "United States"
}
```

| Parameter | Required | What It Does |
|---|---|---|
| `keywords` | ✅ | List of keywords to search for YouTube channels (for example: “tech reviewer”, “fitness”, “gaming”) |
| `country` | ⬜ | Target country for the leads search. Used to focus discovery for your outreach or research market |

***

### Core Capabilities

#### Bulk channel discovery from public web data

YouTube Channel Finder searches for YouTube channels using your `keywords` and collects matching channel URLs plus a description snippet when available. It’s a fast youtube channel finder online for building a large channel shortlist.

#### Channel-only URL validation

The actor filters results to keep only valid YouTube channel URL types (channel/user/handle formats) and skips other content types like videos or shorts. This improves the usefulness of your youtube channel id lookup workflow because entries are consistently channel-focused.

#### Deduplicated channel URL collection per keyword page

When it processes results pages, it keeps a set of seen channel URLs to avoid duplicates within that page’s collection. This helps your list stay clean when you’re doing repeated youtube channel search api style research.

#### Dataset writing as you go

Results are pushed to the dataset during processing (not only at the end). That way, even if a run stops early, you still keep what was captured so far—useful for iterative lead building.

#### Built-in pacing and retries for resilience

The actor includes request delay support and retry logic to improve reliability during collection. In practice, this means fewer hard-stop failures while you’re searching for youtube channels by keyword.

***

### Who Gets the Most Out of This

Here’s how different teams put YouTube Channel Finder to work:

**Marketers & Influencer Outreach Teams** — Use keywords to discover creator channels relevant to their campaign topics, then open each `url` and use the snippet as quick context before outreach. This speeds up shortlist creation without manual searching.

**Recruiters & Growth Leads** — Build a channel list based on niche keywords and target country, then use the dataset as an initial prospect pool for partnership or talent discovery workflows.

**Freelance Researchers & Analysts** — Generate structured youtube channel lookup outputs for research briefs, competitive scans, or content landscape mapping. The `keyword` and `description_snippet` fields make it easy to label and filter results.

**Automation Specialists (API + pipelines)** — Pull youtube channel search engine results into your own data pipeline using Apify API automation, then pass the dataset to your enrichment steps (for example, checking websites or other public contact sources).

***

### Step-by-Step: How to Use It

No coding needed. Here's how to run YouTube Channel Finder from start to finish:

1. **Open** the actor on Apify — go to [console.apify.com](https://console.apify.com) and find YouTube Channel Finder.
2. **Enter your inputs** — set `keywords` (required) and optionally `country`.
3. **Configure proxy settings** — if available in your run UI, set proxy preferences for better reliability.
4. **Hit Run** and watch the live log for progress as keywords are processed.
5. **View results** in the Dataset tab as records are collected.
6. **Export** your dataset as JSON, CSV, or Excel from the Apify dashboard.

The whole process takes under 5 minutes to set up.

***

### Integrations & Export Options

Once your data is collected, YouTube Channel Finder plugs directly into your existing workflow.

Export formats are available directly from the Apify dataset tab, including JSON, CSV, and Excel. This makes it easy to move your youtube channel finder tool results into spreadsheets and downstream analysis.

You can also use Apify API access to pull results programmatically (see [apify.com/docs/api](https://apify.com/docs/api)) and automate routing via tools like Zapier or Make. If you need the actor to run on a schedule, you can set up scheduled runs so your youtube channel discovery stays up to date.

***

### Pricing & Free Trial

YouTube Channel Finder runs on the Apify platform, which offers a **free tier** — no credit card required to get started. Apify commonly provides a limited amount of platform credits for testing via the free tier, and you can scale by upgrading based on your usage needs.

For exact current plan details, visit [apify.com](https://apify.com) and check the pricing page before you launch a large run. Start free and scale when you’re ready.

***

### Reliability & Performance

| What We Handle | How |
|---|---|
| Empty pages during keyword search | Stops a keyword after multiple consecutive empty pages to avoid wasting time |
| Unreliable requests | Uses retry logic for more consistent collection |
| Run-level output control | Enforces a global channel limit per run to keep results predictable |
| Output structure | Writes consistent channel records to the dataset with `keyword`, `url`, `description_snippet`, and `source` |

Limitations: this actor discovers channels from publicly available web data, so it may not find everything for very niche keywords. Channel pages and snippets can vary, so some entries may have less descriptive text than others.

For enterprise-scale runs, contact us to discuss custom configurations.

***

### Frequently Asked Questions

#### Is there a free plan or trial?

Yes. Apify provides a free tier on the platform, which is suitable for smaller test runs. For details on current credits and eligibility, check the Apify pricing page.

#### Do I need to log in to YouTube to use this?

No. YouTube Channel Finder does not require a YouTube login for channel discovery. It works with publicly accessible information.

#### How accurate is the data?

The actor records channel URLs that pass its channel URL validation logic and captures a snippet when it’s available from the source page. Accuracy depends on what’s published publicly for each channel.

#### How many results can I get per run?

A global maximum channel limit is enforced per run. The limit is capped more tightly on free tier usage and expanded for paid users.

#### How often is the data updated / how fresh is it?

Results reflect what’s available at the time of the run. If you need fresher discovery, you can schedule runs and re-collect using the same `keywords` and `country`.

#### Is this legal? Does it comply with GDPR / CCPA?

YouTube Channel Finder is designed to use **publicly available data** that doesn’t require login. Still, you are responsible for ensuring your collection, storage, and outreach comply with GDPR, CCPA, and applicable platform terms.

#### Can I export results to Google Sheets or Excel?

Yes. You can export your dataset as JSON, CSV, or Excel directly from the Apify dashboard. For Google Sheets, you can also move the exported CSV into your sheet workflow.

#### Can I run this on a schedule automatically?

Yes. Apify supports scheduled runs, so you can automate recurring channel discovery using the same inputs. This is helpful for maintaining an up-to-date creator list.

#### Can I access this via API?

Yes. You can access YouTube Channel Finder outputs via the Apify API so you can integrate it into your own systems and automations. See [apify.com/docs/api](https://apify.com/docs/api) for details.

#### What happens if the actor hits an error?

If pages fail to load or results can’t be collected for a keyword, the actor uses resilience behavior such as retries and stopping logic for consecutive empty pages. You’ll still receive any channel records successfully collected during the run.

***

### Need Help or Have a Request?

Got a question about YouTube Channel Finder or want a new feature added? Reach out at <dataforleads@gmail.com>. We’re happy to hear feedback and ideas—such as enhancements to batch workflows and enrichment steps—and we actively maintain the actor based on user needs.

***

### Disclaimer & Responsible Use

*YouTube Channel Finder is the fastest, most reliable way to discover YouTube channels by keyword—start your free run today.*

This actor collects **publicly available data**. It does not access private accounts, login-gated content, or password-protected pages. You are responsible for complying with GDPR, CCPA, and platform Terms of Service when using and storing the output. For data-removal requests, contact <dataforleads@gmail.com>. Use responsibly, ethically, and only for lawful purposes.

# Actor input Schema

## `keywords` (type: `array`):

List of keywords to search for YouTube channels (e.g., 'tech reviewer', 'fitness', 'gaming').

## `country` (type: `string`):

Select the target country for leads.

## Actor input object example

```json
{
  "keywords": [
    "fitness"
  ],
  "country": "United States"
}
```

# 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 = {
    "keywords": [
        "fitness"
    ],
    "country": "United States"
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraperoka/youtube-channel-finder").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 = {
    "keywords": ["fitness"],
    "country": "United States",
}

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

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

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

```

## CLI example

```bash
echo '{
  "keywords": [
    "fitness"
  ],
  "country": "United States"
}' |
apify call scraperoka/youtube-channel-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scraperoka/youtube-channel-finder",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/rVxDjfULdNZ51f351/builds/f1Qaoi6p0tDe4Y8fl/openapi.json