Discover companies by location, size, industry or revenue
predictleads.companies.discoverReturns a list of companies filtered by their location and size, ordered by last updated date.
- Price
- $0.04/resultAt provider cost
- Success rate
- 100%Last 30 days · 35 calls
- Latency p50
- 945 msp95 5.8 s
- Last verified
- Aug 20, 2026Verified working
GEThttps://toolswitch.dev/v1/tools/predictleads.companies.discover?limit=1Preview- Uses platform quota
- Synchronous response
- Reads public data
Parameters
returns an ESTIMATED count, not an exact one. Always set an explicit small `limit` first — the default of 30 bills 30 credits
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| Query parameters | ||||
page | integer | Optional | 1-based; omitting it drops meta.count for performance | |
limit | integer | Optional | default 30, max 1000 — THIS IS THE PRICE DIAL: 1 credit per company returned | 1 |
sizes | array[string] | Optional | comma-separated company size buckets, or repeated sizes[]= | 11-50 |
industry | string | Optional | free-text industry | Retail |
location | string | Optional | country name, or US state name/abbreviation | United States |
naics_codes | array[string] | Optional | comma-separated NAICS codes | |
revenue_range_low | integer | Optional | minimum annual revenue in USD | 1000000 |
revenue_range_high | integer | Optional | maximum annual revenue in USD | 100000000 |
- Query parameters
pageintegerOptional1-based; omitting it drops meta.count for performance
limitintegerOptionaldefault 30, max 1000 — THIS IS THE PRICE DIAL: 1 credit per company returned
Example:
1sizesarray[string]Optionalcomma-separated company size buckets, or repeated sizes[]=
Example:
11-50industrystringOptionalfree-text industry
Example:
RetaillocationstringOptionalcountry name, or US state name/abbreviation
Example:
United Statesnaics_codesarray[string]Optionalcomma-separated NAICS codes
revenue_range_lowintegerOptionalminimum annual revenue in USD
Example:
1000000revenue_range_highintegerOptionalmaximum annual revenue in USD
Example:
100000000
Code samples
Replace $TOOLSWITCH_KEY with the key you created in the console.
curl -X GET 'https://toolswitch.dev/v1/tools/predictleads.companies.discover?limit=1' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/predictleads.companies.discover?limit=1",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/predictleads.companies.discover?limit=1", {
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());This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.04/result, including the service fee.