LinkedIn Recruiter Pro V2

Version: 1.0 — Apify Actor for finding LinkedIn candidate profiles via public search. Price: $0.05/profile (Pay Per Event — PPE)

---

Overview

LinkedIn Recruiter Pro finds publicly available LinkedIn profiles using Google search and LinkedIn's public directory endpoints, enriches them with estimated email addresses (with optional external verification), and scores candidates against a job description using algorithmic keyword matching ("AI fit scoring").

⚠️ IMPORTANT — WHAT THIS ACTOR DOES AND DOES NOT DO

• This tool only accesses publicly available data via search engines and public LinkedIn directory endpoints.
• No login, authentication bypass, or API abuse is performed.
• Profile data (work history, education, skills) is extracted from search result snippets only — not from individual LinkedIn profile pages. This means workHistory, education, and detailed skills arrays will be empty unless the user provides a skills filter in the input.
• Email addresses are ESTIMATED using common corporate patterns and are NOT verified unless verifyEmail: true is set with a valid emailVerificationApiKey.
• The "AI fit score" is an algorithmic keyword overlap estimate, not human judgment. It should not be used as the sole basis for hiring decisions.
• Users must comply with applicable laws, LinkedIn's Terms of Service, and data protection regulations (GDPR, CCPA, etc.).
• Intended for legitimate recruiting purposes only.

---

Features

Feature	Description
Multiple Search Modes	Google dorking (default), direct LinkedIn public search, company employee lookup
Apify Proxy Integration	Automatic proxy rotation to reduce CAPTCHA blocking
CAPTCHA Detection	Detects Google CAPTCHA challenges and logs clear warnings
Error Boundaries	Per-query and per-profile error handling — one failure doesn't crash the whole run
URL Deduplication	Same profile across multiple queries is only saved once
Email Enrichment	Pattern-based email estimation with confidence scoring
Email Verification	Optional external API verification (flags: verified / unverified / estimated)
AI Fit Scoring	TF-IDF style keyword overlap scoring against a job description (0-100)
Bulk Export	CSV, JSON, and JSONL output formats
Rate Limiting	Configurable delay, User-Agent rotation
Profile Data	Name, headline, location, company (from search input/snippet)

---

Input Parameters

Parameter	Type	Default	Description
searchQueries	string[]	required	List of search strings (e.g., ["Senior Software Engineer"])
jobTitle	string	—	Filter by job title
location	string	—	Filter by location
company	string	—	Filter by company
skills	string	—	Comma-separated skills filter
jobDescription	string	—	Job description text for fit scoring
maxResults	number	25	Max profiles (1–1000)
enrichEmail	boolean	true	Estimate email addresses
verifyEmail	boolean	false	Verify emails via AbstractAPI or Disify
emailVerificationApiKey	string	—	Your AbstractAPI key for email verification (optional, without it falls back to Disify free API)
searchMode	string	googleDork	googleDork, directSearch, or companyEmployees
delayBetweenRequests	number	2	Seconds between HTTP requests
outputFormat	string	json	json, csv, or jsonl

---

Search Modes

googleDork (default)

Uses Google search with site:linkedin.com/in/ queries to find public LinkedIn profiles. Works without any LinkedIn access. Uses Apify proxy for improved reliability.

directSearch

Searches LinkedIn's public directory endpoints (linkedin.com/pub/dir/). Limited but useful for well-known names.

companyEmployees

Uses Google dorking to find employees of a specific company: site:linkedin.com/in/ "at {CompanyName}"

---

Output Fields

Each profile record contains:

Field	Type	Description
name	string	Full name extracted from profile URL
firstName	string	First name
lastName	string	Last name
headline	string	Profile headline / search query
location	string	Location from search filter
currentCompany	string	Current employer (from search filter or snippet)
currentTitle	string	Current job title
website	string	LinkedIn profile URL
url	string	LinkedIn profile URL
estimatedEmail	string	Best-estimated email address
emailConfidence	string	high, medium, low, or null
emailStatus	string	verified, unverified, estimated, or none
fitScore	number	Algorithmic fit score (0–100) against job description
searchQuery	string	The search query that found this profile
extractedAt	string	ISO timestamp when processed

Note: workHistory and education arrays are present in the output schema but will be empty — this actor does not scrape individual LinkedIn profile pages. Those fields are reserved for future enhancement.

---

Pricing

• Model: Pay Per Event (PPE)
• Price: $0.05 per profile result
• What counts as an event: Each profile that is found, enriched, and saved to the dataset counts as one event.
• What does NOT count: Metadata, errors, retries, and empty results.

---

Data Accuracy

• Names & URLs are extracted from search result snippets — accuracy depends on search engine indexing.
• Email addresses are estimated using common corporate patterns (firstname.lastname@company.com, etc.) and must be independently verified before use.
• Fit scores are algorithmic keyword overlap estimates — not human judgment or AI reasoning.
• Work history, education, and skills are NOT scraped from individual profile pages. Skills will only be populated if provided via the skills input parameter.
• This tool does not access LinkedIn's private API or any authenticated LinkedIn data.

---

Changelog

See ./CHANGELOG.md for version history.