# Influencer Scraper (`raushan2288/scout-lead-generator`) Actor

- **URL**: https://apify.com/raushan2288/scout-lead-generator.md
- **Developed by:** [Raushan Kumar](https://apify.com/raushan2288) (community)
- **Categories:** Automation, Social media
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 influencer discovereds

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/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

## Scout Lead Generator

[![Apify Actor](https://img.shields.io/badge/Apify-Actor-orange)](https://apify.com)

**Scout Lead Generator** is an Apify Actor that automatically discovers and scrapes **company leads** and **category/niche influencers** across **8 social platforms** — extract verified contact emails, phone numbers, bio links, follower metrics, and lead scores.

***

### What It Does

1. **Company Lead Generation**: Input company names or domains (`"Nike"`, `"adobe.com"`, `"openai.com"`) to discover their official social profiles and contact info.
2. **Category / Niche Influencer Discovery**: Input categories or niches (`"fitness"`, `"tech"`, `"crypto"`, `"fashion"`, `"gaming"`, `"beauty"`) to automatically discover top influencer profiles in that niche.
3. **Deep Contact Scraping**: Scrapes company & influencer websites, contact pages (`/contact`, `/about`), and bio links (Linktree, Beacons, Stan store) to extract verified contact emails and phone numbers.
4. **Email Pattern Prediction**: Generates business email candidates (`contact@domain`, `sales@domain`, `first.last@domain`) and performs SMTP MX verification.
5. **Exports**: Pushes all lead & influencer data directly to Apify Dataset (exportable to CSV, JSON, Excel, XML).

***

### Input

#### JSON Input Example (Company & Influencer Discovery)

```json
{
  "companies": [
    "Nike",
    "adobe.com"
  ],
  "categories": [
    "fitness",
    "tech"
  ],
  "influencersPerCategory": 5,
  "platforms": ["instagram", "youtube", "linkedin", "github"],
  "searchMode": "auto",
  "enrich": true,
  "outputFormat": "csv",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

#### Input Fields

| Field | Type | Description |
|-------|------|-------------|
| `companies` | `array` | Optional. List of company names, domains (`nike.com`), or URLs |
| `categories` | `array` | Optional. List of influencer categories/niches (`"fitness"`, `"tech"`, `"crypto"`) |
| `influencersPerCategory` | `integer` | Number of influencer profiles to discover per category (default: `5`) |
| `platforms` | `array` | Target platforms (`instagram`, `linkedin`, `tiktok`, `github`, `youtube`, `twitch`, `pinterest`, `linktree`) |
| `searchMode` | `string` | `auto` (discovers handles) or `manual` (you provide them) |
| `manualUsernames` | `object` | For `manual` mode: `{"instagram": "nike", "github": "openai"}` |
| `enrich` | `boolean` | Perform deep website scraping, phone detection, email pattern prediction, and lead scoring |
| `outputFormat` | `string` | `dataset` (default), `csv`, or `json` |
| `proxyConfiguration` | `object` | Apify Proxy configuration |
| `linkedinCookie` | `string` | `li_at` session cookie for LinkedIn scraping (secret) |
| `hunterApiKey` | `string` | Hunter.io API key for professional email enrichment (secret) |
| `googleApiKey` | `string` | Google Custom Search API key for accurate auto-discovery (secret) |
| `googleCseId` | `string` | Google Custom Search Engine ID |

***

### Output Example

```json
{
  "company_input": "Category: fitness",
  "company_name": "Keiani (@keianimabe)",
  "domain": null,
  "website": "https://keiani.com",
  "phone": "(512) 200-8725",
  "emails_found": [
    "keiani@dulcedo.com",
    "contactus@keiani.com"
  ],
  "email": "keiani@dulcedo.com",
  "email_score": 90,
  "email_source": "direct",
  "email_verified": true,
  "lead_score": 75,
  "handles": {
    "youtube": "keianimabe",
    "instagram": "keianimabe"
  },
  "platforms": {
    "youtube": {
      "handle": "keianimabe",
      "followers": 150000,
      "bio": "Fitness & lifestyle creator."
    }
  }
}
```

***

### Deployment & Local Testing

#### Prerequisites

```bash
npm install -g apify-cli
pip install -r requirements.txt
```

#### Run Locally

```bash
apify run
```

#### Push to Apify Console

```bash
apify login
apify push
```

***

### License

MIT

# Actor input Schema

## `companies` (type: `array`):

List of companies to find leads for. Provide company names, domains, or website URLs. Example: \['Nike', 'adobe.com', 'https://openai.com']

## `categories` (type: `array`):

List of categories/niches to discover influencer profiles and contacts for. Example: \['fitness', 'tech', 'crypto', 'fashion', 'gaming', 'beauty']

## `influencersPerCategory` (type: `integer`):

Number of influencer profiles to discover and extract per category.

## `platforms` (type: `array`):

Which social platforms to search. Leave empty to search all platforms.

## `searchMode` (type: `string`):

How to find company profiles. 'auto' discovers handles automatically. 'manual' uses the usernames you provide per platform.

## `manualUsernames` (type: `object`):

If searchMode is 'manual', provide usernames per platform. Example: {"instagram": "nike", "github": "openai"}

## `companyWebsite` (type: `string`):

Primary company website. Helps auto-discover social profiles when company name is ambiguous. Example: nike.com

## `enrich` (type: `boolean`):

Extract emails, cross-reference social handles, and find contact info using Hunter.ai (if API key provided)

## `outputFormat` (type: `string`):

'dataset' stores items in the Apify Dataset. 'csv' also saves a downloadable CSV file in the Key-Value Store.

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

Apify Proxy settings to avoid rate limiting and IP blocks

## `linkedinCookie` (type: `string`):

Optional LinkedIn li\_at session cookie for scraping LinkedIn profiles without rate limits

## `hunterApiKey` (type: `string`):

Optional Hunter.io API key for professional email discovery during enrichment

## `googleApiKey` (type: `string`):

Optional Google Custom Search API key to improve company profile auto-discovery accuracy

## `googleCseId` (type: `string`):

Optional Google Custom Search Engine ID paired with the Google API Key

## Actor input object example

```json
{
  "companies": [
    "Nike",
    "Adobe",
    "OpenAI"
  ],
  "categories": [
    "fitness",
    "tech"
  ],
  "influencersPerCategory": 5,
  "platforms": [
    "instagram",
    "linkedin",
    "github",
    "youtube"
  ],
  "searchMode": "auto",
  "manualUsernames": {},
  "enrich": true,
  "outputFormat": "dataset",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# 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 = {
    "companies": [
        "Nike",
        "Adobe",
        "OpenAI"
    ],
    "categories": [
        "fitness",
        "tech"
    ],
    "platforms": [
        "instagram",
        "linkedin",
        "github",
        "youtube"
    ],
    "manualUsernames": {}
};

// Run the Actor and wait for it to finish
const run = await client.actor("raushan2288/scout-lead-generator").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 = {
    "companies": [
        "Nike",
        "Adobe",
        "OpenAI",
    ],
    "categories": [
        "fitness",
        "tech",
    ],
    "platforms": [
        "instagram",
        "linkedin",
        "github",
        "youtube",
    ],
    "manualUsernames": {},
}

# Run the Actor and wait for it to finish
run = client.actor("raushan2288/scout-lead-generator").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 '{
  "companies": [
    "Nike",
    "Adobe",
    "OpenAI"
  ],
  "categories": [
    "fitness",
    "tech"
  ],
  "platforms": [
    "instagram",
    "linkedin",
    "github",
    "youtube"
  ],
  "manualUsernames": {}
}' |
apify call raushan2288/scout-lead-generator --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=raushan2288/scout-lead-generator",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

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