LinkedIn · Search

People

Search people by keyword and filters. Each returned person costs 4 credits. Empty results are free.

Request

POST /api/linkedin/search/people with query and optional filters.

▸ ▾ request {}

{
  "query": "engineer",
  "filters": {
    "current_company": [
      "1035"
    ],
    "title": "software engineer"
  }
}

query	Search text, including quoted phrases and Boolean operators. 1–2,048 UTF-8 bytes.
spell_check_enabled	Defaults to true. Set false to keep spelling literal.
pagination_token	Omit initially. Return data.pagination.pagination_token unchanged with the same query, filters and spelling setting.

A call returns one page of up to ten People cards. Pagination stays with the same search account and stops at the source’s limit, up to 100 pages. Stop when has_next_page is false.

Filters

Place these fields inside filters. List filters accept up to 50 nonempty strings, each up to 512 UTF-8 bytes. Text filters accept 1–512 UTF-8 bytes. Empty lists apply no filter.

network	Array: F for first connections, S for second, O for third+. Relative to the captured search account.
geo_ids	Array of LinkedIn location IDs.
current_company	Array of current company IDs.
past_company	Array of past company IDs.
school	Array of school IDs.
industry	Array of industry IDs.
connection_of	Array of native profile IDs whose connections to search.
follower_of	Array of native profile IDs whose followers to search.
profile_language	Array of LinkedIn language values, such as en or fr.
first_name	First-name text.
last_name	Last-name text.
title	Job-title text, including supported search operators.
company	Company keyword text.
school_text	School keyword text.
is_verified	Boolean verification filter.
open_to_volunteer	Boolean volunteering filter.
actively_hiring_for_job_titles	Array of native hiring job-title filter values.
company_hq_geo_ids	Array of company headquarters location values.
company_sizes	Array of native company size values.
function_ids	Array of native job function values.
seniority_ids	Array of native seniority values.
service_category	Array of service category IDs.
event_attending	Array of event IDs.

Use native LinkedIn values for ID filters; names and public URLs are not converted to IDs. Available filters and results depend on the search account. These are People search filters. Sales Navigator exclusion and tenure filters are not accepted.

Response

▸ ▾ response {} — one real card; headline shortened

{
  "cost": 4,
  "data": {
    "query": "work life",
    "filters": {},
    "people": [
      {
        "id": "ACoAAAS20A4BSrL3R-Fdt_yAYWn8ExA1RX-t9qE",
        "name": "Nkem Chinwe Offonabo - The HARMONISER™",
        "url": "https://www.linkedin.com/in/nkemoffonabo/",
        "headline": "Founder & CEO, The Work-Life Organisation | Global Human Capital & Organisational Transformation Strategist | Fractional CHRO",
        "location": "Lagos State, Nigeria",
        "connection_degree": "3rd+",
        "verified": true,
        "premium": false,
        "followers": 155116,
        "insights": [
          "155,116 followers"
        ],
        "highlights": []
      }
    ],
    "pagination": {
      "page": 1,
      "has_next_page": true,
      "pagination_token": "<opaque token from the response>"
    }
  }
}

data {}

querytextThe search query.

filtersobjectThe filters you supplied.

▸ ▾ peopleobject[]Returned People search cards.

idtextAvailable native profile ID; kept as a string.

nametextDisplayed name, which can be abbreviated or hidden.

urltextAvailable public profile link.

headlinetextDisplayed professional headline.

locationtextDisplayed location text.

connection_degreetextDisplayed relationship, such as 2nd or 3rd+.

picture_urltextLargest supplied profile picture rendition. The link can expire.

verifiedbooleanWhether the card displays the Verified badge.

premiumbooleanWhether the card displays a Premium badge.

followersnumberExact displayed follower count, when available.

insightstext[]Visible follower and mutual-connection insights.

highlightstext[]Additional visible matching snippets and context.

paginationobjectpage, has_next_page and pagination_token. The token is null at the end.

Missing fields are null or empty lists. Search cards can hide identity details or provide less information than a full profile. Cost is four times the number of returned people; an unaffordable page returns no results and no charge.