# Find similar companies

Find up to 20 companies recommended by LinkedIn for a company you choose.

## Send a request

Replace `YOUR_API_KEY` with your [API key](https://docs.envoapi.com/guides/authentication.md), then run:

```bash
curl --get 'https://api.envoapi.com/v1/companies/similar/by-slug' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data-urlencode 'slug=microsoft'
```

The slug is the part after `/company/` in a LinkedIn company URL. For example,
`https://www.linkedin.com/company/microsoft/` has the slug `microsoft`.

Choose the endpoint that matches what you have. Both return the same response
format.

| Input                                                                                | GET endpoint                    | Required parameter                                |
| ------------------------------------------------------------------------------------ | ------------------------------- | ------------------------------------------------- |
| [Company slug](https://docs.envoapi.com/api/operations/getsimilarcompaniesbyslug.md) | `/v1/companies/similar/by-slug` | `slug=microsoft`                                  |
| [Company URL](https://docs.envoapi.com/api/operations/getsimilarcompaniesbyurl.md)   | `/v1/companies/similar/by-url`  | `url=https://www.linkedin.com/company/microsoft/` |

Send one input per request. Use `--data-urlencode` for query values.

## Read the response

`data.companies` contains the recommendations. Here is one company from the
captured Microsoft response, with `logoUrl` omitted:

```json
{
  "slug": "google",
  "companyUrl": "https://www.linkedin.com/company/google",
  "name": "Google",
  "industry": "Software Development"
}
```

* Each company includes its name, slug, LinkedIn URL, industry, and `logoUrl`.
  The logo may be `null`.
* `meta.creditCost` is the number of credits charged for the request.
* An empty `data.companies` list means no recommendations were returned.

All recommendations arrive in one response. There is no pagination; do not
send `offset`, `cursor`, or `limit`.

Use a returned slug with [company lookup](https://docs.envoapi.com/guides/company-lookup.md) to get more
company details. See the [full response example](https://docs.envoapi.com/api/operations/getsimilarcompaniesbyslug.md)
for all fields, or [Errors](https://docs.envoapi.com/guides/errors.md) for help with failed requests.

[Documentation index](https://docs.envoapi.com/llms.txt) · [All endpoints](https://docs.envoapi.com/api/index.md)