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

# Companies

> Each company we read, with facts and hiring signals from our own data and open sources.

`GET /v1/companies` lists the companies with open jobs. `GET /v1/companies/{id}` gives one company with its hiring signals. Both are free.

```bash theme={null}
curl "$BASE_URL/v1/companies?industry=software%20industry&companySize=1001-5000" -H "Authorization: Bearer $API_KEY"
curl "$BASE_URL/v1/companies/123" -H "Authorization: Bearer $API_KEY"
```

## Where the data comes from

Only from the employer itself and from open data. Never from LinkedIn, Glassdoor or Crunchbase.

| Field | Source |
| - | - |
| `name`, `boardUrl`, `openJobs` | The employer's own job board |
| `domain` | The company's website, as its own board pages link to it. Left empty when no link clearly belongs to the company. |
| `industries`, `employees`, `size`, `hqCountry` | [Wikidata](https://www.wikidata.org) (CC0). Filled only when a Wikidata item has the same website domain as the company. `wikidata` names the item. |
| `history`, `added30d`, `closed30d`, `avgDaysOpen`, `newCountries`, `newCities` | Our own daily reads of the board |

## Hiring signals

* **`history`**: open jobs at the end of each day the number changed, up to 180 days back. A day without an entry had the number of the entry before it.
* **`added30d`** and **`closed30d`**: jobs that appeared and jobs the employer took down in the last 30 days.
* **`avgDaysOpen`**: hiring speed, the average days a job stayed open, over jobs closed in the last 90 days.
* **`newCountries`** and **`newCities`**: places in jobs from the last 30 days that none of the company's older jobs had.

## Filters on company facts

`GET /v1/jobs`, `GET /v1/count`, `GET /v1/facets` and the XML feed take `industry` and `companySize`. Jobs of companies whose facts are unknown are left out. In a sample of our jobs (November 2026), an industry was known for about 30% of jobs and a headcount for about 18%, mostly larger employers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.