The Companies APIDonnées d’entrepriseEnrichment

Search companies by industry, size, location or tech

thecompaniesapi.companies.search

Search companies by industry, size, location, technology or any other attribute filter

Price: $0.0019/resultAu prix du fournisseur
Success rate: 99,7 %Last 30 days · 3 566 calls
Latency p50: 428 msp95 1.1 s
Last verified: —Not verified yet

GEThttps://toolswitch.dev/v1/tools/thecompaniesapi.companies.search?size=2&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%22fintech%22%5D%7D%5D

Preview

Try onlineProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Paramètres

POST /companies takes the identical fields as a JSON body, which is easier when the condition array is long. `searchFields` accepts about.name and domain.domain. Always set an explicit small `size` — the default of 10 bills for 10 companies. GET /companies/count returns just the match count and is widely treated as free, though that is not published

Paramètre	Type	Obligatoire	Description	Exemple
Paramètres de requête
`page`	entier	Facultatif	1-based page number, default 1
`size`	entier	Facultatif	results per page, 1-100, default 10 — THIS IS THE PRICE DIAL: 1 credit per company returned	`1`
`query`	chaîne	Obligatoire	a stringified, URL-encoded ARRAY of conditions, each {attribute, operator: 'and'\|'or', sign: 'equals'\|…, values: [...]}	`[{"attribute":"about.industries","operator":"or","sign":"equals","values":["software"]}]`
`search`	chaîne	Facultatif	extra free-text match on company name or domain
`sortKey`	chaîne	Facultatif	field to sort by, e.g. meta.score, about.name
`actionId`	entier	Facultatif	scope the search to a saved action
`sortOrder`	chaîne	Facultatif	asc \| desc
`simplified`	booléen	Facultatif	reduced records for ZERO credits — always preview a new query this way before paying for it	`true`
`sortFields`	array[object]	Facultatif	multiple sort criteria, stringified and URL-encoded
`searchFields`	array[string]	Facultatif	which fields `search` applies to, e.g. domain, name
`domainsToExclude`	chaîne	Facultatif	comma-separated domains to drop from the results
`linkedinToExclude`	chaîne	Facultatif	comma-separated LinkedIn URLs to drop

Paramètres de requête
pageentierFacultatif
1-based page number, default 1
sizeentierFacultatif
results per page, 1-100, default 10 — THIS IS THE PRICE DIAL: 1 credit per company returned
Exemple : 1
querychaîneObligatoire
a stringified, URL-encoded ARRAY of conditions, each {attribute, operator: 'and'|'or', sign: 'equals'|…, values: [...]}
Exemple : [{"attribute":"about.industries","operator":"or","sign":"equals","values":["software"]}]
searchchaîneFacultatif
extra free-text match on company name or domain
sortKeychaîneFacultatif
field to sort by, e.g. meta.score, about.name
actionIdentierFacultatif
scope the search to a saved action
sortOrderchaîneFacultatif
asc | desc
simplifiedbooléenFacultatif
reduced records for ZERO credits — always preview a new query this way before paying for it
Exemple : true
sortFieldsarray[object]Facultatif
multiple sort criteria, stringified and URL-encoded
searchFieldsarray[string]Facultatif
which fields `search` applies to, e.g. domain, name
domainsToExcludechaîneFacultatif
comma-separated domains to drop from the results
linkedinToExcludechaîneFacultatif
comma-separated LinkedIn URLs to drop

Exemples de code

Remplacez $TOOLSWITCH_KEY par la clé créée dans la console.

Preview

curl -X GET 'https://toolswitch.dev/v1/tools/thecompaniesapi.companies.search?size=2&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%22fintech%22%5D%7D%5D' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/thecompaniesapi.companies.search?size=2&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%22fintech%22%5D%7D%5D",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/thecompaniesapi.companies.search?size=2&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%22fintech%22%5D%7D%5D", {
  method: "GET",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

Cette API de passerelle est en préversion ; son URL et son authentification peuvent changer. Les paramètres de l’exemple sont des données fictives. Les appels sont facturés à $0.0019/result, frais de service inclus.