Skip to main content
POST
Company Profile

Company

Cost: 1 credit / successful request. (Extra charges might be incurred if premium optional parameters are used. Please read the description of the parameters that you intend to use) The company_insights flag costs an additional 10 credits, charged only when the insights request succeeds. The get_funding_rounds flag costs an additional 5 credits, charged only when the funding rounds request succeeds. Get structured data of a Company Profile.

Company profile endpoint

This endpoint allows you to get structured data of a LinkedIn Company Profile.

Required attributes

string
required
The LinkedIn URL of the company.

Optional attributes

string
Alters the caching behavior.
  • if-present - The default behavior. Fetches profile from cache regardless of age of profile. If the profile is not available in cache, the API fetches it live.
  • if-recent - API will make a best effort to return a fresh profile no older than 29 days.
  • never - Do not ever read profile from cache.
string
The language in which you need your response.
boolean
Appends LinkedIn-native company insights (headcount trends, hiring trends, notable alumni, job openings by function, and median employee tenure) to insights. false by default.Costs an additional 10 credit, subject to data availability, on top of the base endpoint cost.
boolean
Looks up the company’s funding round history (using the website from the company profile) and appends it to funding_rounds. false by default.Costs an additional 5 credits, subject to data availability, on top of the base endpoint cost. Same data as the standalone Funding Rounds endpoint.

Response

Not found and failed lookups

Both answer HTTP 200 with an error and a retryable flag instead of message:
  • retryable: false: LinkedIn has no company page at this URL (a removed page, or a slug that was never claimed). The lookup ran, so it costs 1 credit. Repeating it gives the same answer.
  • retryable: true: we could not get an answer in time. Nothing is charged; retry later.
Fields a company page does not show (a founding year, a website, a headquarters) are null. Small or placeholder pages often leave several of them out.

The company model

This contains the structured data of a company’s LinkedIn profile.

Properties

Basic information

string
Unique LinkedIn identifier for the company.
string
Company name.
string
Universal LinkedIn identifier (vanity URL).
string
Formatted LinkedIn company page URL.
string
LinkedIn company page URL.
string
Type of company (e.g., “Public Company”, “Private Company”, “Partnership”).
string
Employee headcount range (e.g., “10,001+ employees”).
string
Number of employees on LinkedIn, as a string with thousands separators (e.g. "4,040"). null when the page does not show it.
string
Company tagline or slogan.

Company description

string
Detailed company description.
string
Additional information about the company.
string
Extended information including job listings and other details.

Industry and specialties

string
Primary industry of the company.
string
Detailed industry classification.
array
List of company specialties and focus areas.

Location information

string
Headquarters location (city, state/country).
string
Primary geographic location.
string
ISO country code (e.g., “US”, “UK”).
object
Detailed headquarters address.
array
List of all company locations (addresses as strings).
array
Detailed list of all company locations.
array
List of map/directions URLs for all locations.

Company statistics

string
Year the company was founded. null when the page does not list one.
string
Number of LinkedIn followers.

Online presence

string
Company website URL.
string
Company logo URL.
string
Company cover/banner image URL.
string
The funding-profile link shown on the company’s LinkedIn page.

Funding information

object
Stock market information (if publicly traded).
object
Funding information shown on the company’s LinkedIn page.
array
Direct list of company investors.

Jobs and employees

array
Available job listings on LinkedIn.
array
Sample of company employees on LinkedIn.
array
List of affiliated company pages (subsidiaries, products, etc.).
array
List of similar companies.

Recent updates

array
Recent company posts and updates.

Insights

object
Present only when the company_insights request flag is true. On failure this contains { "error": "Unable to fetch this data at this time." } instead of data, and no extra credit is charged.

Funding rounds

object
Present only when the get_funding_rounds request flag is true. On failure this contains { "error": "Unable to fetch this data at this time." } instead of data, and no extra credit is charged. See the Funding Rounds endpoint for the full field reference.

Request echo and contacts

string
The LinkedIn URL the profile was collected from.
object
Email addresses and phone numbers the company published on its page (About section, page description, its own posts). LinkedIn has no structured contact field for companies, so this is often empty. No extra credit is charged.