# YouTube Creator Sponsorship Lead Finder (`nexascout/youtube-creator-sponsorship-lead-finder`) Actor

Find sponsorship-ready YouTube creators with public contact paths, recent video performance, and transparent fit scores.

- **URL**: https://apify.com/nexascout/youtube-creator-sponsorship-lead-finder.md
- **Developed by:** [NexaScout](https://apify.com/nexascout) (community)
- **Stats:** 2 total users, 1 monthly users, 75.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $80.00 / 1,000 qualified creator leads

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## YouTube Creator Sponsorship Lead Finder

Find sponsorship-ready YouTube creators by niche and turn public channel signals into an outreach-ready lead list.

This Actor is built for brand partnerships, influencer outreach, creator agencies, affiliate programs, PR teams, and B2B prospecting. Instead of returning a generic scrape, it produces one qualified creator per row with:

- public channel identity and audience size;
- recent videos and average recent views;
- public business emails, creator websites, and social profiles when visibly published;
- sponsorship and affiliate activity signals;
- transparent relevance, reach, activity, contactability, and sponsor-fit scores;
- strict run limits and request diagnostics.

### Quick start

```json
{
  "searchQueries": ["home improvement tools"],
  "maxChannelsPerQuery": 10,
  "maxTotalChannels": 25,
  "minSubscribers": 1000,
  "maxSubscribers": 500000,
  "minimumSponsorFitScore": 40,
  "countryHint": "US",
  "languageHint": "en",
  "maxRecentVideos": 6,
  "enrichPublicWebsites": true
}
```

You can also provide exact `channelUrls` to analyze known creators.

### Output

Each dataset item is a qualified creator lead. Scores are explainable and deterministic—no opaque AI judgment and no external paid data provider is required.

The `OUTPUT` record contains candidates discovered, channels analyzed, qualified leads, failed channels, request consumption, and warnings.

### Cost controls

- HTTP-first collection; no browser is launched by default.
- `maxTotalChannels` is a hard cap.
- `requestBudget` prevents runaway requests.
- concurrency defaults to 2 to keep peak memory predictable.
- the default 1 GB memory allocation protects larger enrichment runs from YouTube page parsing spikes.
- only one public creator website is enriched per channel.
- residential proxy groups are not selected by default.

### Responsible use

The Actor collects public information only. It does not bypass email reveal gates, authentication, or CAPTCHAs. Use contact information responsibly and comply with applicable privacy, anti-spam, platform, and marketing laws.

### Data caveats

YouTube changes public page structures and may hide subscriber counts, countries, or links. The Actor reports data quality per lead and preserves diagnostics in `OUTPUT`.

# Changelog

This Actor's version history is a separate document: https://apify.com/nexascout/youtube-creator-sponsorship-lead-finder/changelog.md

# Actor input Schema

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

Topics, products, or creator niches to search on YouTube.

## `channelUrls` (type: `array`):

Optional channel URLs to analyze directly.

## `maxChannelsPerQuery` (type: `integer`):

Maximum unique channel candidates collected from each query.

## `maxTotalChannels` (type: `integer`):

Hard cost and runtime limit across all queries and direct URLs.

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

Channels with a known smaller audience are excluded.

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

Use this to focus on micro- or mid-tier creators. Leave empty for no upper limit.

## `minimumSponsorFitScore` (type: `integer`):

Only leads at or above this transparent 0–100 score are returned.

## `countryHint` (type: `string`):

Two-letter country hint used for localized YouTube results.

## `languageHint` (type: `string`):

Two-letter language hint used for localized YouTube results.

## `maxRecentVideos` (type: `integer`):

Recent uploads used to estimate current reach and sponsorship activity.

## `enrichPublicWebsites` (type: `boolean`):

Visit one public website linked by each channel and extract visible business emails and social links.

## `includeChannelsWithoutKnownSubscriberCount` (type: `boolean`):

Keep otherwise relevant channels when YouTube does not publish a subscriber count.

## `maxConcurrency` (type: `integer`):

Keep this low for reliable and cost-controlled collection.

## `requestTimeoutSecs` (type: `integer`):

Maximum duration of an individual public-page request.

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

Datacenter proxy is sufficient for the default workflow. Residential groups are not enabled by default.

## Actor input object example

```json
{
  "searchQueries": [
    "home improvement tools"
  ],
  "channelUrls": [],
  "maxChannelsPerQuery": 10,
  "maxTotalChannels": 25,
  "minSubscribers": 1000,
  "minimumSponsorFitScore": 40,
  "countryHint": "US",
  "languageHint": "en",
  "maxRecentVideos": 6,
  "enrichPublicWebsites": true,
  "includeChannelsWithoutKnownSubscriberCount": true,
  "maxConcurrency": 2,
  "requestTimeoutSecs": 30,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `creatorLeads` (type: `string`):

One dataset row per qualified creator with public contact paths, recent performance, and fit scores.

## `runSummary` (type: `string`):

Queries, candidates, qualified leads, request usage, warnings, and quality diagnostics.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("nexascout/youtube-creator-sponsorship-lead-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("nexascout/youtube-creator-sponsorship-lead-finder").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 '{}' |
apify call nexascout/youtube-creator-sponsorship-lead-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,nexascout/youtube-creator-sponsorship-lead-finder"
        }
    }
}
```

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/09Ah9FsQ1yh6aW4nN/builds/SOYgyhrLfljZfjlC3/openapi.json