v2

latestOpenAPI 3.0.3AGPL-3.0 license2026-07-2613501.9 MB

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 qualified candidates
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

Optional LinkedIn search URL. If provided, keywords and filters are extracted from the URL. Explicit params override URL-derived values.

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.

startinteger

Pagination offset (default 0). Use multiples of count to page through results.

countinteger

Results per page (default 10, max 50).

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, or duplicates).

retryAfterinteger required

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