ZoomInfo Companies API lists companies from the public ZoomInfo company directory. Filter by industry, by country, or by both. Each page has 20 companies. Each company has its name, website domain, ZoomInfo profile link, location (country, state, city), industries, employee count and revenue.
Read the valid industry slugs from the Industries API and the country slugs from the Locations API (listing_slug). The United States is usa.
Page through the results with page (1 to 500, so up to 10,000 companies per filter combination). Page N always holds the companies of page N. Combine industry and country to go deeper than 10,000. Filters are always honoured: a response never holds a company outside the requested industry or country.
revenue_usd is in US dollars. employees and revenue_usd are null when ZoomInfo shows no value.
Coverage: this API reads the public directory lists only. ZoomInfo company profiles, executives, people and search are not covered. profile_url is a link for reference and is not fetched.
Each page is one lookup and one credit. Failed requests are never billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
3 optional filters available.
string
Optional
Industry slug, for example software or health-services. Required if country is empty. Example: software.
example
string
Optional
Country slug from the Locations API, for example germany, united-kingdom or usa. Required if industry is empty. Example: germany.
US
integer
Optional
One-based page number, 1 to 500 (default 1). Example: 2.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"count": 1,
"filters": {
"country": "germany",
"industry": "finance"
},
"companies": [
{
"name": "Haspa",
"domain": "www.haspa.de",
"location": {
"city": "Hamburg",
"state": "Hamburg",
"country": "Germany"
},
"employees": 4400,
"company_id": "429860526",
"industries": [
{
"code": "finance.banking?70",
"name": "Banking",
"slug": null,
"score": 70,
"primary": true
},
{
"code": "finance?70",
"name": "Finance",
"slug": null,
"score": 70,
"primary": true
}
],
"profile_url": "https://www.zoominfo.com/c/hamburger-sparkasse-ag/429860526",
"revenue_raw": "66471936",
"revenue_usd": 66471936000,
"employees_raw": "4400"
}
],
"pagination": {
"page": 2,
"has_next": true,
"max_page": 500,
"per_page": 20,
"total_results": 55812
}
},
"meta": {
"billable": true,
"endpoint_family": "companies"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Invalid Page
The result page does not exist. Use a lower page number. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "companies"
},
"error": {
"code": "INVALID_PAGE",
"message": "This result page does not exist. Use a lower page number."
},
"success": false
}Invalid Filter
ZoomInfo does not know the industry or country. Read the valid values from the industries and locations endpoints. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "companies"
},
"error": {
"code": "INVALID_FILTER",
"message": "The industry or country is not known. Read the valid values from the industries and locations endpoints."
},
"success": false
}Validation Error
A parameter is missing or has an invalid value. This response is not billable.
{
"errors": {
"industry": [
"The industry field is required when country is not present."
]
},
"message": "The request validation failed"
}Upstream Unavailable
ZoomInfo could not be reached or returned a page that does not match the request. This response is not billable and is retryable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "companies"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "ZoomInfo could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.