LinkedIn People Finder by Role, Seniority & Network

Search LinkedIn people search with your own session — well beyond a plain keyword box. Combine free-text search with structured filters for company, school, seniority, job function, years of experience, company size, industry, and more, and get back one row per matching profile.

What this actor does

• Runs a LinkedIn people search using your own session cookie, combining a free-text query with any number of structured filters
• Passes structured filters to LinkedIn: company, school and location IDs, industry, job function, seniority level, years of experience, employer headcount, connection degree, profile language and "open to" status
• Adds free-text values (a location name, company or school names, a topic, first/last name and job title) to the search keywords, so they narrow results the way typing them into LinkedIn's search box would
• Can narrow to people who follow a given company or are connections of a specific member, using their numeric IDs or URNs
• Flags when a result card shows an "Open to Work" or Premium marker or a verified indicator
• Fields LinkedIn doesn't expose for a given profile (for example a profile picture or mutual-connections count) are left off that record

Output per profile

• name — the person's full name
• profileUrl — their canonical LinkedIn profile URL
• headline — their LinkedIn headline, as written
• location — the location shown on their profile
• connectionDegree — their connection degree to your account (1st, 2nd, 3rd+), when LinkedIn shows one
• currentCompany — their current employer as {name}, plus slug and url when LinkedIn supplies a structured company link; usually derived from a headline such as "Engineer at Acme"
• currentTitle — their current job title, usually the part of the headline before "at …"
• industryName — the industry LinkedIn associates with the profile, when available
• educationCount — how many education entries appear on their profile, when greater than zero
• openToWork — true when the result shows an "Open to Work" marker (omitted otherwise)
• premium, premiumStatus — true when the result shows a Premium marker (omitted otherwise)
• verifiedStatus — true when the result card carries a verified indicator (omitted otherwise)
• profilePicture, profileImageUrl — the profile photo URL, when visible to your account
• mutualConnections — the mutual-connections text LinkedIn shows for that profile, when available
• scrapedAt — when the actor fetched the record

industryName and educationCount only come through on some result layouts, so many rows won't have them.

Cookie notice row

If the cookie input is empty, or LinkedIn reports the session as expired or invalid, the run doesn't fail. Instead the dataset gets a single notice row with _status: "no_data", _reason (cookie-missing or cookie-invalid), _message, _help (how to export a fresh cookie) and scrapedAt, and no profiles. A cookie value that can't be parsed at all fails the run.

Input

Field	Type	Default	Description
searchQuery	string	–	Free-text search keywords. Required.
keywords	string	–	Extra keywords combined with searchQuery with a space; handy for adding modifiers without editing your main query.
cookie	string	–	Your LinkedIn session cookie — either the li_at value or a full cookie JSON export. Required.
location	string	–	Free-text location, e.g. San Francisco Bay Area; added to the search keywords. Use geoUrn for a strict location filter.
geoUrn	string	–	A LinkedIn geo URN or numeric geo ID (e.g. 103644278 for the United States) for a strict location filter.
currentCompany	string	–	Current employer, by name or LinkedIn company URN/ID. A URN applies a strict structured filter; a plain name is added to the search keywords.
pastCompany	string	–	Past employer, by name or LinkedIn company URN/ID. Works like currentCompany: an ID applies the filter, a name is added to the keywords.
school	string	–	School or university attended. A school URN/ID applies the school filter; a name is added to the keywords.
firstNameKeyword	string	–	First name; sent as a first-name filter and added to the keywords.
lastNameKeyword	string	–	Last name; sent as a last-name filter and added to the keywords.
titleKeyword	string	–	Job title text, e.g. Director of Engineering; sent as a title filter and added to the keywords.
serviceCategory	string	–	LinkedIn Services Marketplace category, e.g. Web Development; sent as a filter and added to the keywords.
companyHeadcount	array	–	Employer size bucket(s), from self-employed up to 10,001+ employees.
followerOf	string	–	Restrict to people who follow a given company. Needs a company URN or numeric ID; a plain name is ignored.
connectionDegree	string	"" (any)	F (1st degree), S (2nd degree), or O (3rd+ degree).
industry	string	"" (any)	One of 13 industries, e.g. Software Development, Healthcare.
seniorityLevel	string	"" (any)	Entry level, Associate, Mid-Senior level, Director, or Executive.
yearsOfExperience	string	"" (any)	Total professional experience bucket, from less than 1 year up to 16+ years.
jobFunction	string	"" (any)	Department/function, e.g. ENGINEERING, SALES, MARKETING.
openTo	array	–	What the person has flagged as open to: HIRING, GETTING_HIRED, PROVIDING_SERVICES, JOINING_A_NONPROFIT.
profileLanguages	array	–	ISO 639-1 language code(s) the profile is written in, e.g. ["en", "es"].
contactOf	string	–	Restrict to connections of a specific LinkedIn member (member URN or numeric profile ID).
talksAbout	string	–	A keyword/topic to look for on the person's profile; appended to the search keywords.
maxResults	integer	25	Maximum profiles to return (1–100).
proxyConfiguration	object	–	Optional Apify proxy configuration.

Example: role + company + connection degree

{
  "searchQuery": "product manager",
  "cookie": "YOUR_LI_AT_COOKIE",
  "currentCompany": "Airbnb",
  "connectionDegree": "F",
  "maxResults": 25
}

Example: senior engineers by function, seniority, and company size

{
  "searchQuery": "engineering",
  "cookie": "YOUR_LI_AT_COOKIE",
  "jobFunction": "ENGINEERING",
  "seniorityLevel": "Director",
  "companyHeadcount": ["G", "H", "I"],
  "maxResults": 50
}

Example: people open to freelance work in a given industry

{
  "searchQuery": "brand designer",
  "cookie": "YOUR_LI_AT_COOKIE",
  "industry": "Marketing and Advertising",
  "openTo": ["PROVIDING_SERVICES"],
  "maxResults": 30
}

Use cases

• Recruiting and sourcing — build a candidate shortlist filtered by seniority, function, and years of experience
• Sales prospecting — find decision-makers at companies of a specific size and industry
• Talent mapping — see how many people with a given title work at a target company or came from a specific school
• Freelance/agency hiring — search for people who've flagged themselves as PROVIDING_SERVICES in a niche
• Alumni and network outreach — find people from a specific school or who follow your company page

FAQ

Why does this actor need a LinkedIn cookie? People search is only available to logged-in LinkedIn users, so a valid session cookie (li_at or a full cookie export) is required. Without one, or with an expired one, the run returns only the cookie notice row described above.

Will my results match what I'd see searching manually? Closely, but not identically — LinkedIn personalizes search results based on your account's own network, location, and plan, so the same query can return different people from different accounts.

What's the difference between currentCompany as a name versus a URN? A company URN or numeric ID applies LinkedIn's strict structured company filter. A plain company name is instead folded into the free-text search keywords, which is usually accurate for well-known company names but less exact than a URN.

Why is connectionDegree sometimes missing from a result? LinkedIn only shows a connection-degree badge for profiles it places in your visible network graph; some results simply don't carry one.

Why don't all profiles have a profilePicture? Some LinkedIn users restrict their photo to connections only; the actor returns the picture URL only when the search response actually includes one.

Can I combine many filters at once? Yes — every filter is sent with the same search, and the more you combine, the narrower (and often smaller) the result set. LinkedIn decides how strictly each filter is honoured for your account, so spot-check results when you stack many of them.

How many profiles can I get per run? Up to maxResults, capped at 100 per run.

Is this affiliated with LinkedIn? No. This is an independent, third-party actor that uses your own LinkedIn session to run a people search; it is not affiliated with or endorsed by LinkedIn.