> ## Documentation Index
> Fetch the complete documentation index at: https://api.tryspecter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Companies

> Firmographics, funding, headcount, traction and signals for millions of companies

Firmographics, funding, team intelligence, and real-time signals across 55M+ companies. Specter's companies dataset provides a continuously updated profile of each company — from early-stage startups to public enterprises. Each company has a stable `company_id` used across every endpoint.

## Data categories

* **Profile** — name, description, tagline, HQ, founding year, operating status.
* **Classification** — industry, tech verticals, business model, customer focus.
* **Team & headcount** — employee count, department and location breakdowns, founders (`founder_info` with `specter_person_id`).
* **Funding & financials** — funding history, investors, rounds, post-money valuation.
* **Transactions** — acquisitions and IPOs.
* **Traction & signals** — web traffic, engagement metrics, growth highlights, strategic signal IDs.
* **Social & reviews** — social presence and product reviews (G2, Trustpilot, Glassdoor, Chrome).
* **News & external data** — press mentions, awards, patents and trademarks.

## Highlights

The `highlights` (and `new_highlights`) array surfaces notable, AI-generated flags on a company. Documented values include:

* `headcount_surge` — rapid team growth.
* `strong_web_traffic_growth` — increasing web traction.
* `strong_social_growth` — rising social engagement.
* `top_tier_investors` — backed by leading funds.
* `no_recent_funding` — may be due a new round.

The list is being expanded, so treat it as non-exhaustive. Pair highlights with search filters to build target lists.

## Endpoints

| Method | Endpoint                                                                                          | Returns                                                                             |
| ------ | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `POST` | [Resolve company ID](/api-reference/companies/resolve-company-id)                                 | The Specter `company_id` for a domain, website, LinkedIn URL, or name — batch, free |
| `POST` | [Enrich companies](/api-reference/enrichment/enrich-companies)                                    | Enrich a company by domain or URL                                                   |
| `POST` | [Bulk enrich companies by ID](/api-reference/enrichment/bulk-enrich-companies-by-id)              | Enrich up to 50 companies in one request                                            |
| `GET`  | [Search company name](/api-reference/companies/search-company-name)                               | Find a company by name                                                              |
| `GET`  | [Get company by ID](/api-reference/companies/get-company-by-id)                                   | A full company profile by ID                                                        |
| `GET`  | [Get similar companies](/api-reference/companies/get-similar-companies)                           | Companies similar to one you hold                                                   |
| `POST` | [Bulk get similar companies by ID](/api-reference/companies/bulk-get-similar-companies-by-id)     | Similar companies for up to 50 seeds                                                |
| `POST` | [Get company competitors](/api-reference/companies/get-company-competitors)                       | A company's competitive landscape — ranked competitors and how the market splits    |
| `GET`  | [Get company people](/api-reference/companies/get-company-people)                                 | Team and founders                                                                   |
| `GET`  | [Get company funding rounds](/api-reference/companies/get-company-funding-rounds)                 | Funding history                                                                     |
| `GET`  | [Get company acquisitions](/api-reference/companies/get-company-acquisitions)                     | Acquisitions the company made                                                       |
| `GET`  | [Get company IPOs](/api-reference/companies/get-company-ipos)                                     | IPO history                                                                         |
| `GET`  | [Get Latest Revenue for a Company](/api-reference/companies/get-latest-revenue-for-a-company)     | Latest revenue figures                                                              |
| `GET`  | [Get Latest Valuation for a Company](/api-reference/companies/get-latest-valuation-for-a-company) | Latest valuation figures                                                            |
| `GET`  | [Get News Signals for a company](/api-reference/news-signals/get-news-signals-for-a-company)      | News signals for the company                                                        |

## How to use the API

**Start with what you have**

* A domain, website, LinkedIn URL, or name → [Resolve company ID](/api-reference/companies/resolve-company-id) → take the `company_id` (free, up to 50 at once).
* Want the full record for a domain or URL, and to source it if Specter doesn't have it → [Enrich companies](/api-reference/enrichment/enrich-companies).
* A company ID already → [Get company by ID](/api-reference/companies/get-company-by-id).

**Expand from a company**

* Team and founders → [Get company people](/api-reference/companies/get-company-people) — carries person IDs you can follow to [Get person info by ID](/api-reference/people/get-person-info-by-id).
* Funding history → [Get company funding rounds](/api-reference/companies/get-company-funding-rounds) — each round carries `investor_id` and `is_lead_investor`, chainable to the Investors API.
* Acquisitions → [Get company acquisitions](/api-reference/companies/get-company-acquisitions) — double-sided, with both the acquirer and acquiree company IDs.
* Similar companies → [Get similar companies](/api-reference/companies/get-similar-companies), or the bulk variant [Bulk get similar companies by ID](/api-reference/companies/bulk-get-similar-companies-by-id).
* Competitive landscape → [Get company competitors](/api-reference/companies/get-company-competitors) — ranked competitors and the dimensions the market splits on (1 credit per request).
* Real-time signals → [Get Latest Revenue for a Company](/api-reference/companies/get-latest-revenue-for-a-company), [Get Latest Valuation for a Company](/api-reference/companies/get-latest-valuation-for-a-company), [Get News Signals for a company](/api-reference/news-signals/get-news-signals-for-a-company), and [Get Revenue Signals for a company](/api-reference/revenue-signals/get-revenue-signals-for-a-company).

Note: the company profile's embedded investors and acquirer are names only — the chainable IDs live on the sub-resource endpoints (funding rounds, acquisitions).

## Notes

* [Resolve company ID](/api-reference/companies/resolve-company-id) is free and resolves up to 50 identifiers per request; exact identifiers (domain, website, LinkedIn URL) return one match, while a name returns up to 10 ranked candidates. It's the batch, no-cost way to get a `company_id`; [Search company name](/api-reference/companies/search-company-name) is the single-query, 1-credit name search.
* Most fields are nullable — only core identity (`company_id`, `organization_name`) is guaranteed.
* Enrichment may return more than one company when domains alias to each other.
* `404` = company not found. For the acquisitions and IPOs endpoints, `200` with an empty array `[]` means the company exists but has no such records.
* Sub-resource endpoints return the IDs you chain on across companies, people, and investors.
* [Get company competitors](/api-reference/companies/get-company-competitors) is a `POST` with an optional body — `limit` (1–30, default 30) and `refresh` (force a fresh compute). It's cache-first and auto-recomputes results older than 30 days (`last_updated` shows when). Each competitor carries a `competitiveness_score` (0–1) and, when the rival is in Specter's data set, a `company_id` you can chain to [Get company by ID](/api-reference/companies/get-company-by-id).