The Companies API LogoThe Companies API Logo
APIUse casesCompanies
LoginLogin
Get started
Authentication
Errors
Rate limits
Webhooks
Datapoints
Companies
Enrich from domain
Enrich from email
Enrich from social network
Count companies
Search companies
Search by name
Search by prompt
Search similar
Ask company
Fetch context
Find email patterns
Fetch analytics
Export analytics
Industries
Search industries
Find similar industries
Lists
Fetch lists
Create list
Fetch companies
Toggle companies
Locations
Search cities
Search counties
Search countries
Search states
Search continents
Actions
Request action
Fetch actions
Teams
Fetch team
Technologies
Search technologies
Utilities
API health
OpenAPI spec
Get started
Authentication
Errors
Rate limits
Webhooks
Datapoints
Companies
Enrich from domain
Enrich from email
Enrich from social network
Count companies
Search companies
Search by name
Search by prompt
Search similar
Ask company
Fetch context
Find email patterns
Fetch analytics
Export analytics
Industries
Search industries
Find similar industries
Lists
Fetch lists
Create list
Fetch companies
Toggle companies
Locations
Search cities
Search counties
Search countries
Search states
Search continents
Actions
Request action
Fetch actions
Teams
Fetch team
Technologies
Search technologies
Utilities
API health
OpenAPI spec

Search companies

Search and filter through millions of companies with more than 50 segmentation criteria.
GET
https://api.thecompaniesapi.com/v2/companies/search
1 credit per company
POST
https://api.thecompaniesapi.com/v2/companies/search
1 credit per company

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

Query parameters
querystring (required)

An array of conditions the companies must match.

Make sure this parameter is stringified and encoded.

GET
https://api.thecompaniesapi.com/v2/companies?query=%5B%7B%22attribute%22%3A%22about.industries%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22retail%22%2C%22internet%22%2C%22services%22%5D%7D%2C%7B%22attribute%22%3A%22locations.headquarters.country.code%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22us%22%2C%22fr%22%2C%22gb%22%5D%7D%5D&token=XXXXXX
The endpoint that defines your search criteria.
domainsToExcludestring (optional)

A list of comma-separated domains to exclude from the results.

/companies?domainsToExclude=amazon.com,pearson.com

linkedinToExcludestring (optional)

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

pagenumber (optional)

The page to fetch (default to 1).

/companies?page=1

searchstring (optional)

An additional search query applied to the company name or domain.

/companies?search=amazon

searchFieldsarray (optional)

Define the fields to search.

/companies?searchFields[]=domain&searchFields[]=name

Possible values

about.name
domain.domain
simplifiedboolean (optional)

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

false
true
sizenumber (optional)

The number of companies to be returned (between 1 and 100). Default to 10.

/companies?size=10

sortFieldsstring (optional)

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.

sortKeystring (optional)

The field to sort the results.

…/companies?sortKey=meta.score

Possible values

about.businessType
about.industries
about.industry
about.name
about.totalEmployees
about.yearFounded
analytics.monthlyVisitors
apps
codes.naics
codes.sic
Show 13 more
sortOrderstring (optional)

The order to sort the results.

…/companies?sortOrder=asc

Possible values

asc
desc
Response schema
companiesarray

The companies that match your conditions.

Browse all datapoints
metaobject

The metas information.

queryarray

The conditions the companies must match.

Code examples
Select your favorite language:
C#

Go

Java

JavaScript
SDK

PHP

Python

Ruby

Rust

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

Count companies matching your query

Count the number of companies matching your query in our database.

Search companies by name

Provide a company name and get all the companies that match it.

A glowing background image to highlight the titleA glowing background image to highlight the title
© 2025 The Companies API
  • Updates
  • Terms
  • Privacy
  • FAQ
  • Status

Fast-growing SaaS companies with remote teams