Search companies by industry, size, location or tech
thecompaniesapi.companies.searchSearch companies by industry, size, location, technology or any other attribute filter
- Price
- $0.0019/result제공업체 원가
- 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%5DPreview- Uses platform quota
- Synchronous response
- Reads public data
파라미터
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
| 파라미터 | 유형 | 필수 | 설명 | 예시 |
|---|---|---|---|---|
| 쿼리 파라미터 | ||||
page | 정수 | 선택 | 1-based page number, default 1 | |
size | 정수 | 선택 | results per page, 1-100, default 10 — THIS IS THE PRICE DIAL: 1 credit per company returned | 1 |
query | 문자열 | 필수 | 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 | 문자열 | 선택 | extra free-text match on company name or domain | |
sortKey | 문자열 | 선택 | field to sort by, e.g. meta.score, about.name | |
actionId | 정수 | 선택 | scope the search to a saved action | |
sortOrder | 문자열 | 선택 | asc | desc | |
simplified | 불리언 | 선택 | reduced records for ZERO credits — always preview a new query this way before paying for it | true |
sortFields | array[object] | 선택 | multiple sort criteria, stringified and URL-encoded | |
searchFields | array[string] | 선택 | which fields `search` applies to, e.g. domain, name | |
domainsToExclude | 문자열 | 선택 | comma-separated domains to drop from the results | |
linkedinToExclude | 문자열 | 선택 | comma-separated LinkedIn URLs to drop | |
- 쿼리 파라미터
page정수선택1-based page number, default 1
size정수선택results per page, 1-100, default 10 — THIS IS THE PRICE DIAL: 1 credit per company returned
예시:
1query문자열필수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문자열선택extra free-text match on company name or domain
sortKey문자열선택field to sort by, e.g. meta.score, about.name
actionId정수선택scope the search to a saved action
sortOrder문자열선택asc | desc
simplified불리언선택reduced records for ZERO credits — always preview a new query this way before paying for it
예시:
truesortFieldsarray[object]선택multiple sort criteria, stringified and URL-encoded
searchFieldsarray[string]선택which fields `search` applies to, e.g. domain, name
domainsToExclude문자열선택comma-separated domains to drop from the results
linkedinToExclude문자열선택comma-separated LinkedIn URLs to drop
코드 예제
$TOOLSWITCH_KEY를 콘솔에서 생성한 키로 바꾸세요.
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());게이트웨이 API는 미리보기 버전이며 URL과 인증 방식이 변경될 수 있습니다. 예제 매개변수는 샘플 데이터입니다. 호출 요금은 $0.0019/result이며 서비스 수수료가 포함되어 있습니다.