# Linkedin Profile Finder (`scrapers-hub/linkedin-profile-finder`) Actor 🔍 LinkedIn Profile Finder helps you discover and verify targeted LinkedIn profiles fast. 🚀 Great for B2B prospecting, recruiting, and market research—find the right people with speed, accuracy, and efficiency. - **URL**: https://apify.com/scrapers-hub/linkedin-profile-finder.md - **Developed by:** [Scrapers Hub](https://apify.com/scrapers-hub) (community) - **Categories:** Lead generation, Jobs, Automation - **Stats:** 9 total users, 6 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.01 / 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/platform/actors/running/actors-in-store#pay-per-event ## 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 Profile Finder 🔍 **LinkedIn Profile Finder** is a lead discovery tool that helps you find thousands of **LinkedIn profile search** results based on your **keywords**, with optional **country targeting**—without needing to log in. Whether you’re a marketer, recruiter, sales lead, or data analyst looking to **find LinkedIn profiles**, this LinkedIn people finder streamlines profile lookup at scale and saves you hours of manual work. It’s designed for workflows like **LinkedIn lead finder** prospecting, **LinkedIn contact finder** research, and **LinkedIn profile lookup** when you need a large starting set fast. --- ### Why choose LinkedIn Profile Finder? | Feature | Benefit | |---|---| | ✅ **Keyword-based profile discovery** | Start from your search keywords to discover relevant LinkedIn profiles in bulk. | | ✅ **Country targeting support** | Focus results on your selected target country for better lead relevance. | | ✅ **Reliability with retries** | Includes retry logic to improve result consistency across pages. | | ✅ **Clear structured dataset output** | Saves results in a structured dataset you can export and analyze. | | ✅ **Scales across multiple keywords** | Run multi-keyword searches and keep collecting until limits are reached. | | ✅ **Built-in proxy support for reliable scraping** | Uses proxy configuration support to improve access consistency. | --- ### Key features - 🔑 **Keyword-led LinkedIn profile search**: Use your keywords to drive discovery for a “find LinkedIn profiles” workflow. - 🌍 **Target country filtering**: Filter results by your chosen **Target Country** to support “search LinkedIn by name and location” use cases. - 🧩 **Profile URL validation**: Ensures the collected URLs match LinkedIn profile pages (not company pages, jobs, posts, or other non-profile paths). - 📄 **Snippet capture for context**: Collects a `description_snippet` to help you quickly triage results. - 💾 **Dataset-ready results**: Each run pushes items to the Apify dataset with fields like `keyword`, `url`, `description_snippet`, and `source`. - 🛡️ **Resilience and fallbacks**: Uses retry logic and optional proxy configuration to keep runs moving. - 🔄 **Multi-page collection per keyword**: Continues through pages until reaching your global limit or stopping conditions. - ⚙️ **Free-tier run limiting**: Automatically caps results to keep behavior predictable on the free tier. --- ### Input Provide input via an `input.json` file. Example structure: ```json { "keywords": ["software engineer", "marketing manager"], "country": "United States" } ```` #### Input Fields | Field | Required | Description | |---|---:|---| | `keywords` | Yes | A list of keywords to search for LinkedIn profiles (for example, “software engineer” or “marketing manager”). Each keyword will be processed to discover profiles. | | `country` | No | Select the target country for leads. Defaults to `United States`. Use this when you want your LinkedIn people finder results to be location-focused. | *** ### Output After execution, the actor saves each profile’s data in JSON format in the dataset. Example dataset records: ```json [ { "keyword": "software engineer", "url": "https://www.linkedin.com/in/example-user", "description_snippet": "Example snippet text from the search results description", "source": "Search Engine" } ] ``` #### Output Fields | Field | Type | Description | |---|---|---| | `keyword` | string | The keyword that produced this LinkedIn profile result. | | `url` | string | The discovered LinkedIn profile URL. | | `description_snippet` | string | A short text snippet describing the result (useful for quick review). | | `source` | string | Where the profile data was collected from (set to `"Search Engine"`). | > Note: This actor’s dataset transformation (in the `LinkedIn Profiles` dataset view) is configured to display only: `keyword`, `url`, `description_snippet`, and `source`. You can export the dataset as JSON or CSV from the Apify Console. *** ### How to use LinkedIn Profile Finder (via Apify Console) 1. **Open Apify Console**\ Log in at https://console.apify.com and go to the **Actors** tab. 2. **Find LinkedIn Profile Finder**\ Search for **LinkedIn Profile Finder** and open the actor page. 3. **Go to the INPUT panel**\ You’ll see a built-in form for configuring your keywords and country. 4. **Enter your keywords**\ Add one or more items in **Search Keywords** (e.g., “software engineer”, “marketing manager”).\ This powers the “find LinkedIn profiles” workflow. 5. **(Optional) Set the target country**\ Choose your **Target Country**. If you leave it as default, it uses `United States`. 6. **Run the actor**\ Click **Run**. During execution, you’ll see logs indicating progress per keyword and totals collected. 7. **Review results in the dataset**\ When it finishes, open the actor’s **OUTPUT** dataset named **LinkedIn Profiles** and review the table: Keyword, Profile URL, Snippet, and Source. 8. **Export for your workflow**\ Export the dataset (JSON/CSV) and connect it to your CRM, lead pipeline, enrichment workflow, or analysis notebook. No coding required—get accurate results in minutes with **LinkedIn Profile Finder**. ✅ *** ### Advanced features & SEO optimization - 🚀 **Engineered for “LinkedIn lead finder” workflows**: Built for keyword-driven LinkedIn profile search tool use cases like prospect discovery and early-stage lead lists. - 🔍 **LinkedIn profile lookup with validation**: Only keeps URLs that look like profile links (via URL structure checks), helping you avoid jobs, posts, and company pages. - 🔁 **Resilience for better batch completion**: Includes retry logic and uses stop conditions to end searches when pages return empty results repeatedly. - 💬 **Context-first snippets**: Captures a `description_snippet` so you can quickly triage leads before deeper enrichment. - 🌐 **Country-focused discovery**: Works well for “search LinkedIn by name and location” and “company LinkedIn employee search” style targeting. *** ### Best use cases - 📈 **Sales teams building outbound lists**: Use LinkedIn profile lookup results as a starting dataset for outreach segmentation. - 🧑‍💼 **Recruiters sourcing candidates**: Quickly find LinkedIn profiles by role-related keywords to accelerate screening. - 🎯 **B2B marketers running lead gen**: Generate a prospect pool using LinkedIn people finder patterns by keyword and country. - 🏢 **Company research teams**: Build lead-ready lists for “company LinkedIn employee search” research efforts. - 🔎 **Data analysts preparing enrichment pipelines**: Collect structured profile URLs and snippets for downstream analysis and mapping. - 🧩 **Growth teams testing messaging**: Use a profile dataset to validate audience positioning by niche and geography. - 💬 **Community or talent sourcing**: Find relevant profiles using keywords to support community and talent discovery research. *** ### Technical specifications - **Supported Input Formats** - ✅ `keywords` as an array of strings (minimum 1 item, unique items) - ✅ `country` as a string from the provided enum (defaults to `United States`) - **Proxy Support** - ✅ Uses proxy configuration support (with fallback behavior if proxy setup fails) - **Retry Mechanism** - ✅ Retries are implemented (configured with `max_retries = 3`) - **Dataset Structure** - ✅ Saved as dataset records with fields: `keyword`, `url`, `description_snippet`, `source` - **Rate Limits & Performance** - ✅ Uses a built-in per-page delay (`request_delay = 1` plus a small random component) - **Limitations** - ❌ This actor does not require LinkedIn login to run (it focuses on publicly available profile discovery) - ❌ Results are capped on the free tier: **100 profiles per run** (free tier detection is via the `APIFY_IS_PAID_USER` environment variable) *** ### FAQ #### Does LinkedIn Profile Finder require a LinkedIn login? ✅ No. LinkedIn Profile Finder is described as requiring **no login**, focusing on discovering publicly available LinkedIn profiles. #### What kinds of LinkedIn pages does it return? ✅ It targets LinkedIn profile URLs. It filters out URLs that are not profile pages (for example, company pages, jobs, posts, and other non-profile paths). #### How do I choose keywords for best results? Use role- or intent-based phrases that match what you want to find (for example, “software engineer” or “marketing manager”). This aligns with the “LinkedIn profile search tool” style workflow. #### Can I limit results to a specific country? ✅ Yes. Set the `country` input to one of the allowed values. The actor uses this to apply country targeting for your LinkedIn profile lookup. #### What data is saved in the output dataset? ✅ Each record includes `keyword`, `url`, `description_snippet`, and `source` (set to `"Search Engine"`). This structured output helps with quick review and downstream processing. #### How many results can I collect? The actor applies run limits depending on the account tier: on the free tier, results are capped at **100 profiles per run**. On paid tiers, the code sets `global_max_leads = 999999` and indicates that no hard limits are enforced. #### Can I use the output in other tools like a CRM? ✅ Yes. Since the actor saves structured JSON dataset records, you can export the dataset (JSON/CSV) and import it into your CRM, spreadsheets, or analysis tools. #### Is the extracted data legal to use for outreach? ✅ LinkedIn Profile Finder collects information from **publicly available sources**. You are responsible for ensuring your use complies with applicable laws and platform policies (including GDPR/CCPA considerations and outreach/spam regulations). *** ### Support & feature requests Got questions about **LinkedIn Profile Finder** or want to suggest improvements? We’d love to hear from you. 💬 - 💡 **Feature Requests**: Examples include adding more fields to the dataset, improving filtering options, or enhancing export formats for easier CRM import. - 📧 **Contact**: Email . Your feedback helps shape what we build next for **LinkedIn profile search tool** workflows. *** ### Closing CTA / Final thoughts *If you need an SEO-optimized way to search public LinkedIn profiles by keyword and country, **LinkedIn Profile Finder** is built for exactly that—fast, structured, and ready for scale.* 🔥 ### Disclaimer This tool accesses **publicly accessible sources** only. It does not access private profiles, authenticated data, or password-protected pages. You are responsible for complying with applicable laws and regulations (including GDPR/CCPA), as well as respecting platform terms of service and any relevant outreach/spam rules. For data removal requests, contact . Please use this tool responsibly, ethically, and for legitimate purposes only. # 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. ## Actor input object example ```json { "keywords": [ "software engineer", "marketing manager" ], "country": "United States" } ``` # 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" }; // Run the Actor and wait for it to finish const run = await client.actor("scrapers-hub/linkedin-profile-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": [ "software engineer", "marketing manager", ], "country": "United States", } # Run the Actor and wait for it to finish run = client.actor("scrapers-hub/linkedin-profile-finder").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" }' | apify call scrapers-hub/linkedin-profile-finder --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapers-hub/linkedin-profile-finder", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Linkedin Profile Finder", "description": "🔍 LinkedIn Profile Finder helps you discover and verify targeted LinkedIn profiles fast. 🚀 Great for B2B prospecting, recruiting, and market research—find the right people with speed, accuracy, and efficiency.", "version": "1.0", "x-build-id": "ekxbhMiF11MmDA4Pt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers-hub~linkedin-profile-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers-hub-linkedin-profile-finder", "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/scrapers-hub~linkedin-profile-finder/runs": { "post": { "operationId": "runs-sync-scrapers-hub-linkedin-profile-finder", "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/scrapers-hub~linkedin-profile-finder/run-sync": { "post": { "operationId": "run-sync-scrapers-hub-linkedin-profile-finder", "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" } } }, "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 } } } } } } } } } } ```