Search LinkedIn People

Find professionals on LinkedIn by name, title, company, location, industry, and more. Returns structured profile data including name, headline, current positions, connection degree, profile picture, plus 2026-06-03 enrichments: nameMatch (true when the result matched on literal name — strong personhood signal), badgeText (Top Voice / Premium / Verified / Influencer — qualifier weight), ringStatus (OPEN_TO_WORK / HIRING — open intent signals you can directly target), summary (additional snippet beyond headline), actorInsights (LinkedIn-curated context like 'X mutual connections', 'Follows {company}' — use directly in personalised outreach openers).

Parameters

keywords (optional): Search terms matched against name, headline, company, skills, and bio
You can search by filters alone (no keywords) — e.g. find all 2nd-degree connections in Paris

Keyword syntax (Boolean operators)

Keywords support LinkedIn Boolean search syntax:

Exact phrase: "product manager" — matches only that exact title
AND: engineer AND startup — both terms required (spaces default to AND)
OR: CEO OR founder OR CTO — any of the terms
NOT: manager NOT assistant — exclude unwanted terms
Parentheses: (CEO OR CTO) AND SaaS — group logic

Operators must be UPPERCASE. Precedence: Quotes > Parentheses > NOT > AND > OR.

Available filters

Pass HUMAN LABELS for location / industry / currentCompany / pastCompany / school — the server resolves them to LinkedIn IDs via typeahead. Numeric IDs pass through unchanged if you already have them.

Filter	Type	Description
connectionDegree	["F"\|"S"\|"O"]	Connection level: F=1st, S=2nd, O=3rd+
firstName	string	Exact first name match
lastName	string	Exact last name match
title	string	Current job title (supports \| OR syntax: "CEO\|CTO")
connectionOf	string	Profile URN — find their connections
followersOf	string[]	Profile URNs — find a creator's followers
openToVolunteering	boolean	Only people open to volunteering
serviceCategories	string[]	Service-Marketplace category names
profileLanguage	string[]	ISO 639-1 codes: ["en","fr"]
location	string[]	Geo labels (e.g. ["Paris","France"]) — resolved server-side
industry	string[]	Industry labels (e.g. ["Software Development"]) — resolved server-side
currentCompany	string[]	Company labels (e.g. ["Stripe","Datadog"]) — resolved server-side
pastCompany	string[]	Company labels — resolved server-side
school	string[]	School/university labels — resolved server-side

Response fields (per item)

Field	Type	Description
name	string	Full display name
profileUrl	string	LinkedIn profile URL
headline	string\|null	Professional headline
location	string\|null	Geographic location
profilePicture	string\|null	Profile photo URL
networkDistance	string\|null	DISTANCE_1, DISTANCE_2, DISTANCE_3, or OUT_OF_NETWORK
currentPositions	array	Current job positions with company and role

Pagination

Default page size: 10, max: 50
Use start + count to paginate. Check hasMore for more pages.
Paginate via start + count; check hasMore for more pages.

Example workflows

Prospect list building: Search by title + location + industry → build a targeted outreach list
Recruiting: Search by title + company + school → find people who match
Network mapping: Search connectionOf + filters → explore someone's network

Workflow — pass labels directly

POST /search/linkedin/people {
  keywords: 'product manager',
  location: ['San Francisco'],
  currentCompany: ['Google']
}
→ server resolves labels → matching people

Only call /search/linkedin/parameters when you need to EXPLORE available values ("what are the canonical industry buckets?"), never as a prerequisite to a search.

Credits

post/search/linkedin/people

Request body

keywordsstring

Search keywords. Matches against name, headline, company, skills, and bio. Optional — you can search by filters alone (e.g. all 2nd-degree connections in Paris). Supports LinkedIn Boolean syntax: use double quotes for exact phrases (e.g. "product manager"), AND to require both terms, OR for alternatives (e.g. CEO OR founder OR CTO), NOT to exclude (e.g. manager NOT assistant), and parentheses to group (e.g. (CEO OR CTO) AND SaaS). Operators must be UPPERCASE.

urlstring

A LinkedIn search URL. The category and every filter the vertical can actually apply are read from it; a facet it carries that this search cannot apply is reported back as a URL_FACET warning rather than applied, so a result set carrying those is WIDER than the URL asked for. Explicit params override anything read from the URL.

maxSearchesinteger

Spend up to this many LinkedIn searches on one ask, cutting it along independent angles so the result reaches people a single search cannot. One search returns about ten people; the angles do not overlap much, so the total grows close to linearly with what you spend. Leave it out to run exactly one search.

connectionDegreestring[]

Filter by connection degree. 'F' = 1st degree (your direct connections), 'S' = 2nd degree (connections of connections), 'O' = 3rd+ degree and out of network. Accepts multiple values, e.g. ['F','S'] for 1st and 2nd degree.

firstNamestring

Filter by first name. Exact match (case-insensitive).

lastNamestring

Filter by last name. Exact match (case-insensitive).

titlestring

Filter by current job title. Matches against the person's current position title. Supports LinkedIn Boolean OR: 'CEO OR CTO OR Founder'. Pipe separators are auto-converted: 'CEO|CTO|Founder' becomes 'CEO OR CTO OR Founder'. Use double quotes for exact multi-word titles: '"Head of Marketing" OR "VP Sales"'.

connectionOfstring

Find connections of a specific person. Pass the person's LinkedIn profile URN (e.g. 'urn:li:fsd_profile:ACoAABZ0Qo4B...'). Returns people who are connected to this person.

profileLanguagestring[]

Filter by LinkedIn profile language. Array of ISO 639-1 codes (e.g. ['en','fr']); the server resolves any code.

schoolstring[]

Filter by school/university. Pass human names (e.g. ['Harvard','Stanford']) — server resolves to LinkedIn IDs via typeahead. Numeric IDs pass through if you already have them.

locationstring[]

Filter by geographic location. Pass human names (e.g. ['Paris','France']) — server resolves to LinkedIn geo IDs via typeahead. Numeric IDs pass through if you already have them.

industrystring[]

Filter by industry. Pass human names (e.g. ['Software Development','Marketing']) — server resolves to LinkedIn industry IDs via typeahead. Numeric IDs pass through if you already have them.

currentCompanystring[]

Filter by current employer. Pass company names (e.g. ['Stripe','Datadog']) — server resolves to LinkedIn company IDs via typeahead. Numeric IDs pass through if you already have them.

pastCompanystring[]

Filter by past employer. Pass company names — server resolves to LinkedIn company IDs via typeahead. Numeric IDs pass through if you already have them. Finds people who previously worked at these companies.

followersOfstring[]

Find people who follow a specific creator/thought-leader. Array of LinkedIn profile URNs (e.g. 'urn:li:fsd_profile:ACoAAB...'). A warm-discovery vector: the audience of an influential voice in your space. Get URNs from a prior search_people / visit_profile result.

openToVolunteeringboolean

When true, only return people who marked themselves open to volunteering.

serviceCategoriesstring[]

Filter by LinkedIn Service-Marketplace category — for finding freelancers/consultants. Pass category NAMES (e.g. ['Digital Marketing','Web Development','Management Consulting']) — resolved to IDs server-side.

verifiedOnlyboolean

Only people whose identity LinkedIn has verified. Reaches a different set rather than a smaller one: measured, it kept about half the unfiltered results and replaced the rest.

schoolFreetextstring

School as free text, matched on the name rather than an id. Use this when you know what the school is called but not its LinkedIn id; use school when you have the id.

companyHQstring[]

Location of the company HEADQUARTERS (geo labels or ids), which is a different question from where the person is. A rep in Paris at a Berlin-headquartered firm matches one and not the other. Labels resolve via typeahead.

companySizestring[]

Company size on the PEOPLE search (employer headcount). Pass a human employee range and it is converted for you: A=1, B=2-10, C=11-50, D=51-200, E=201-500, F=501-1000, G=1001-5000, H=5001-10000, I=10001+.

startinteger

Pagination offset into the accumulated result list (default 0). LinkedIn serves about ten people per HTML page; use multiples of that page size to skip whole pages.

countinteger

How many people to return in total (default 10, max 50). LinkedIn's HTML search page is fixed at about ten results; the server pages with ?page=N until this total is reached.

Response

List of LinkedIn people matching the search criteria

successtrue required

category'people' required

hasMoreboolean required

creditsUsedinteger required

Credits consumed by this call. 0 for free endpoints, cached results, duplicates, and for every query that does not touch LinkedIn.

retryAfterinteger required

Seconds to wait before another call of the same type. 0 means no wait is needed.

Changes

Changed in 4 of the 12 revisions of this API.1118

Aug 28, 202662bf7284843d1See the full diff
- ▲
  removed the required property _meta/credits/accountPlan from the response with the 200 status
  response-required-property-removed
Aug 27, 2026d5f1141f87e3115See the full diff
- ●
  added the new pacing enum value to the error/quotaKind response property for the response status 400
  response-property-enum-value-added
- ●
  added the new pacing enum value to the error/quotaKind response property for the response status 401
  response-property-enum-value-added
- ●
  added the new pacing enum value to the error/quotaKind response property for the response status 403
  response-property-enum-value-added
- ●
  added the new pacing enum value to the error/quotaKind response property for the response status 404
  response-property-enum-value-added
- ●
  added the new pacing enum value to the error/quotaKind response property for the response status 409
  response-property-enum-value-added
- ●
  added the new pacing enum value to the error/quotaKind response property for the response status 410
  response-property-enum-value-added
- ●
  added the new pacing enum value to the error/quotaKind response property for the response status 422
  response-property-enum-value-added
- ●
  added the new pacing enum value to the error/quotaKind response property for the response status 429
  response-property-enum-value-added
- ●
  added the new pacing enum value to the error/quotaKind response property for the response status 500
  response-property-enum-value-added
- ●
  added the new pacing enum value to the error/quotaKind response property for the response status 502
  response-property-enum-value-added
- ●
  added the new pacing enum value to the error/quotaKind response property for the response status 503
  response-property-enum-value-added
- ○
  added the new optional request property companyHQ
  new-optional-request-property
- ○
  added the new optional request property companySize
  new-optional-request-property
- ○
  added the new optional request property schoolFreetext
  new-optional-request-property
- ○
  added the new optional request property verifiedOnly
  new-optional-request-property
- ○
  added the optional property items/items/lane to the response with the 200 status
  response-optional-property-added
Aug 20, 2026a1e86af2406d1See the full diff
- ○
  added the optional property warnings to the response with the 200 status
  response-optional-property-added
Aug 19, 20261ad91026000b2See the full diff
- ○
  added the new optional request property maxSearches
  new-optional-request-property
- ○
  added the optional property _meta to the response with the 200 status
  response-optional-property-added

Of the 12 revisions, 1 has no diff computed.

Full history