# Linkedin Leads Generator (`contacts-api/linkedin-leads-generator`) Actor Generate high-quality B2B prospects with our LinkedIn Leads Generator. Collect verified emails and profile data for sales outreach, recruiting, and lead generationโ€”accurate, fast, and scalable. - **URL**: https://apify.com/contacts-api/linkedin-leads-generator.md - **Developed by:** [Lead Heaven](https://apify.com/contacts-api) (community) - **Categories:** Lead generation, Social media, Automation - **Stats:** 261 total users, 7 monthly users, 100.0% runs succeeded, 2 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing $19.99/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ### ๐Ÿš€ LinkedIn Leads Generator - Email Scraper & Recruiter Finder **The Ultimate LinkedIn Lead Generator for B2B Sales, Recruiting, and Networking.** Extract verified emails, headers, and profile URLs from LinkedIn at scale. Ideal for recruiters, sales teams, and job seekers looking to automate their outreach. --- ### โœจ Key Features * **๐Ÿ“ง Email Scraper**: Automatically find public email addresses from LinkedIn profiles and summaries. * **๐Ÿ—๏ธ B2B Targeting**: Search by job titles (e.g., "Software Engineer", "Marketing Director", "Founder"). * **๐ŸŒ Location Filtering**: Target professionals in specific countries (USA, UK, Canada, Germany, etc.). * **๐Ÿ“‹ Detailed Profiles**: Get Name, Current Title, Profile URL, and Email Address. * **โšก Fast & Reliable**: Built on Apify's high-performance infrastructure. * **๐Ÿ†“ Free Tier Available**: EXTRACT 100 EMAILS FOR FREE per run! Start building your list today. --- ### ๐Ÿ› ๏ธ How It Works This actor uses a smart **two-step process** to find the most relevant leads: 1. **Discovery**: It uses advanced Google Search operators (`site:linkedin.com/in`) to find LinkedIn profiles matching your specific job titles and location. This uncovers profiles that might not be easily searchable on LinkedIn directly without a premium account. 2. **Enrichment**: It visits each profile found to verify the data and extract **public email addresses** hidden in the summary or "About" section. --- ### ๐Ÿ“ Input Parameters | Parameter | Type | Default | Description | | :--- | :--- | :--- | :--- | | **`keywords`** | `array` | `["software engineer", "marketing manager"]` | List of job titles or keywords to search. | | **`country`** | `string` | `"United States"` | Target country for the search. | | **`maxLeadsPerKeyword`** | `integer` | `20` | Max leads to collect per keyword. **(Free users capped at 100 total)** | | **`scrapeLeadsWithEmail`** | `boolean` | `false` | If true, prioritizes profiles that likely contain email addresses. | --- ### ๐Ÿ“ฆ Output Data Format The actor outputs clean, structured JSON data ready for cold outreach. #### JSON Example ```json { "keyword": "software engineer", "username": "alex-dev-lead", "userLink": "https://www.linkedin.com/in/alex-dev-lead/", "description": "Senior Software Engineer | Python | React", "emails": ["alex.coder@gmail.com"] } ```` *** ### ๐Ÿ’ก Best Practices - **Specific Titles**: Use specific job titles like "Senior Python Developer" instead of just "Developer". - **Company Targeting**: You can try keywords like "Software Engineer at Google" to find people at specific companies. - **Mix Locations**: Run separate tasks for major tech hubs (e.g., San Francisco, London, Berlin) to get more targeted results. *** ### ๐Ÿš€ Use Cases - **Recruiting & Staffing**: Find candidates with specific skills and job titles. - **B2B Sales Outreach**: Connect with decision-makers and leads in your target industry. - **Job Hunting**: Find recruiters and hiring managers in your field. - **Networking**: Expand your professional network with relevant contacts. *** ### โ“ FAQ **Q: Why do some profiles not have emails?** A: We only extract *publicly available* email addresses from the user's summary or "About" section. If they haven't listed it publicly, we can't scrape it. Use the `scrapeLeadsWithEmail` option to prioritize profiles with emails. **Q: Is this safe for my LinkedIn account?** A: Yes! This scraper uses Apify's residential proxies and does not require your LinkedIn login credentials. It searches via Google, keeping your account completely safe. **Q: What is the Free Tier limit?** A: You can scrape up to 100 emails per run for free. For unlimited access, upgrade to a paid Apify plan. *** ### ๐Ÿ’Ž Pricing & Limits - **Free Users**: Capped at **100 emails per run**. - **Premium Users**: **Unlimited** emails (subject to Apify platform rates). Upgrade to an Apify paid plan for heavy-duty scraping! *** ### ๐Ÿ“ž Support & Feedback We value your feedback! If you have feature requests, bug reports, or need custom scraping solutions, please contact us: **๐Ÿ“ง Email:** *** #### Keywords *linkedin lead generator, email scraper, linkedin scraper, recruiter finder, b2b leads, sales navigator alternative, candidate search, professional network scraper* # Actor input Schema ## `keywords` (type: `array`): List of keywords to search for LinkedIn profiles (e.g., 'software engineer', 'marketing manager'). ## `country` (type: `string`): Select the target country for leads. ## `maxLeadsPerKeyword` (type: `integer`): Maximum number of leads to collect for each keyword. Free users are capped at 100 emails total per run. ## `scrapeLeadsWithEmail` (type: `boolean`): If enabled, only returns profiles that have a public email address. ## Actor input object example ```json { "keywords": [ "software engineer", "marketing manager" ], "country": "United States", "maxLeadsPerKeyword": 20, "scrapeLeadsWithEmail": false } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "software engineer", "marketing manager" ], "country": "United States", "maxLeadsPerKeyword": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("contacts-api/linkedin-leads-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": [ "software engineer", "marketing manager", ], "country": "United States", "maxLeadsPerKeyword": 20, } # Run the Actor and wait for it to finish run = client.actor("contacts-api/linkedin-leads-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 '{ "keywords": [ "software engineer", "marketing manager" ], "country": "United States", "maxLeadsPerKeyword": 20 }' | apify call contacts-api/linkedin-leads-generator --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=contacts-api/linkedin-leads-generator", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Linkedin Leads Generator", "description": "Generate high-quality B2B prospects with our LinkedIn Leads Generator. Collect verified emails and profile data for sales outreach, recruiting, and lead generationโ€”accurate, fast, and scalable.", "version": "1.0", "x-build-id": "hRVebGnaQJXLZ5gG5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/contacts-api~linkedin-leads-generator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-contacts-api-linkedin-leads-generator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/contacts-api~linkedin-leads-generator/runs": { "post": { "operationId": "runs-sync-contacts-api-linkedin-leads-generator", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/contacts-api~linkedin-leads-generator/run-sync": { "post": { "operationId": "run-sync-contacts-api-linkedin-leads-generator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "keywords" ], "properties": { "keywords": { "title": "Search Keywords", "minItems": 1, "uniqueItems": true, "type": "array", "description": "List of keywords to search for LinkedIn profiles (e.g., 'software engineer', 'marketing manager').", "items": { "type": "string" } }, "country": { "title": "Target Country", "enum": [ "United States", "United Kingdom", "Canada", "Australia", "India", "Germany", "France", "Spain", "Italy", "Brazil", "Mexico", "Japan", "South Korea", "China", "Singapore", "United Arab Emirates", "Netherlands", "Sweden", "Norway", "Denmark", "Switzerland", "Belgium", "Austria", "Ireland", "New Zealand", "South Africa" ], "type": "string", "description": "Select the target country for leads.", "default": "United States" }, "maxLeadsPerKeyword": { "title": "Max Leads Per Keyword", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of leads to collect for each keyword. Free users are capped at 100 emails total per run.", "default": 20 }, "scrapeLeadsWithEmail": { "title": "Only Leads with Email", "type": "boolean", "description": "If enabled, only returns profiles that have a public email address.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```