---
title: "Search People"
method: GET
path: "/v1/data/linkedin/search-people"
tags: ["LinkedIn: Profile APIs"]
---

# Search People

`GET /v1/data/linkedin/search-people`

## Request

- Base URL: `https://api.superagnt.com`
- URL: `https://api.superagnt.com/v1/data/linkedin/search-people`
- Auth: API key in header `Authorization`

Search LinkedIn people profiles. Reliability notes: `data.items: null` can mean a transient LinkedIn-side failure, a query that is too broad, or pagination past LinkedIn's accessible result window. Always retry null responses before treating them as definitive. `start: 0` is unusually flaky; prefer `start: 10` as the first practical page or retry page 0 with `start: 10`. Use bounded pagination with `start` values from 10 through about 990 and do not request `start >= 1000`. Keep searches narrow, ideally below roughly 10,000 reported total results, by combining 2-3 specific filters. Broad searches such as keywordTitle alone, geo alone, a large company alone, or first/last name alone often return a populated total with null items. For large companies, add firstName, lastName, or a specific keywordTitle. Do not treat `total` as an exact count; it is a fluctuating LinkedIn estimate. You may see fewer than 10 results per page because LinkedIn hides some profiles and the endpoint filters those hidden profiles from the returned items.

## Query parameters

- `firstName` string
- `geo` string
- `keywordTitle` string
- `start` string
- `lastName` string
- `company` string
- `keywordSchool` string
- `keywords` string
- `schoolId` string

## Response `200`

200

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `total` integer
    - `items` object[]
      - `fullName` string
      - `headline` string
      - `summary` string
      - `profilePicture` string
      - `location` string
      - `profileURL` string
      - `username` string

---

[API](https://skmtc.dev/superagnt/apis/superagnt-api.md) · [All operations](https://skmtc.dev/superagnt/apis/superagnt-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superagnt/apis/superagnt-api/revisions/b2d8de30ccf0?raw)