---
ref: tool:lemlist/search-companies
name: Search companies
company: company:lemlist
workflows: []
access: [cli, api]
tags: [capability:build-audience, category:sales-engagement, has:api, has:cli]
docs: https://developer.lemlist.com/api-reference/endpoints/people-database/search-companies-database
updated: 2026-09-27
---

# Search companies

Returns companies from lemlist's database that match filters such as industry, company size or technologies used, with their location, employee count and technologies.

Filters take the same shape as the people search: a `filterId`, such as
`industry`, `companySize` or `currentCompanyTechnologies`, with `in` and `out`
value lists; `GET /database/filters` lists them. Pages hold up to 500
companies (`size`, 100 by default).

## Set up

Use the first option your agent supports.

### CLI (official)

Install the command, then confirm it runs.

```sh
npm install -g @lemlist-official/cli
lemlist --version
```

Run `lemlist api POST /database/companies`.

### API (official)

- Base URL: https://api.lemlist.com/api
- Endpoint: `POST /database/companies`
- Auth: send the header `Authorization: Basic $LEMLIST_API_KEY`
- Get a key: https://app.lemlist.com/settings/integrations
- Docs: https://developer.lemlist.com/api-reference/getting-started/authentication

Before doing anything else, make one read-only call to confirm access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data.
- Never print API keys.