Search

Search people, every filter typed

Search people on ordinary LinkedIn, with each LinkedIn filter as its own typed input.

At most 10 rows per call: LinkedIn's page size for this search.

LinkedIn returns at most 1,000 rows for one search; narrow the filters to reach the rest.

publicIdentifier is not always a readable name: for some people a real search returned a string of 20 to 26 letters and digits. The link in publicProfileUrl works either way.

networkDistance in a row is defined as DISTANCE_1 / DISTANCE_2 / DISTANCE_3 (a published sample row also shows OUT_OF_NETWORK), while a profile reports FIRST_DEGREE / SECOND_DEGREE / THIRD_DEGREE for the same thing: do not compare the two as text.

Docs: https://heyreagent.com/docs/actions/search_linkedin_people

post/v1/actions/search_linkedin_people

Request

  • Base URL: https://api.heyreagent.com
  • URL: https://api.heyreagent.com/v1/actions/search_linkedin_people
  • Auth: HTTP bearer

Request body

keywordsstring

Name, title, company or any words.

industrystring[]

Industries: ids from lookup_search_ids type INDUSTRY.

locationstring[]

Places: ids from lookup_search_ids type LOCATION.

profileLanguagestring[]

Profile languages, as two-letter codes such as "en".

companystring[]

Current companies: ids from lookup_search_ids type COMPANY.

pastCompanystring[]

Past companies: ids from lookup_search_ids type COMPANY.

schoolstring[]

Schools: ids from lookup_search_ids type SCHOOL.

servicestring[]

Service categories they offer: ids from lookup_search_ids type SERVICE.

connectionsOfstring[]

People whose connections to search: ids from lookup_search_ids type CONNECTIONS.

followersOfstring[]

People whose followers to search: ids from lookup_search_ids type PEOPLE.

openTostring[]

Open to pro bono work or to a board seat.

limitnumber

How many to return (1–10, default 10).

cursorstring

nextCursor from the previous call, to get the next page. Keep the other arguments the same.

connectionIdstring

Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one.

Response

It worked. Inside result: returned, nextCursor, results[].type, results[].id, results[].publicIdentifier, results[].publicProfileUrl, results[].profileUrl, results[].profilePictureUrl, results[].profilePictureUrlLarge, results[].memberUrn, results[].name, results[].firstName, results[].lastName, results[].networkDistance, results[].location, results[].industry, results[].keywordsMatch, results[].headline, results[].connectionsCount, results[].followersCount, results[].pendingInvitation, results[].canSendInmail, results[].hiddenCandidate, results[].interestLikelihood, results[].recruiterCandidateId, results[].recruiterPipelineCategory, results[].premium, results[].verified, results[].sharedConnectionsCount, results[].recentPostsCount, results[].recentlyHired, results[].mentionedInTheNews, results[].interests.

oktrue required
resultobject required

What was asked for. A field that does not apply is left out, or is null.

Changes

No recorded changes to this operation across all 1 revision of this API.