# Youtube Phone Number Scraper - Country Filter & Carrier Data (`code-beat/youtube-phone-number-scraper-fast-and-reliable`) Actor

📱 YouTube Phone Number Scraper extracts channel and creator business numbers in bulk with country filtering and carrier data. ✅ Line-type detection plus automatic validation. 🤝 Built for influencer marketing & video ad sales.

- **URL**: https://apify.com/code-beat/youtube-phone-number-scraper-fast-and-reliable.md
- **Developed by:** [Code Beat](https://apify.com/code-beat) (community)
- **Categories:** Lead generation, Social media, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 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/actors/running/actors-in-store.md#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 Phone Number Scraper

**YouTube Phone Number Scraper** helps you save hours of manual research by finding publicly available phone numbers from YouTube profiles, bios, and post content using targeted keywords and country filtering. It’s a practical YouTube data extraction tool for marketers, analysts, and researchers who need faster outreach, better lead generation, and cleaner contact discovery with less guesswork. 📞

### What is YouTube Phone Number Scraper? 🔍

**YouTube Phone Number Scraper** is an Apify automation actor built to collect publicly available phone numbers from YouTube-related public content. It returns structured records with the keyword used, title, description, URL, phone number, country, and dial code. Whether you're a sales professional, recruiter, or marketer, this YouTube contact scraper makes it easier to build a YouTube lead scraper workflow and supports automated YouTube scraping for contact discovery. It’s especially useful when you need a YouTube creator contact finder or YouTube business contact scraper without doing manual checking one profile at a time. 🚀

### What Does YouTube Phone Number Scraper Do? ⚙️

The actor takes your keywords and country selection, processes publicly available sources, and saves matching results directly to your dataset. You can also narrow the search with an optional location filter and stop the run once a set number of phone numbers has been found. This makes it useful as a YouTube phone extractor, YouTube channel phone number finder, and YouTube public phone number extractor for lead generation.

- 🔍 **Searches** with your keywords and optional location filter
- 📞 **Extracts** publicly available phone numbers from matching YouTube content
- 🌍 **Targets** the country you select for more relevant results
- 📊 **Structures** results into clean dataset records
- 💾 **Stops** when the maximum phone number limit is reached

### What Would Results from YouTube Phone Number Scraper Look Like? 👀

Here’s a realistic example of the kind of output you can expect from the Apify dataset. Each record is ready for analysis, outreach, or import into your workflow.

```json
{
  "keyword": "marketing",
  "title": "Sarah Thompson",
  "description": "Founder and growth strategist. Contact for brand collaborations and speaking requests.",
  "url": "https://www.youtube.com/@sarahthompson",
  "phone_number": "+44 20 7946 0958",
  "country": "United Kingdom",
  "dial_code": "+44"
}
```

Export your results as JSON or CSV from the Apify dataset tab.

### Capabilities of YouTube Phone Number Scraper 🛠️

| Capability | What It Means for You |
|---|---|
| ✅ **Keyword Search** | Use your chosen keywords to find relevant YouTube profiles and public contact info |
| ✅ **Location Filter** | Narrow results by location when you want more focused YouTube audience lead generation |
| ✅ **Country Targeting** | Select the country that best matches your outreach or research needs |
| ✅ **Result Cap** | Control how many phone numbers are collected with `maxPhoneNumbers` |
| ✅ **Real-Time Output** | Results are saved to the dataset as they are found |
| ✅ **Proxy Support** | Built-in proxy support helps improve reliability during larger runs |
| ✅ **Bulk Extraction** | Great for YouTube channel contact mining across multiple keywords |
| ✅ **Structured Dataset** | Easy-to-use output for CRM enrichment, spreadsheets, or analysis |

### Launch Your First YouTube Phone Number Scraper Task 🚀

#### Required Input Fields

```json
{
  "keywords": [
    "marketing",
    "founder"
  ],
  "location": "",
  "country": "United Kingdom (+44)",
  "maxPhoneNumbers": 20
}
```

| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| `keywords` | Array | Yes | `["marketing","founder"]` | Keywords used to find matching public YouTube content. |
| `location` | String | No | `""` | Optional location filter. Leave empty if you want broader results. |
| `country` | String | Yes | `United Kingdom (+44)` | Country target used for phone number extraction. |
| `maxPhoneNumbers` | Integer | No | `20` | Stops the run after this many unique phone numbers are found. |

#### Required Output Fields

| Field | Label | Format | Description |
|---|---|---|---|
| `keyword` | Keyword | text | The keyword that led to this result. |
| `title` | Title | text | The title associated with the result. |
| `description` | Description | text | The text snippet or description captured for the result. |
| `url` | Url | link | The linked YouTube page or source URL. |
| `phone_number` | Phone Number | text | The extracted phone number. |
| `country` | Country | text | The country selected for the run. |
| `dial_code` | Dial Code | text | The dialing code for the selected country. |

**Step-by-step launch guide:**

1. **Open** the actor in Apify Console.
2. **Enter keywords** in the Input tab.
3. **Choose the country** you want to target.
4. **Set an optional location** if you want a narrower result set.
5. **Click Start** and watch the dataset fill in as the run progresses.
6. **Download results** from the Dataset tab as JSON or CSV.

### Solving Real Problems with YouTube Phone Number Scraper 💼

This YouTube scraper for contact info is designed to solve practical lead-gen and research tasks without manual browsing.

- 🎯 **Sales Prospecting** — Build a focused YouTube lead scraper workflow for outreach
- 📣 **Campaign Targeting** — Use a YouTube contact details scraper to collect public contacts for promotion
- 🤝 **Creator Outreach** — Find contact points for collaborations with creators and channel owners
- 🔬 **Market Research** — Study public contact availability across niches and regions
- ⚙️ **Bulk Prospecting** — Support repeatable YouTube channel contact mining across multiple keywords

### What Sets YouTube Phone Number Scraper Apart? 🏆

- ⚡ **Fast setup** — Start scraping with just keywords and a country selection
- 🔄 **Built for resilience** — Includes retries and fallbacks for more reliable runs
- 📊 **Clean output** — Gives you structured dataset records ready for analysis
- 📧 **Support available** — Contact <codebeatapi@gmail.com> for help or custom requests

### Search Limits and Capacity 📈

- Set `maxPhoneNumbers` from 1 to 10,000 per run
- The final result count depends on how much public contact data is available for your chosen keywords and country
- Larger runs may take more time, especially with broader keyword sets
- Built-in proxy support helps keep the YouTube prospecting tool reliable during heavier usage

### Is It Legal to Scrape YouTube? ⚖️

This actor collects only publicly available data from YouTube-related public content. It does not access private accounts, hidden information, or password-protected data. Users are responsible for following applicable laws, platform terms, and any data-protection or anti-spam rules that may apply to their use case. For support, feedback, or data-removal inquiries, contact <codebeatapi@gmail.com>. ✅

### Ending Note ✉️

Stop spending hours manually searching YouTube for contacts. The **YouTube Phone Number Scraper** gives you a faster way to build public contact lists, support YouTube audience lead generation, and turn public data into usable leads. Try it on Apify and see how much time you can save. 🚀

### FAQ — YouTube Phone Number Scraper ❓

#### How Does YouTube Phone Number Scraper Work?

You provide keywords, choose a country, and optionally add a location. The actor then collects matching public YouTube contact data and saves the results into your Apify dataset.

#### What Types of YouTube Profiles Can I Target?

You can target public YouTube-related profiles and pages where phone numbers appear in bios, descriptions, or post content. Private or non-public content is not included.

#### What Data Does the Output Include?

Each record includes `keyword`, `title`, `description`, `url`, `phone_number`, `country`, and `dial_code`.

#### How Can I Control the Number of Results?

Use `maxPhoneNumbers` to stop the run after a specific number of unique phone numbers has been found. The limit can be set from 1 to 10,000.

#### Is This Useful for YouTube Lead Scraper Workflows?

Yes. It’s a strong fit for YouTube lead scraper, YouTube business contact scraper, and YouTube creator contact finder workflows where public phone numbers matter.

#### What Should I Do If I Get Too Few Results?

Try broader keywords, adjust the location filter, or choose a different country. Some searches simply return fewer public contacts than others.

#### Can I Use This as a YouTube Email and Phone Scraper?

This actor is designed for phone numbers. If your goal is broader YouTube email and phone scraper workflows, you should only rely on the fields this actor actually outputs.

#### How Do I Get Help?

For support, feature requests, or data-removal inquiries, contact <codebeatapi@gmail.com>.

### Country & Time Targeting

**Target Country** did two jobs already: it supplies the dial code the search
looks for, and it is the region numbers are parsed against. It now does a third

- Google is asked to answer as if searching from that country (`gl`). Turn on
  **Strict country filter** to also restrict results to pages Google attributes to
  it (`cr=countryXX`); that is much tighter and returns noticeably fewer results.

**Result Language** restricts results to one language (`hl` + `lr`).

**Time Range** limits results to a publication window - past hour, 24 hours,
week, month, year, or an explicit *Custom range* via **Custom range: from** /
**to** in `YYYY-MM-DD` form. Selecting *Custom range* without either date falls
back to no time filter rather than silently searching all of time.

### Region resolution

| Field | Meaning |
| --- | --- |
| `regionAmbiguous` | `true` when the number was printed without a country code and the same national digits are valid in more than one country |
| `phoneIsMobile` | `true`/`false` where the numbering plan can tell, empty where it genuinely cannot (US, Canada, Mexico) |
| `phoneCallingCode` | The country's international calling code, as a number |
| `phoneCountryName` | Full country name, falling back to the two-letter code rather than guessing |

`regionAmbiguous` is the important one. A number written as `020 7946 0958` is
only a UK number because the run targeted the UK - the country shown is a
reading, not a fact, and this column tells you which rows those are.

# Actor input Schema

## `scrapeMode` (type: `string`):

Find New Numbers (default) searches About.Me by keyword. Validate My List skips searching entirely and instead runs the numbers you paste into Phone List (below) through the same deliverability checks.

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

Enter keywords to search for (e.g., 'Target Keyword'). Only used in Find New Numbers mode.

## `location` (type: `string`):

Filter by location (e.g., 'London', 'California'). Leave empty for global search. Only used in Find New Numbers mode.

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

Select the country to target for phone numbers. Only used in Find New Numbers mode.

## `phoneList` (type: `array`):

Paste the phone numbers you want checked for deliverability (any format - the selected Country is used as the default region for numbers without a country code). Only used when Scrape Mode is set to "Validate My List".

## `maxPhoneNumbers` (type: `integer`):

Stop scraping after this many phone numbers are found. Setting a higher limit extends the scraping duration. Only used in Find New Numbers mode.

## `minQualityScore` (type: `number`):

Drop any number whose quality score (0.0-1.0) falls below this. Leave at 0 for no filter.

## `requireStrictValid` (type: `boolean`):

Drop numbers that fail strict validity (correct length/format for the region) - mainly relevant in Validate My List mode, since search results are already strictly valid by construction.

## `excludeTollFree` (type: `boolean`):

Drop numbers identified as toll-free.

## `excludePremiumRate` (type: `boolean`):

Drop numbers identified as premium-rate.

## `requireCountryMatch` (type: `boolean`):

Drop numbers whose own detected region does not match the Country you selected (e.g. shared dial codes like +1 covering the US, Canada, and Caribbean nations).

## `strictCountry` (type: `boolean`):

Restrict Google to pages it attributes to the country you selected (cr=countryXX), rather than only preferring them. Much tighter targeting, noticeably fewer results.

## `searchLanguage` (type: `string`):

Restrict results to one language. Leave on "Any language" for no filter.

## `timeRange` (type: `string`):

Only return pages Google indexed within this window. A number published last month is far more likely to still be answered than one last seen years ago.

## `customDateFrom` (type: `string`):

Only used when Time Range is "Custom range". Format: YYYY-MM-DD.

## `customDateTo` (type: `string`):

Only used when Time Range is "Custom range". Format: YYYY-MM-DD.

## Actor input object example

```json
{
  "scrapeMode": "Find New Numbers",
  "keywords": [
    "marketing",
    "founder"
  ],
  "country": "United Kingdom (+44)",
  "phoneList": [],
  "maxPhoneNumbers": 20,
  "minQualityScore": 0,
  "requireStrictValid": false,
  "excludeTollFree": false,
  "excludePremiumRate": false,
  "requireCountryMatch": false,
  "strictCountry": false,
  "searchLanguage": "",
  "timeRange": "Any time",
  "customDateFrom": "",
  "customDateTo": ""
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# 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": [
        "marketing",
        "founder"
    ],
    "phoneList": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("code-beat/youtube-phone-number-scraper-fast-and-reliable").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": [
        "marketing",
        "founder",
    ],
    "phoneList": [],
}

# Run the Actor and wait for it to finish
run = client.actor("code-beat/youtube-phone-number-scraper-fast-and-reliable").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 '{
  "keywords": [
    "marketing",
    "founder"
  ],
  "phoneList": []
}' |
apify call code-beat/youtube-phone-number-scraper-fast-and-reliable --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,code-beat/youtube-phone-number-scraper-fast-and-reliable"
        }
    }
}

```

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/AIkdtyUsOmEKDTJ6M/builds/PdlVfbem40CxLtj7V/openapi.json