Documentation only. This repository is the usage guide for the hosted YouTube Influencer Discovery Scraper Apify Actor. There is no source code here — the Actor runs on the Apify platform. Everything below shows you how to call it from the Console, CLI, API, JavaScript and Python.
Find YouTube influencers by niche and get the data outreach teams actually need — subscriber count, average views, engagement rate, business email, handle and social links for every creator. Search by keyword / niche (or pass channels directly to enrich), filter by subscriber tier and email-only, and export a scored, contactable shortlist to JSON, CSV or Excel. No login, no cookies and no Google API key.
The key differentiator: engagement rate is computed for you. The Actor samples each channel's recent uploads, calculates average and median views, then derives an engagement rate (avg views ÷ subscribers) — the metric that separates real reach from vanity subscriber counts. One run surfaces dozens of contactable creators per niche, each ranked by real engagement, ready for influencer-marketing campaigns and sponsorship vetting.
One row per creator — scored and contact-enriched.
| Field | Type | Description |
|---|---|---|
channelId |
string | YouTube UC… channel identifier. |
channelTitle |
string | Channel / creator display name. |
handle |
string | @handle of the channel, if any. |
channelUrl |
string | Canonical channel URL. |
subscriberCount |
number | Approximate subscriber count as a number. |
subscriberCountText |
string | Raw subscriber text (e.g. 1.2M subscribers). |
avgRecentViews |
number | Average views across the sampled recent videos. |
medianRecentViews |
number | Median views across the sampled recent videos. |
videosAnalyzed |
number | Number of recent videos used for the stats. |
engagementRatePct |
number | avgRecentViews ÷ subscribers, as a percentage. |
latestVideoPublished |
string | Relative publish text of the most recent video. |
email |
string | First contact email found in the channel description. |
emails |
array | All contact emails found in the channel description. |
socialLinks |
array | Social/profile URLs found in the channel description. |
keywords |
array | Channel keywords / tags. |
description |
string | Full channel description. |
avatar |
string | Channel avatar image URL. |
scrapedAt |
string | ISO 8601 timestamp when the row was collected. |
- Influencer outreach lists — build a contactable shortlist of creators in a niche, scored by engagement, ready to push into your CRM.
- Micro-influencer campaigns —
maxSubscribers: 100000+minSubscribers: 5000finds affordable, high-engagement creators the big tools miss. - Sponsorship vetting — compare engagement rate, not just subscriber count, before paying for a placement.
- Agency prospecting — find creators to represent, or brands/creators to pitch your services to.
- Competitive creator mapping — see who is active in your category and how they actually perform.
- CRM enrichment — feed a list of channels into
channelsto backfill emails, subscribers and engagement. - Regional discovery — target creators in a specific country by setting
regionfor the search context.
- Open the Actor: apify.com/logiover/youtube-influencer-discovery-scraper.
- Click Try for free. Enter one or more niches in Niche keywords (e.g.
personal finance,home barista) and/or paste specific Channels — or leave everything empty to discover Tech Review creators by default. - Optionally set a subscriber tier and Only channels with an email. Click Start, then Export to JSON / CSV / Excel.
npm i -g apify-cli
apify login
apify call logiover/youtube-influencer-discovery-scraper --input '{
"searchQueries": ["home workout", "healthy recipes"],
"minSubscribers": 5000,
"maxSubscribers": 100000,
"requireEmail": true
}'curl -X POST \
"https://api.apify.com/v2/acts/logiover~youtube-influencer-discovery-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"searchQueries":["personal finance","tech reviews"],"maxChannelsPerQuery":40,"maxResults":200}'import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('logiover/youtube-influencer-discovery-scraper').call({
searchQueries: ['home workout', 'healthy recipes'],
minSubscribers: 5000,
maxSubscribers: 100000,
requireEmail: true,
maxChannelsPerQuery: 50,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} creators`);from apify_client import ApifyClient
client = ApifyClient(token="YOUR_TOKEN")
run = client.actor("logiover/youtube-influencer-discovery-scraper").call(run_input={
"searchQueries": ["home workout", "healthy recipes"],
"minSubscribers": 5000,
"maxSubscribers": 100000,
"requireEmail": True,
})
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
print(f"Got {len(items)} creators")More runnable snippets: examples/cli.md · examples/api-curl.md · examples/javascript.md · examples/python.md
Give at least one searchQueries keyword or one entry in channels. Everything else is optional; with everything empty the Actor discovers Tech Review creators by default.
| Field | Type | Default | Description |
|---|---|---|---|
searchQueries |
array of strings | — | Niche keywords to discover creators in. Each runs a channel search. |
niche |
string (dropdown) | tech reviews |
Preset niche used only when searchQueries is empty (20 options). |
channels |
array of strings | — | Enrich specific channels directly — @handles, URLs or UC… IDs. Combined with discovery results. |
region |
string (dropdown) | US |
Country context for the search results (20 options). |
language |
string (dropdown) | en |
Interface/content language (15 options). |
sortBy |
string (dropdown) | relevance |
relevance, subscribers_desc, subscribers_asc, engagement_desc or avgViews_desc. |
maxChannelsPerQuery |
integer | 30 |
How many channels to discover per keyword. |
recentVideosForStats |
integer | 12 |
How many recent videos to average for avg views & engagement rate. |
minSubscribers |
integer | 0 |
Keep only channels with at least this many subs. 0 = no minimum. |
maxSubscribers |
integer | 0 |
Keep only channels up to this many subs (great for micro-influencers). 0 = no maximum. |
requireEmail |
boolean | false |
Keep only channels that expose a contact email in their description. |
maxResults |
integer | 100 |
Global cap on channels saved. 0 = unlimited. |
proxyConfiguration |
object | Apify Proxy | Proxy settings. |
Tip: engagement beats reach. A creator with 20k subs and 40% engagement often converts better (and costs far less) than one with 2M subs and 3%. Combine
maxSubscribers+requireEmail: trueto build an affordable, contactable shortlist in one run.
A trimmed sample record (numeric metrics are returned as strings):
{
"channelId": "UCxxxxxxxxxxxxxxxxxxxxxx",
"channelTitle": "Home Barista Corner",
"handle": "@homebaristacorner",
"channelUrl": "https://www.youtube.com/@homebaristacorner",
"subscriberCount": "6650",
"avgRecentViews": "3949",
"medianRecentViews": "3600",
"videosAnalyzed": "12",
"engagementRatePct": "59.38",
"email": "homebaristacorner@gmail.com",
"emails": ["homebaristacorner@gmail.com"],
"socialLinks": ["https://instagram.com/homebaristacorner"],
"keywords": ["coffee", "espresso", "home barista"],
"latestVideoPublished": "3 days ago",
"scrapedAt": "2026-07-06T12:00:00.000Z"
}- Schedules — refresh your creator shortlist weekly as new channels grow into your target tier.
- Webhooks — POST new creators to your CRM or outreach tool when a run completes.
- Google Sheets — auto-sync each dataset into a spreadsheet.
- Zapier / Make / n8n / Pipedream — push creators into HubSpot, Airtable, Notion or an email sequencer.
- Cloud storage — export datasets to Amazon S3, Google Drive or Dropbox.
- Pipeline chaining — feed the discovered channel list into an email finder or a bulk email verifier for an end-to-end outreach pipeline.
CSV · JSON · JSONL · Excel (XLSX) · XML — download from the dataset in the Console or via the Apify API.
No — no key, no login and no quota. The Actor reads public channel data directly and computes the engagement metrics itself. You only need an Apify account.
Average views across the most recent recentVideosForStats videos, divided by subscriber count, expressed as a percentage — a widely used reach proxy that is far more meaningful than raw subscriber count.
Yes. Set maxSubscribers (and optionally minSubscribers) to target a specific tier — which is exactly where the best-value creators usually sit.
Emails are parsed from the public channel description. Creators who only expose their address behind YouTube's CAPTCHA-gated "View email address" button can't be read — that's expected. Use requireEmail: true to keep only contactable creators.
Yes. Paste them into channels as handles, URLs or UC… IDs, and they are enriched alongside any keyword discovery.
Enter your niche in searchQueries, set maxSubscribers to cap the tier and requireEmail: true — the Actor returns only contactable micro-creators with their business email and engagement rate.
Set sortBy: "engagement_desc" (or avgViews_desc) so the output is ranked by real reach, letting you vet placements before you pay.
Yes. It parses the business email and social links from each creator's public channel description, so you get a ready contactable outreach list — no separate email step required.
Run the Actor, then download your results as CSV, Excel or JSON from the dataset, or pull them via the Apify API. Every creator row includes emails, subscribers and engagement rate.
The Actor collects only public channel data. Use it in line with YouTube's Terms and applicable privacy/marketing laws (GDPR, CAN-SPAM) for outreach.
- YouTube Creator Email Finder — deep two-layer email extraction for a channel list.
- YouTube Channel Scraper — extract every video of a channel with views and stats.
📄 Documentation only — the Actor runs on the Apify platform.
Released under the MIT License. © 2026 logiover. Not affiliated with YouTube / Google. All product names and trademarks are the property of their respective owners.