LinkedIn Scraper

Search LinkedIn in four bounded modes:

• jobs uses LinkedIn's public guest jobs HTML and does not require a login.
• companies, people, and posts use an authorized li_at cookie supplied through the secret input field. The cookie is applied before navigation and is never logged or stored.

The Actor stores only usable, canonical LinkedIn records in the default dataset. Invalid inputs, authentication walls, verification challenges, request failures, and zero-result failures are reported in the OUTPUT key rather than as billable result rows.

Input

Field	Required	Default	Notes
query	yes	—	1–200 printable characters
searchMode	yes	jobs	jobs, companies, people, or posts
location	no	United States	Applied to jobs mode
maxItems	no	50	Integer from 1 to 500
datePosted	no	anyTime	Jobs filter: anyTime, pastMonth, pastWeek, past24Hours
jobType	no	any	Jobs filter: F, P, C, T, or I
scrapeDetails	no	true	In jobs mode, attempts public description enrichment
linkedinCookie	protected modes	—	Secret li_at value for a LinkedIn account you are authorized to use
proxyConfiguration	no	direct	Optional Apify proxy configuration

Cookie-authorized modes are intentionally rejected before navigation if no cookie is provided. Users are responsible for complying with LinkedIn's terms, applicable law, and account permissions.

Output

Every dataset row is a unique usable result with explicit success semantics:

• recordType, found, dataAvailable, and error
• position, type, title, canonical url
• optional visible subtitle, location, description, imageUrl, and null-free metadata
• searchQuery, searchMode, sourceUrl, sourceDomain, page, and scrapedAt
• detailAvailable when public job enrichment was requested

OUTPUT contains a run summary or a bounded diagnostic. The Actor does not solve CAPTCHAs, alter browser fingerprints, rotate user agents, bypass login controls, or fabricate missing values.

Example

{
  "query": "software engineer",
  "searchMode": "jobs",
  "location": "United States",
  "datePosted": "pastWeek",
  "maxItems": 10,
  "scrapeDetails": false
}

Development

npm ci
npm test
apify run --purge --input-file qa-inputs/local-public.json
npm run validate