LinkedIn Employees API
API health
- 24h health
- Normal
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
See who works at a company on LinkedIn. Pass its short name or /company/ link in company. Get each person's name, headline, location and profile link. Rows are a sample of observed profiles, not an official, current or complete staff list.
Send POST https://api.everyinfra.com/api/v1/social with platform set to linkedin and action set to employees. Price $0.79 per 1,000 requests ($0.000792 per call). Failed calls and empty results are not charged. Synchronous. For slow jobs add "mode": "async" to the body, take the job_id and poll.
LinkedIn Employees lists a public sample of the people who work at one company, given the company's LinkedIn short name or /company/ page link in company. Each row carries the person's name, headline, location with country, country code and city, profile link, avatar, Premium and influencer flags, whether they have marked themselves open to work, and contact details where available. Sales teams use it to map the people at a target account, recruiters to source candidates, and analysts to see where a company's staff are based.
The list is a sample, not a full roster, so do not use its length as headcount. headline is the short line each person writes about themselves. open_to_work marks people who have publicly flagged that they are looking for a job, and email comes back only when public or authorized, which means it is null for most rows.
AI prompt
#Please help me write a data collection script with the EveryInfra LinkedIn Employees endpoint (linkedin/employees).
How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to linkedin and action to employees, and put the parameters inside params.
- Required parameters:
- company: Specifies the LinkedIn company short name or /company/ profile URL for company_profile and employees, rather than an arbitrary legal business name.
- Optional parameters:
- limit: The most rows to return in this call, an integer from 1 to 200. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. (default: 20)
- Returns a list of records. Main fields of each record: id, url, name, headline, location, country, country_code, city, avatar_url, is_premium, is_influencer, open_to_work; 25 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=linkedin.
- Example request body:
{
"platform": "linkedin",
"action": "employees",
"params": {
"company": "google"
}
}
- Price: $0.79 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.
Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.Request parameters
#| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
Authorization | header | string | Yes | - | Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository. |
platform | body | string | Yes | linkedin | Platform identifier, fixed value. |
action | body | string | Yes | employees | Capability identifier, fixed value. |
company | body.params | string | Yes | - | Specifies the LinkedIn company short name or /company/ profile URL for company_profile and employees, rather than an arbitrary legal business name. The employees action expands short names into full company URLs to return a public employee sample, which does not guarantee a complete roster of current staff. |
limit | body.params | integer (1–200) | No | 20 | The most rows to return in this call, an integer from 1 to 200. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |
Code samples
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "linkedin",
"action": "employees",
"params": {
"company": "google"
}
}'OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.
Response example
#{ "id": "req_…", "platform": "linkedin", "action": "employees", "results": [ { "id": "•••", "url": "https://linkedin.com/•••", "name": "•••", "headline": "•••", "location": "•••", "country": "United States", "country_code": "US", "city": "Mountain View, California", "avatar_url": "", "is_premium": true, "is_influencer": false, "open_to_work": false, "company_url": "https://www.linkedin.com/company/google", "is_creator": false, "is_top_voice": false, "is_memorialized": false, "account_created_at": "2004-04-26T01:31:42+00:00", "primary_locale": "en_US", "member_urn": "•••", "first_name": "•••", "last_name": "•••", "company_id": "1441", "platform": "linkedin" }, { "id": "•••", "url": "https://linkedin.com/•••", "name": "•••", "headline": "•••", "location": "•••", "country": "United Kingdom", "country_code": "GB", "city": "London, England", "avatar_url": "https://media.licdn.com/•••", "is_premium": false, "is_influencer": false, "open_to_work": false, "company_url": "https://www.linkedin.com/company/google", "is_creator": true, "is_top_voice": false, "is_memorialized": false, "account_created_at": "2006-02-01T02:16:53+00:00", "primary_locale": "en_US", "member_urn": "•••", "first_name": "•••", "last_name": "•••", "company_id": "1441", "platform": "linkedin" } ], "count": 20, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Response fields
#Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.
| Field | Meaning |
|---|---|
id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
url | Link to the record on the platform. |
name | Name of the object itself, for account, product and business capabilities. |
headline | Keeps the platform's own meaning |
location | Location description passed through as is; the format varies by platform. |
country | Country or region: a full name or an ISO code depending on the platform, not normalized. |
country_code | Keeps the platform's own meaning |
city | City name in the platform's language, not normalized. |
avatar_url | Avatar image link. Some platforms return sized CDN links that can expire. |
is_premium | Keeps the platform's own meaning |
is_influencer | Keeps the platform's own meaning |
open_to_work | Keeps the platform's own meaning |
company_url | Link to the company page. |
email | Email address. On person_profile and profile_search it is a work address inferred from public information and then validated; on employees it is present only when the source gives one. May be empty, and it does not mean the person agreed to marketing contact. |
phone | Contact phone number, passed through without format normalization. |
is_creator | Whether the profile runs in creator mode. |
is_top_voice | Whether the profile carries the LinkedIn Top Voice badge. |
is_memorialized | Whether the account is memorialized (the person has died). |
account_created_at | Account creation time; null when the source omits it. |
primary_locale | Primary locale of the account (e.g. en-US). |
postal_code | Postal code of the profile location (employees; only when the source gives it). |
member_urn | Keeps the platform's own meaning |
first_name | First name (person_profile). |
last_name | Last name (person_profile). |
company_id | Keeps the platform's own meaning |
platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
FAQ
#Is this a complete list of a company's employees?
#No. It returns a public sample of employees, not the full roster. For headcount, use the employee count reported by LinkedIn Company profile, and treat this list as a view of roles and locations rather than a count of staff.
How do I group employees by country or city?
#Use country_code rather than country, which can be a full name or an ISO code depending on the record. city is written in the platform's language and not normalized, so map city names before counting, and fall back to location, the raw place text, when city is empty.
How do I read someone's full profile?
#When url is the person's /in/ profile link, pass it to the LinkedIn Person profile capability, which accepts a full profile link and returns the about section, current company, follower and connection counts and more. headline here is only the short line the person wrote about themselves.
Errors and billing
#- 401
- Missing or invalid key.
- 402
- Insufficient balance. Top up first.
- 422
- Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
- 429
- Per-minute request limit reached. Wait for Retry-After, then try again.
- 503
- Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
- 200 empty
- No data. No charge.
Official references
#Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.
- LinkedIn Official Documentation: Company Affiliations Derive from User-Entered Experience Entries ↗
Users link to a company Page by selecting that company in their profile experience, which allows for accidental selections and delayed affiliation count updates. Employee page samples and `employee_count` do not constitute an audited list of active employees.
Checked 2026-09-04
- LinkedIn User Agreement: Company-Affiliated Data Cannot Be Redistributed Without Restriction ↗
The User Agreement enforces conditions on the use, copying, and distribution of information obtained directly or through third parties. Publicly displayed affiliations on a company Page do not grant permission to bulk collect or contact those individuals.
Checked 2026-09-04