How to build a company search engine with our API

Introduction

Want to build a powerful company search engine like the one we offer? Our API makes it simple. In this guide, you'll learn:

How to use the
Search companies with criterias
endpoint for powerful search capabilities.
How our segmentation system works to filter our database.
What company attributes you can search and filter by.
Code examples in multiple languages to get you started.
Pricing and usage details.


Ciscocisco.com	technology information and internet networking security collaboration computing ai industrial iot cloud technology information and media communications infrastructure	Over 10,000 employees	Over $1 billion	Public Company	Over 1 billion	United States North America	San Jose Santa Clara County, California	1984	---	---	---	High (93)	a month ago
Viatrisviatris.com	pharmaceutical manufacturing healthcare medical equipment manufacturing medical practices medical and diagnostic laboratories research services manufacturing it services and it consulting it system data services it system design services	Over 10,000 employees	Over $1 billion	Public Company	10M - 50M	Germany Europe	Bad Homburg vor der Höhe Hochtaunuskreis, Hesse	1968		---	---	High (93)	7 months ago
Whirlpoolwhirlpoolcorp.com	appliances electrical and electronics manufacturing home appliance manufacturing consumer electronics manufacturing kitchen appliances manufacturing laundry appliances manufacturing smart home technology smart appliances appliance manufacturing airports brand leadership	Over 10,000 employees	Over $1 billion	Public Company	10M - 50M	United States North America	Benton Harbor Berrien County, Michigan	1911		---	---	High (91)	7 months ago
AESaes.com	renewable energy power generation renewable energy equipment manufacturing renewable energy semiconductor manufacturing services for renewable energy solar electric power generation wind electric power generation energy storage energy transmission energy storage systems armazenamento de energia	1,000 to 5,000 employees	Over $1 billion	Public Company	10M - 50M	Brazil South America	Barueri Região Metropolitana de São Paulo, São Paulo	1981		---	---	High (90)	7 months ago
Intesa Sanpaolointesasanpaolo.com	banking financial services investment banking credit intermediation insurance agencies and brokerages personal finance technology asset management banking services capital markets corporate banking	Over 10,000 employees	Over $1 billion	Public Company	Over 1 billion	Italy Europe	Albairate Milan, Lombardy	2007	---	---	---	High (90)	6 days ago

How it works

Our company search endpoint

Search companies with criterias

provides powerful search capabilities through a simple GET request. It returns a customizable number of matching companies based on your search criteria.

You can also easily navigate between result pages, sort companies by any attribute and combine multiple filters together.

Each company returned in the full response costs 1 credit. You can browse our complete pricing plans to find the best option for your needs

Use the simplified=true parameter to get a lightweight version of company data. Simplified responses are free and don't consume any credits. They are perfect for displaying search result previews or lists.

GET

https://api.thecompaniesapi.com/v2/companies

The query parameter for the

Search companies with criterias

endpoint is an array of conditions. Each condition is an object with the following properties:

attribute: The attribute you want to filter by (e.g., about.industries, about.totalEmployees, finances.revenue). Refer to the API endpoint documentation for a full list of available attributes.
operator: Logical operator to combine the values. Use and to require all values to be true, or or to require at least one value to be true.
sign: The comparison sign for the condition. Options include:
- equals: Matches if the specified value is included in the attribute value.
- exactEquals: Matches if the specified value exactly matches the attribute value.
- notEquals: Matches if the specified value is not included in the attribute value.
values: An array of values to match against the attribute (e.g., ["saas", "software"] for the about.industries attribute).

An example is worth a thousand words:

[
  // Match companies in both SaaS AND software industries
  {
    "attribute": "about.industries",
    "operator": "and",
    "sign": "equals",
    "values": ["saas", "software"]
  },
  // Match companies with revenue NOT in the 50m-100m range
  {
    "attribute": "finances.revenue",
    "operator": "or",
    "sign": "notEquals",
    "values": ["50m-100m"]
  }
]

This query must be converted into a string and URL-encoded before being used in the query parameter of the endpoint.

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%5D&token=XXXXXX

The endpoint that defines your search criteria.

API tokens

Before using The Companies API, you'll need an API token. Make sure to read our documentation to properly authenticate your requests.

It seems you don't have any API tokens yet. You can create one in the following block.

Select or create a token

Code examples

Here are code examples in multiple languages to help you get started with building your own company search engine.

Select your favorite language:

JavaScript

PHP

Python

async function searchCompanies(query, page = 1, size = 25) {
  const baseUrl = 'https://api.thecompaniesapi.com/v2/companies';

  const params = new URLSearchParams({
    query: JSON.stringify(query),
    page,
    size
  });

  const url = `${baseUrl}?${params.toString()}`;

  const response = await fetch(url, {
    headers: {
      Authorization: `Basic ${process.env.YOUR_API_TOKEN}`,
    },
  });

  if (!response.ok) {
    throw new Error(`API request failed: ${response.status}`);
  }

  return await response.json();
}

// Retrieve SaaS companies with revenue between 50m and 100m
const query = [
  { "attribute": "about.industries", "operator": "and", "sign": "equals", "values": ["saas"] },
  { "attribute": "finances.revenue", "operator": "or", "sign": "notEquals", "values": ["50m-100m"] }
]

await searchCompanies(query)

How to build a company search engine with our API

Need help implementing your use case?