# search_companies: Search companies

Find companies in Sales Navigator through a shared seat, by industry, place, size and recent signals. This action only reads; it changes nothing. Plan: Agent.

```
POST https://api.heyreagent.com/v1/actions/search_companies
Authorization: Bearer YOUR_KEY
content-type: application/json

{
  "industries": [
    "Software Development"
  ]
}
```

## What you give it

- `industries` (optional): a list (text). Company industries, e.g. ["Software","Financial Services"].
- `locations` (optional): a list (text). Company HQ locations, e.g. ["United States"].
- `headcounts` (optional): a list (text). Company size bands. Valid: self-employed, 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.
- `hiring` (optional): true or false. Only companies with open job posts right now (hiring signal).
- `growingTeamMinPct` (optional): a number. Minimum headcount-growth percent, e.g. 20 = teams that grew ≥20%.
- `minRevenueMillions` (optional): a number. Minimum annual revenue in millions (e.g. 10 = $10M+). LinkedIn uses fixed brackets (0, 0.2, 1, 2.5, 5, 10, 20, 50, 100, 500, 1000); other values widen to the nearest one. Revenue is LinkedIn's estimate — companies without one are left out.
- `maxRevenueMillions` (optional): a number. Maximum annual revenue in millions (same brackets).
- `revenueCurrency` (optional): text. Currency for the revenue band (default USD).
- `recentLeadershipChange` (optional): true or false. Only companies with a recent senior-leadership change (new-boss signal).
- `recentFunding` (optional): true or false. Only companies with a recent funding event (same as list_funding_signals).
- `limit` (optional): a number, 1 to 100. Max companies to return (1–100, default 20). Use 100 to feed the most companies to search_people_sales_navigator via companyIds.

## What you get back

- `returned`
- `source`
- `filtersApplied`
- `warnings`
- `companies`
- `note`

## Good to know

- The total is totalCompanies; with recentFunding and recentLeadershipChange both true it is totalBySignal and withBothSignals instead.
- There is no next page: narrow the filters.

Page: https://heyreagent.com/docs/actions/search_companies