Search companies
Do you need to search companies located in a given country for a specific industry and that use a particular technology?
Combine our conditions and create powerful search queries to identify them.
To help you create your first conditions, we have designed a generator above.
We would also be glad to help you if you need it.
Want to build a powerful company search engine on your application?
We wrote a guide to help you do that.
Signup to access all the features
Get your API token and start implementing the API in your product with 500 free credits.
No credit card required
An array of conditions the companies must match.
Make sure this parameter is stringified and encoded.
A list of comma-separated domains to exclude from the results.
/companies?domainsToExclude=amazon.com,pearson.com
A list of comma-separated LinkedIn URLs to exclude from the results.
/companies?linkedinToExclude=https://www.linkedin.com/company/amazon,https://www.linkedin.com/company/pearson
The page to fetch (default to 1).
/companies?page=1
An additional search query applied to the company name or domain.
/companies?search=amazon
Define the fields to search.
/companies?searchFields[]=domain&searchFields[]=name
Possible values
Return a simplified version of the companies (no credits deducted but limitation are applied on the free plan). It is useful for previewing the data before fetching the full version. Default to false.
/companies?simplified=true
Possible values
The number of companies to be returned (between 1 and 100). Default to 10.
/companies?size=10
An array of multiple fields combined to sort the results.
…/companies?sortFields=%5B%7B%22key%22%3A%22meta.score%22%2C%22order%22%3A%22desc%22%7D%5D
Make sure this parameter is stringified and encoded.
The field to sort the results.
…/companies?sortKey=meta.score
Possible values
The order to sort the results.
…/companies?sortOrder=asc
Possible values
The metas information.
The conditions the companies must match.
import createClient from '@thecompaniesapi/sdk'
const tca = createClient({ apiToken: 'YOUR_API_TOKEN' })
// Search companies by industry and size
await tca.searchCompanies({
query: [
{ attribute: 'about.industries', operator: 'or', sign: 'equals', values: ['computer-software'] },
{ attribute: 'about.totalEmployees', operator: 'or', sign: 'equals', values: ['10-50'] }
],
size: 25
})
const companies = response.data.companies // Companies that match the query
const meta = response.data.meta // Meta information