search

Search LinkedIn People

Changed on

Search LinkedIn People

Find professionals by name, title, company, location, industry, and more. Returns structured profile data including name, headline, current positions, connection degree, profile picture, plus: nameMatch (true when the result matched on the literal name), badgeText (Top Voice / Premium / Verified / Influencer), ringStatus (OPEN_TO_WORK / HIRING: open intent signals you can directly target), summary (additional snippet beyond headline), actorInsights (short context lines such as 'X mutual connections' or 'Follows {company}': use them directly in personalised 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.

FilterTypeDescription
connectionDegree["F"|"S"|"O"]Connection level: F=1st, S=2nd, O=3rd+
firstNamestringExact first name match
lastNamestringExact last name match
titlestringCurrent job title (supports | OR syntax: "CEO|CTO")
connectionOfstringProfile URN: find their connections
followersOfstring[]Profile URNs: find a creator's followers
openToVolunteeringbooleanOnly people open to volunteering
serviceCategoriesstring[]Service-Marketplace category names
profileLanguagestring[]ISO 639-1 codes: ["en","fr"]
locationstring[]Geo labels (e.g. ["Paris","France"]): resolved server-side
industrystring[]Industry labels (e.g. ["Software Development"]): resolved server-side
currentCompanystring[]Company labels (e.g. ["Stripe","Datadog"]): resolved server-side
pastCompanystring[]Company labels: resolved server-side
schoolstring[]School/university labels: resolved server-side

Response fields (per item)

FieldTypeDescription
namestringFull display name
profileUrlstringLinkedIn profile URL
headlinestring|nullProfessional headline
locationstring|nullGeographic location
profilePicturestring|nullProfile photo URL
networkDistancestring|nullDISTANCE_1, DISTANCE_2, DISTANCE_3, or OUT_OF_NETWORK
currentPositionsarrayCurrent 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

  1. Prospect list building: Search by title + location + industry → build a targeted outreach list
  2. Recruiting: Search by title + company + school → find people who match
  3. 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

Cost: 1 credit for every 20 results returned, at least 1 when any come back, nothing when none.

post/search/linkedin/people

Request

  • Base URL: https://api.bereach.ai
  • URL: https://api.bereach.ai/search/linkedin/people
  • Auth: HTTP bearer

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 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:ACoAAB1234...'). 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 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 IDs of the company HEADQUARTERS, 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. Resolve ids via /search/linkedin/parameters.

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). Results come about ten per page; use multiples of ten to skip whole pages.

countinteger

How many people to return in total (default 10, max 50).

Response

List of LinkedIn people matching the search criteria

successtrue required
category'people' required
hasMoreboolean required
savedinteger nullable

People from this page written to the contact list. Null or absent means the write has not answered: report nothing saved rather than the number of rows returned.

creditsUsedinteger required

Credits this call spent, net of anything given back. 0 when nothing was charged: a free read, a cached answer, nothing delivered.

retryAfterinteger required

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

Changes