LinkedIn

Search LinkedIn people

Search standard LinkedIn with keywords, focused structured filters, or a Classic people search URL.

POST

/api/v1/linkedin/people/search

Request bodyrequired

connectedAccountIdrequired

string · uuid

Connected account to act as

keywordsoptional

string

locationsoptional

string[]

Location ids from the search parameters endpoint with type=LOCATION.

industriesoptional

string[]

Industry ids from the search parameters endpoint with type=INDUSTRY.

companiesoptional

string[]

Current-company ids from the search parameters endpoint with type=COMPANY.

pastCompaniesoptional

string[]

Past-company ids from the search parameters endpoint with type=COMPANY.

schoolsoptional

string[]

School ids from the search parameters endpoint with type=SCHOOL.

serviceCategoriesoptional

string[]

Service-category ids from the search parameters endpoint with type=SERVICE.

connectionsOfoptional

string[]

Member ids from the search parameters endpoint with type=CONNECTIONS. Returns people connected to them.

followersOfoptional

string[]

Member ids from the search parameters endpoint with type=PEOPLE. Returns people who follow them.

profileLanguagesoptional

string[]

ISO 639-1 profile-language codes from the search parameters endpoint with type=LANGUAGE.

networkDistancesoptional

number[]

LinkedIn connection degrees: first, second, or third-plus.

openTooptional

"pro_bono" | "board_member"[]

LinkedIn only filters on these two, not on open to work or hiring.

advancedKeywordsoptional

object

LinkedIn's Keywords panel: each field matches text against that profile field only.

firstNameoptional

string

lastNameoptional

string

titleoptional

string

companyoptional

string

schooloptional

string

searchUrloptional

string · uri

Use a people search URL copied from standard LinkedIn, such as https://www.linkedin.com/search/results/people/?keywords=engineer. The filters it carries replace the filter fields, which must then be left out. Sales Navigator URLs go to POST /api/v1/linkedin/sales-navigator/people/search.

cursoroptional

string

limitoptional

integer

Requested page size, capped at 10 by LinkedIn Classic.

Response

200Search hits and an optional cursor.

hits

object[]

cursor

string | null

requestId

string · uuid

Id of this request, for support and troubleshooting

Errors

  • 400: Bad request
  • 401: Unauthorized: missing or invalid API key
  • 403: Forbidden
  • 404: Not found
  • 422: Invalid request payload

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy