# search_linkedin_companies: Search companies, every filter typed

Search company pages on ordinary LinkedIn, with each LinkedIn filter as its own typed input. This action only reads; it changes nothing. Plan: Free and Connect.

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

{
  "keywords": "software"
}
```

## What you give it

- `keywords` (optional): text. Words to search for.
- `industry` (optional): a search filter id. Industries: ids from lookup_search_ids type INDUSTRY. Where to get it: run `lookup_search_ids` with type `INDUSTRY` and use `matches[].id`.
- `location` (optional): a search filter id. Places: ids from lookup_search_ids type LOCATION. Where to get it: run `lookup_search_ids` with type `LOCATION` and use `matches[].id`.
- `hasJobOffers` (optional): true or false. Only companies with job listings on LinkedIn.
- `headcount` (optional): a list (a group of fields). Company sizes, as LinkedIn's own bands, e.g. { min: 51, max: 200 }.
  - `min` (optional): one of: 1, 11, 51, 201, 501, 1001, 5001, 10001. 
  - `max` (optional): one of: 1, 10, 50, 200, 500, 1000, 5000, 10000. 
- `networkDistance` (optional): a list (one of: 1, 2, 3). Connection degrees from you: 1, 2, 3.
- `limit` (optional): a number, 1 to 10. How many to return (1–10, default 10).
- `cursor` (optional): a cursor. nextCursor from the previous call, to get the next page. Keep the other arguments the same. Where to get it: The `nextCursor` from the last answer of `search_linkedin_companies`.
- `connectionId` (optional): a connection id. Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one. Where to get it: Run `list_linkedin_accounts` and use `accounts[].id`.

## What you get back

- `returned`: number
- `nextCursor`: a cursor
- `results[].type`: COMPANY
- `results[].id`: a company id
- `results[].name`: string
- `results[].location`: string or null
- `results[].profileUrl`: a company link
- `results[].industry`: string
- `results[].summary`: string or null
- `results[].followersCount`: number
- `results[].jobOffersCount`: number
- `results[].headcount`: string

## Good to know

- At most 10 rows per call: LinkedIn's page size for this search.
- LinkedIn returns at most 1,000 rows for one search; narrow the filters to reach the rest.

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