# Search › People (/docs/api-reference/linkedin/search-people)

`GET https://api.insightsocial.app/v1/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](https://www.insightsocial.app/docs/pagination).

Send your key in the `x-api-key` header.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | yes | Name or display-name keyword to search for (e.g. 'Bill Gates'). |
| `page` | integer | no | Page number for pagination (default 1). |
| `first_name` | string | no | Filter by first name. |
| `last_name` | string | no | Filter by last name. |
| `title` | string | no | Filter by job title or headline. |
| `current_company` | string | no | Filter by current company, using a numeric company id from /v1/linkedin/company (`author.id`). Comma-separated for multiple. |
| `past_company` | string | no | Filter by a previously-worked company, using a numeric company id from /v1/linkedin/company (`author.id`). |
| `school` | string | no | Filter by school, using a school id from /v1/linkedin/search/schools (`id`). |
| `industry` | string | no | Filter by industry, using an industry id from /v1/linkedin/search/industry (`industry_id`). |
| `geocode_location` | string | no | Filter by location, using a geocode id from /v1/linkedin/search/location (`geocode`). |
| `profile_language` | string | no | Filter by profile language (ISO 2-letter code, e.g. 'en'). |
| `service_category` | string | no | Filter by service category, using a numeric service-category id. No endpoint resolves these, so pass one you already hold. |
| `follower_of` | string | no | 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` | string | no | 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. One of: profile. |
| `limit` | integer | no | 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. |
| `cursor` | string | no | The `pagination.next_cursor` from the previous page, sent back unchanged. Omit it for the first page. |
| `dry_run` | string | no | 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. One of: 1. |