---
title: "Get the people at a company, from LinkedIn"
method: GET
path: "/linkedin/employees"
tags: ["LinkedIn"]
---

# Get the people at a company, from LinkedIn

`GET /linkedin/employees`

## Request

- Base URL: `https://api.scrapefield.com/v1`
- URL: `https://api.scrapefield.com/v1/linkedin/employees`
- Auth: one of:
  - HTTP bearer
  - none

Fetch the people who list a company as their employer, 25 a page from Sales Navigator, which hides no one: each person's name, location and profile, and their current roles, each with its title, employer and `company_id`, and start month. The same object, and price, as linkedin/people with `source=sales_navigator`. Takes the company's numeric id, `company_id` in linkedin/company. Use this to map a company's team or to find who to contact.

Costs 170 credits, whether the answer is fetched or served from cache. A failed call is refunded automatically.

## Query parameters

- `company_id` string, required
- `cursor` string
- `fresh` boolean
- `demo` boolean

## Response `200`

The request succeeded.

- object
  - `data` LinkedinLead[], required
    - `vanity_name` string, nullable, required: The public name after `/in/`. `null` where Sales Navigator gives only a member id.
    - `url` string, uri, required: Their profile. Sales Navigator often gives a member-id link (`/in/ACwAA…`) instead of a public name.
    - `first_name` string, nullable, required: The given name.
    - `last_name` string, nullable, required: The family name.
    - `full_name` string, nullable, required: First and last name together.
    - `location` string, nullable, required: As printed.
    - `profile_picture_url` string, uri, nullable, required: The profile photo.
    - `premium` boolean, nullable, required: Whether they pay for LinkedIn Premium.
    - `open_profile` boolean, nullable, required: Whether anyone can message them, connected or not.
    - `current_positions` object[], required: What they do now, as Sales Navigator lists it.
      - `title` string, nullable, required: The job title, as printed.
      - `company` object, required: The employer.
        - `name` string, nullable, required: As the listing prints it.
        - `url` string, uri, nullable, required: The company page, where it has one.
      - `company_id` string, nullable, required: LinkedIn's numeric id for the employer.
      - `start_date` string, nullable, required: `YYYY-MM`, or `YYYY` where only a year is given.
      - `description` string, nullable, required: What they wrote about the role.
  - `meta` Meta, required
    - `request_id` string, required: Quote this if you contact support.
    - `credits_charged` integer, required: The endpoint's published cost. 0 for a demo answer, and for a list emptied because everyone in it asked not to be served. A failed call has no `meta`: it answers with an error, and is refunded.
    - `credits_remaining` integer
    - `cached` boolean, required
    - `fetched_at` string, date-time, required: When the data was actually fetched — the original time on a cache hit, so freshness is always visible.
    - `next_cursor` string, nullable, required: Pass as `cursor` for the next page. `null` on the last page. It lasts as long as the answer is cached.
    - `demo` boolean: Present, and true, on a demo answer (`?demo=true` with no key).
    - `note` string: On a demo answer: what it is, and what a live call costs.

## Other responses

- `400`: Something went wrong. `error.code` is stable; `error.message` says what to do next.
- `401`: Something went wrong. `error.code` is stable; `error.message` says what to do next.
- `403`: Something went wrong. `error.code` is stable; `error.message` says what to do next.
- `404`: Something went wrong. `error.code` is stable; `error.message` says what to do next.
- `429`: Something went wrong. `error.code` is stable; `error.message` says what to do next.
- `500`: Something went wrong. `error.code` is stable; `error.message` says what to do next.
- `501`: Something went wrong. `error.code` is stable; `error.message` says what to do next.
- `502`: Something went wrong. `error.code` is stable; `error.message` says what to do next.

---

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