LinkedIn hub

LinkedIn People Search API

Search public LinkedIn people by first and/or last name and get structured JSON rows — name, profile URL, location, experience, education — ready for enrichment follow-ups.

GET /v1/linkedin/people/search

3 credits Failed requests are free

About this endpoint

GET /v2/linkedin/people/search takes keyword. Branch on data.lookupStatus: found when at least one person came back, not_found when the completed page is empty. Continue with data.page.nextCursor when more results are available.

This route is discovery, not a full profile dump. Once you have a handle or entityId, call GET /v2/linkedin/profiles for enrichment. Pricing is a flat 3 credits per completed page, including an empty result; technical failures cost zero. Trust meta.creditsCharged. Live data can be served within a documented freshness window, including cache hits.

LinkedIn People Search API FAQ

How do I search LinkedIn people by name via API?

Call GET /v2/linkedin/people/search with your Social Fetch API key (x-api-key) and a keyword query param. Read data.lookupStatus and the people page in the JSON response. See the API docs for parameters.

How much does LinkedIn people search cost?

3 credits per completed result page, including an empty page. The number of people returned does not change the price; technical failures cost zero. Trust meta.creditsCharged.

What do I pass to search people?

Pass keyword. Add the documented filters and cursor when you need another page.

What fields does each LinkedIn people search result include?

Each person row has name and profileUrl. When supplied, it can also include subtitle, location, and imageUrl. Experience and education are not returned by this migrated search route; enrich the selected profile URL separately.

People search vs LinkedIn profile GET?

Use GET /v2/linkedin/people/search when you have a keyword and need candidate people. Use GET /v2/linkedin/profiles when you already have a handle or entityId.

What happens when no people match the name search?

The call still returns HTTP 200 with lookupStatus of not_found, an empty people array, and summary.returned of 0. The flat 3-credit completed-page price still applies.

How long does LinkedIn people search take?

Longer than most Social Fetch LinkedIn GETs. Plan for roughly one and a half minutes per request. Set client timeouts accordingly and treat meta.requestId as the support handle if a call fails mid-flight.

Do I need LinkedIn partner API access for people search?

No. Social Fetch returns public LinkedIn people search results for enrichment-style discovery. LinkedIn's official partner APIs are separate and require LinkedIn's access programs and member authorization.