LinkedIn

Search LinkedIn people

People search by keywords or by a LinkedIn or Sales Navigator search URL. Send one or the other, not both; unknown fields are rejected rather than ignored.

POST

/api/v1/linkedin/search

Request bodyrequired

connectedAccountIdrequired

string · uuid

Connected account to act as

keywordsoptional

string

apioptional

"classic" | "sales_navigator"

Which search to run for a keyword query: classic on any account, sales_navigator (the default) with a Sales Navigator seat. Ignored when searchUrl is given.

searchUrloptional

string · uri

cursoroptional

string

limitoptional

integer

Page size: up to 100 with sales_navigator, capped at 10 with classic. Use cursor for the next page.

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