---
title: "Search companies"
method: POST
path: "/v1/actions/search_companies"
tags: ["Search"]
---

# Search companies

`POST /v1/actions/search_companies`

## Request

- Base URL: `https://api.heyreagent.com`
- URL: `https://api.heyreagent.com/v1/actions/search_companies`
- Auth: HTTP bearer

Find companies in Sales Navigator through a shared seat, by industry, place, size and recent signals.

The total is totalCompanies; with recentFunding and recentLeadershipChange both true it is totalBySignal and withBothSignals instead.

There is no next page: narrow the filters.

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

## Request body

- object
  - `industries` string[]: Company industries, e.g. ["Software","Financial Services"].
  - `locations` string[]: Company HQ locations, e.g. ["United States"].
  - `headcounts` string[]: Company size bands. Valid: self-employed, 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.
  - `hiring` boolean: Only companies with open job posts right now (hiring signal).
  - `growingTeamMinPct` number: Minimum headcount-growth percent, e.g. 20 = teams that grew ≥20%.
  - `minRevenueMillions` 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` number: Maximum annual revenue in millions (same brackets).
  - `revenueCurrency` string: Currency for the revenue band (default USD).
  - `recentLeadershipChange` boolean: Only companies with a recent senior-leadership change (new-boss signal).
  - `recentFunding` boolean: Only companies with a recent funding event (same as list_funding_signals).
  - `limit` number: Max companies to return (1–100, default 20). Use 100 to feed the most companies to search_people_sales_navigator via companyIds.

## Response `200`

It worked. Inside result: returned, source, filtersApplied, warnings, companies, note.

- Worked
  - `ok` true, required
  - `result` object, required: What was asked for. A field that does not apply is left out, or is null.

## Other responses

- `default`: It did not work. The message says why, in plain English.

---

[API](https://skmtc.dev/heyreagent/apis/heyreagent-api.md) · [All operations](https://skmtc.dev/heyreagent/apis/heyreagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heyreagent/apis/heyreagent-api/revisions/917360c5f841?raw)