# The company record

Section: API reference
Source: https://platform.metix.ai/docs/api/companies/record
Every page in one file: https://platform.metix.ai/llms-full.txt

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 companies](https://platform.metix.ai/docs/api/companies.md)
- [Query Spec](https://platform.metix.ai/docs/api/query-spec.md)

## 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.

```json
{
  "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 | Type | What it holds |
| --- | --- | --- |
| `id` | string | 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. |
| `name` | string | The company name. |
| `website` | string | The company's own site. |
| `linkedin_url``twitter_url``facebook_url` | string or string[] | Social profiles. The last two are arrays, and are usually empty. |
| `logo_url` | string | The company logo. |
| `last_updated_at` | string | When this record was last refreshed. YYYY-MM-DD. |

## What the company does

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

## Size and money

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

## Headquarters

| Field | Type | What it holds |
| --- | --- | --- |
| `hq_city``hq_state``hq_country` | string | The location as names. hq_country is a full name such as United States. |
| `hq_country_iso2``hq_country_iso3` | string | The same country as US and USA. |
| `hq_street``hq_zipcode` | string | Street line and postal code. |
| `hq_regions` | string[] | Broad groupings such as North America. |
| `hq_full_address` | string | The parts above, formatted for reading. |