Search companies by keyword

Find LinkedIn companies by keyword, location, industry, size, and job availability.

Use GET /v1/companies/search to find companies by name or other keywords. Add filters to narrow the results.

Search for companies

Replace YOUR_API_KEY with your API key, then run:

curl --get 'https://api.envoapi.com/v1/companies/search' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data-urlencode 'keywords=Microsoft' \
  --data-urlencode 'offset=0'

Only keywords is required. Use 1–120 characters.

Add filters

Parameter	Example	Meaning
`location`	`geo_6yITcz`	Has a location in the United States
`industry`	`industry_C1dRf`	Software Development
`companySize`	`D,E`	51–500 employees
`hasJobs`	`true`	Has job listings on LinkedIn

For example, find software companies with a US location, 51–500 employees, and job listings:

curl --get 'https://api.envoapi.com/v1/companies/search' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data-urlencode 'keywords=software' \
  --data-urlencode 'location=geo_6yITcz' \
  --data-urlencode 'industry=industry_C1dRf' \
  --data-urlencode 'companySize=D,E' \
  --data-urlencode 'hasJobs=true'

Values within one filter match any listed value. Different filters must all match. For example, companySize=D,E accepts size D or E, while industry also requires the selected industry.

Location can match a branch or office, not just the headquarters. hasJobs accepts only true; leave it out to include companies with or without jobs.

Find location and industry IDs

Filter	Where to get the ID
`location`	Location search: `data.locations[].id`
`industry`	Industry search: `data.industries[].id`

Copy IDs unchanged. Names such as United States or Software Development cannot be used as filter IDs. Each filter accepts up to 10 unique IDs, separated by commas. Send each parameter once and leave out unused filters.

Company size codes

Use uppercase codes. Separate multiple sizes with commas, such as D,E.

Code	Employees
`B`	1–10
`C`	11–50
`D`	51–200
`E`	201–500
`F`	501–1,000
`G`	1,001–5,000
`H`	5,001–10,000
`I`	10,001+

These ranges come from LinkedIn; they are not verified employee counts.

Read the response

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

{
  "name": "Microsoft",
  "slug": "microsoft",
  "linkedinUrl": "https://www.linkedin.com/company/microsoft",
  "description": "Software Development • Redmond, Washington",
  "summary": "29M followers"
}

summary and logoUrl may be null.
No matches returns data.companies: [].
meta.creditCost is the number of credits charged for the request.

Use a returned slug with company lookup to get more company details. Some search slugs contain characters that company lookup does not yet accept, including non-English letters, periods, ampersands, or a leading underscore.

See the full response example for all fields.

Get the next page

Start with offset=0, or leave it out. This captured meta.paging example shows that the next page starts at 10:

{
  "offset": 0,
  "limit": 10,
  "returned": 10,
  "hasMore": true,
  "nextOffset": 10
}

Set offset to meta.paging.nextOffset and keep the same keywords and filters. Stop when hasMore is false. Accepted offsets are 0–10000; do not request an offset above 10000.

The API sets the page size; do not send limit or count. Each successful page uses credits, including empty pages. See Pagination and Errors for more help.

If you already have a website domain, use company domain search with domain=microsoft.com. That endpoint accepts domain and offset, without keyword-search filters.