Platform

API reference

The company record

Every field the companies detail route returns, what each one holds, and a whole record to read. Values here are invented; the shape is the one the API returns.

Search companiesQuery Spec

What comes back

Send the ids and nothing else and you get the record below. What the company is, how big it is, where it is headquartered, and how to reach it online.

POST/entity/v1/companies/detail-by-id
{
  "id": "Cm4vTnR2sD",
  "name": "Northwind Analytics",
  "website": "https://northwind-analytics.example",
  "linkedin_url": "https://www.linkedin.com/company/northwind-analytics",
  "logo_url": "https://cdn.example/northwind.png",
  "twitter_url": ["https://twitter.com/northwind_example"],
  "facebook_url": [],
  "industry": "Software Development",
  "categories_and_keywords": ["analytics", "data infrastructure"],
  "type": "Privately Held",
  "is_b2b": 1,
  "size_range": "201-500 employees",
  "employees_count": 320,
  "employees_count_change_yearly_percentage": 12.5,
  "followers_count": 8400,
  "founded_year": "2016",
  "hq_city": "Austin",
  "hq_state": "Texas",
  "hq_country": "United States",
  "hq_country_iso2": "US",
  "hq_country_iso3": "USA",
  "hq_street": "500 Congress Avenue",
  "hq_zipcode": "78701",
  "hq_regions": ["North America"],
  "hq_full_address": "500 Congress Avenue, Austin, Texas 78701, United States",
  "stock_ticker": null,
  "last_funding_round_date": "2024-02-14",
  "last_funding_round_amount_raised": 42000000,
  "last_updated_at": "2026-08-19"
}

Empty is not missing

A field with no value comes back as null or an empty array rather than being left out, so a record's shape does not change with how complete it is. Read the value, not the presence of the key.

Identity

Field
id
Type
string
What it holds
The company's identifier on this API. A profile's experience.company_id and a job's company_id are the same identifier, so both lead here.
Field
name
Type
string
What it holds
The company name.
Field
website
Type
string
What it holds
The company's own site.
Field
linkedin_urltwitter_urlfacebook_url
Type
string or string[]
What it holds
Social profiles. The last two are arrays, and are usually empty.
Field
logo_url
Type
string
What it holds
The company logo.
Field
last_updated_at
Type
string
What it holds
When this record was last refreshed. YYYY-MM-DD.

What the company does

Field
industry
Type
string
What it holds
The company's industry. A long vocabulary of several hundred values, so match rather than eq.
Field
categories_and_keywords
Type
string[]
What it holds
Self-described focus areas. The most useful field for finding companies like a given one.
Field
type
Type
string
What it holds
Legal form, from a fixed set of eight.
Field
is_b2b
Type
integer
What it holds
1 where the company sells to businesses.
Field
founded_year
Type
string
What it holds
Year of founding, as a string on the record. Filter on founded_year with gte and lte.

Size and money

Field
size_range
Type
string
What it holds
Headcount band, from a fixed set of nine.
Field
employees_count
Type
integer
What it holds
Headcount as a number, which is the one to compare on.
Field
employees_count_change_yearly_percentage
Type
float
What it holds
Year-on-year headcount change, as a percentage. Negative where the company shrank.
Field
followers_count
Type
integer
What it holds
Audience on the source platform.
Field
last_funding_round_datelast_funding_round_amount_raised
Type
string, integer
What it holds
The most recent round, where one is known.
Field
stock_ticker.exchangestock_ticker.ticker
Type
string
What it holds
Market listing, for public companies.

Headquarters

Field
hq_cityhq_statehq_country
Type
string
What it holds
The location as names. hq_country is a full name such as United States.
Field
hq_country_iso2hq_country_iso3
Type
string
What it holds
The same country as US and USA.
Field
hq_streethq_zipcode
Type
string
What it holds
Street line and postal code.
Field
hq_regions
Type
string[]
What it holds
Broad groupings such as North America.
Field
hq_full_address
Type
string
What it holds
The parts above, formatted for reading.