POST /linkedin_company_employees_search • Credits: 0.1 credits per employee profile returned

LinkedIn Company Employees Search returns the employees of one LinkedIn company page, 10 profiles per page. Each profile holds the name, the current job title, the location, and the LinkedIn profile URL. Each profile costs 0.1 credits, so one full page of 10 profiles costs 1 credit, or $0.02.

What does LinkedIn Company Employees Search do?

Sales teams and recruiters hold a list of target companies without a list of the people inside them. LinkedIn Company Employees Search closes that gap. Send one LinkedIn company URL. The endpoint returns the public employee profiles that LinkedIn lists for that company page. The data source is LinkedIn. One request returns one page of 10 employees, and the page parameter reads the next page.

Which endpoint does LinkedIn Company Employees Search use?

Method: POST
URL: https://api.richapi.ai/api/v1/linkedin_company_employees_search
Authentication: x-api-key header
Request format: JSON request body
Response: synchronous JSON
Page size: 10 profiles per request
Credits: 0.1 per profile returned

CAUTION: Send every parameter in the JSON request body. The endpoint accepts POST only. A GET request returns 405 with the error linkedin_company_employees_search only supports POST. A query string parameter returns 400.

How to send a LinkedIn Company Employees Search request

Create an API key in the RichAPI dashboard.
Set the x-api-key header to your API key.
Set the Content-Type header to application/json.
Add company_linkedin_url to the request body. This parameter is required.
Add page to the request body. The first page is 1.
Send the request to https://api.richapi.ai/api/v1/linkedin_company_employees_search.
Read the employee profiles from the elements array in the response.
Read pagination.totalPages to plan the next request.

cURL

curl -X POST https://api.richapi.ai/api/v1/linkedin_company_employees_search   
  -H "x-api-key: YOUR_API_KEY"   
  -H "Content-Type: application/json"   
  -d '{
    "company_linkedin_url": "https://www.linkedin.com/company/stripe",
    "page": 1
  }'

Python

import requests

response = requests.post(
    "https://api.richapi.ai/api/v1/linkedin_company_employees_search",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "company_linkedin_url": "https://www.linkedin.com/company/stripe",
        "page": 1,
    },
    timeout=60,
)
response.raise_for_status()
print(response.json())

Node.js

const response = await fetch(
  "https://api.richapi.ai/api/v1/linkedin_company_employees_search",
  {
    method: "POST",
    headers: {
      "x-api-key": "YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      company_linkedin_url: "https://www.linkedin.com/company/stripe",
      page: 1,
    }),
  },
);

const data = await response.json();
console.log(data);

What parameters does LinkedIn Company Employees Search accept?

Parameter	Type	Required	Default	Description
`company_linkedin_url`	string	Yes	`""`	The LinkedIn URL of the company, for example `https://www.linkedin.com/company/google`.
`page`	integer	No	`1`	The page number. Page numbers start at `1`.

LinkedIn Company Employees Search accepts these two parameters and no other parameter. The endpoint takes no job title filter and no location filter. To filter employees by job title or by location, use People Search API.

Which parameter names do the n8n node and the MCP tool use?

The n8n operation linkedin_company_employees_search and the MCP tool linkedin_company_employees_search use the same parameter names as the HTTP request body.

Request body parameter	n8n and MCP parameter
`company_linkedin_url`	`company_linkedin_url`
`page`	`page`

What does LinkedIn Company Employees Search return?

The response holds a pagination object and an elements array. This example shows 2 of the 10 profiles that one page returns. The values are illustrative.

{
  "pagination": {
    "totalElements": 1000,
    "totalPages": 100,
    "pageNumber": 1,
    "previousElements": 0,
    "pageSize": 10,
    "totalResultCount": 8412
  },
  "elements": [
    {
      "id": "ACoAAA1b2c3D4e5F6g7H8i",
      "name": "Amara Osei",
      "position": "Senior Software Engineer",
      "photo": "https://media.licdn.com/dms/image/v2/profile-photo.jpg",
      "location": {
        "linkedinText": "Dublin, County Dublin, Ireland"
      },
      "linkedinUrl": "https://www.linkedin.com/in/amara-osei",
      "publicIdentifier": "amara-osei"
    },
    {
      "id": "ACoAAB7h8I9j0K1l2M3n4o",
      "name": "Daniel Whitfield",
      "position": "Engineering Manager",
      "photo": null,
      "location": {
        "linkedinText": "San Francisco, California, United States"
      },
      "linkedinUrl": "https://www.linkedin.com/in/daniel-whitfield",
      "publicIdentifier": "daniel-whitfield"
    }
  ],
  "query": {},
  "status": 200,
  "requestId": "req_9f2c41a8b7e04d1c"
}

What does each LinkedIn Company Employees Search response field mean?

Field	Type	Description
`pagination`	object	The page counters for the employee result set.
`pagination.totalElements`	integer	The number of employees that LinkedIn exposes. LinkedIn caps this number at 1000.
`pagination.totalPages`	integer	The number of pages in the employee result set.
`pagination.pageNumber`	integer	The number of the current page.
`pagination.previousElements`	integer	The number of employees on the pages before the current page.
`pagination.pageSize`	integer	The number of employees per page.
`pagination.totalResultCount`	integer	The actual total number of employees across all pages.
`elements`	array of objects	The employee profiles on this page. RichAPI bills 0.1 credits for each object in this array.
`elements[].id`	string	The LinkedIn member URN of the employee.
`elements[].name`	string	The full name of the employee.
`elements[].position`	string	The current job title of the employee.
`elements[].photo`	string	The profile photo URL. When LinkedIn shows no photo, this field is `null`.
`elements[].location`	object	The location of the employee.
`elements[].location.linkedinText`	string	The location as LinkedIn writes it, for example `Dublin, County Dublin, Ireland`.
`elements[].linkedinUrl`	string	The LinkedIn profile URL. When LinkedIn hides the profile, this field is `null`.
`elements[].publicIdentifier`	string	The LinkedIn vanity URL slug, for example `amara-osei`.
`query`	object	The search parameters of the request.
`status`	integer	The upstream status code, for example `200`.
`requestId`	string	The identifier of the search. For a support ticket, quote `richapi_meta.request_id` from the same response.

How much does LinkedIn Company Employees Search cost?

LinkedIn Company Employees Search costs 0.1 credits for each employee profile in the elements array. One credit costs $0.02 on the 1,000 and 5,000 credit packs. Larger packs cost less per credit.

RichAPI counts the objects in the elements array of the response. A full page holds 10 profiles, so one full page costs 1 credit, or $0.02. RichAPI reserves 1 credit before it sends the request, and then charges the real number of profiles that come back. If a page returns 6 profiles, the charge is 0.6 credits.

The formula is:

credits = number of objects in elements x 0.1
cost    = credits x $0.02

Employees returned	Pages (10 per page)	Arithmetic	Credits	Cost
10	1	`10 x 0.1`	1	$0.02
50	5	`50 x 0.1`	5	$0.10
100	10	`100 x 0.1`	10	$0.20
250	25	`250 x 0.1`	25	$0.50
500	50	`500 x 0.1`	50	$1.00
1000	100	`1000 x 0.1`	100	$2.00

What does it cost to map a 500-employee company?

A page holds 10 employees, so a company with 500 employees needs 50 requests. Each full page costs 1 credit. The arithmetic is 500 / 10 = 50 pages, then 50 x 1 = 50 credits, then 50 x $0.02 = $1.00.

CAUTION: Set a page budget before you start a full company map. A 500-employee company costs 50 credits, or $1.00. A 1000-employee company costs 100 credits, or $2.00.

How do you page through the employee list?

Page numbers for LinkedIn Company Employees Search start at 1. Send page: 1 for the first page. To read the next page, increase page by 1 and keep the same company_linkedin_url. The response reports the page count in pagination.totalPages and the page size in pagination.pageSize.

Request	Employees	Credits
`{"page": 1}`	Employees 1 to 10	1
`{"page": 2}`	Employees 11 to 20	1
`{"page": 3}`	Employees 21 to 30	1

This Python loop reads pages until it reaches the last page or the profile budget.

import requests

url = "https://api.richapi.ai/api/v1/linkedin_company_employees_search"
headers = {"x-api-key": "YOUR_API_KEY"}
body = {"company_linkedin_url": "https://www.linkedin.com/company/stripe", "page": 1}
max_profiles = 200

employees = []
while True:
    response = requests.post(url, headers=headers, json=body, timeout=60)
    response.raise_for_status()
    data = response.json()
    employees.extend(data["elements"])
    total_pages = data["pagination"]["totalPages"]
    if body["page"] >= total_pages or len(employees) >= max_profiles:
        break
    body["page"] = body["page"] + 1

print(len(employees))

The max_profiles value caps the cost. A cap of 200 profiles costs 20 credits, or $0.40.

How do you map an account or build an org chart?

Account mapping needs every named person inside one target company. LinkedIn Company Employees Search returns that list from one company URL. Follow these steps for each target account.

Get the LinkedIn company URL of the target account.
Send a LinkedIn Company Employees Search request with page: 1.
Read pagination.totalResultCount to size the company before you read more pages.
Read more pages until you reach your profile budget.
Group the elements by the position field to see the seniority levels.
Send each linkedinUrl to Profile Enrichment API for the full work history.
Send each name and the company domain to Email Finder API for the work email.

Page 1 costs 1 credit and reports totalResultCount. Use that one page to decide whether the full account map is worth the credits.

Company Enrichment adds the firmographics of the account. Send the same company URL to Company Enrichment API for the industry, the headcount and the headquarters.

How does LinkedIn Company Employees Search differ from People Search?

LinkedIn Company Employees Search reads the employee list of one named company. People Search API searches a database of profiles across all companies and takes person filters. Use LinkedIn Company Employees Search for account mapping. Use People Search for prospect lists by job title.

Feature	LinkedIn Company Employees Search	People Search
Scope	One company, named by its LinkedIn URL	All companies in the profile database
Required parameter	`company_linkedin_url`	`page` and `limit`
Job title filter	None	`job_title`
Location filter	None	`location`
Page size	Fixed at 10	`limit`, from `1` to `100`
First page number	`1`	`0`
Results array	`elements`	`content`
Price	0.1 credits per result	0.1 credits per result

Both endpoints cost 0.1 credits per result. LinkedIn Company Employees Search needs more requests for the same result count, because its page size is fixed at 10.

What errors does LinkedIn Company Employees Search return?

Status	Meaning	What to do
`400`	The request body failed validation.	Correct the parameter that the message names. Make sure that `company_linkedin_url` is in the request body.
`401`	The API key is missing, wrong or revoked.	Send a valid key in the `x-api-key` header.
`402`	`Insufficient credits`: the organization has too few credits. Or `Monthly spend limit reached`: the team hit its monthly spend limit.	Buy credits in the RichAPI dashboard, or ask the organization owner to raise the spend limit.
`403`	`Endpoint not available on your plan`: this API key has no access to this endpoint.	Call `GET /api/v1/my-endpoints` to list the endpoints this key can use. Contact support for access.
`404`	The endpoint name is wrong.	Send the request to `/linkedin_company_employees_search`.
`405`	The request method is not `POST`.	Send the request as `POST` with a JSON request body.
`429`	Rate limit exceeded (too many requests per second).	Wait for the `Retry-After` seconds, then retry the request.
`500`	The API failed.	Send the request again. If the failure repeats, contact support.
`502`	The upstream provider failed.	Send the request again with exponential backoff.
`504`	The upstream provider timed out.	Send the request again with exponential backoff.

A failed request returns a JSON object with an error field. RichAPI charges no credits for a failed request.

Frequently asked questions

How much does one LinkedIn Company Employees Search request cost?

One LinkedIn Company Employees Search request costs 0.1 credits for each employee profile in the response. A full page returns 10 profiles, so one page costs 1 credit, or $0.02.

How many employees does one LinkedIn Company Employees Search request return?

One LinkedIn Company Employees Search request returns one page of 10 employee profiles. The page size is fixed at 10, and the page parameter reads the next 10 profiles.

What does it cost to list every employee of a 500-employee company?

A 500-employee company needs 50 requests at 10 employees per page. The arithmetic is 500 x 0.1 = 50 credits, and 50 x $0.02 = $1.00.

Can LinkedIn Company Employees Search filter employees by job title?

No. LinkedIn Company Employees Search accepts company_linkedin_url and page and no other parameter. To filter by job title or by location, use the People Search API.

What is the difference between LinkedIn Company Employees Search and People Search?

LinkedIn Company Employees Search lists the employees of one company that a LinkedIn company URL names. People Search searches profiles across all companies and accepts job title filters, location filters, and company filters.

Does LinkedIn Company Employees Search use GET or POST?

LinkedIn Company Employees Search uses POST. Every parameter goes in the JSON request body. A GET request returns 405 with the error linkedin_company_employees_search only supports POST.

Is LinkedIn Company Employees Search synchronous?

Yes. LinkedIn Company Employees Search returns the employee profiles in the response of the same HTTP request. This endpoint needs no polling and no webhook.

Which page number is the first page?

The first page of LinkedIn Company Employees Search is page: 1. Page numbers start at 1, and the default value of page is 1.

LinkedIn Company Employees Search API