linkedin

Search › People

Returns LinkedIn members matching a name or filters, each with handle, headline, location, follower count, profile URL, and member id.

Use it to build a prospect list by job title, company, school, or location; use company/people to list one employer's staff.

Metered: 100–500 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.

Paginates by cursor: see Pagination.

get/v1/linkedin/search/people

Request

  • Base URL: https://api.insightsocial.app
  • URL: https://api.insightsocial.app/v1/linkedin/search/people
  • Auth: API key in header x-api-key

Query parameters

querystring required
Example:Bill Gates

Name or display-name keyword to search for (e.g. 'Bill Gates').

pageinteger

Page number for pagination (default 1).

first_namestring

Filter by first name.

last_namestring

Filter by last name.

titlestring

Filter by job title or headline.

current_companystring
Example:1035

Filter by current company, using a numeric company id from /v1/linkedin/company (author.id). Comma-separated for multiple.

past_companystring
Example:1035

Filter by a previously-worked company, using a numeric company id from /v1/linkedin/company (author.id).

schoolstring
Example:1792

Filter by school, using a school id from /v1/linkedin/search/schools (id).

industrystring
Example:4

Filter by industry, using an industry id from /v1/linkedin/search/industry (industry_id).

geocode_locationstring
Example:103644278

Filter by location, using a geocode id from /v1/linkedin/search/location (geocode).

profile_languagestring

Filter by profile language (ISO 2-letter code, e.g. 'en').

service_categorystring
Example:1

Filter by service category, using a numeric service-category id. No endpoint resolves these, so pass one you already hold.

follower_ofstring
Example:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc

Return people who follow a specific member, using the member's URN from /v1/linkedin/profile (author.ext.urn). This one is a URN and not a numeric id.

include'profile'

Set to profile (one token only) to join every row to the member's profile lookup in this one call: author.followers becomes the exact count and followers_approximate reads false on every row the lookup filled, author.following is filled with the member's connection count, and the location, joined date, country, website, cover image and profile flags land where the row lacks them.

limitinteger

Take the top N rows of this page (1 to 10). The page cursor still advances past the full page of 10, so the rows past your limit are skipped, not carried to the next page.

cursorstring

The pagination.next_cursor from the previous page, sent back unchanged. Omit it for the first page.

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Response

Success.

successtrue required
platformstring required
endpointstring required
schema_version'2' required
unavailablestring[] required
credits_usedinteger required
credits_remaininginteger required
request_idstring required
cachedboolean required
idempotent_replayboolean required
charge_reasonstring required
free_callboolean required

Changes

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