ZoomInfo Top Lists API returns a public ZoomInfo top company list for an industry, a country, or both. Each list holds the top companies with description, website, phone, founding year, stock symbol, headquarters, industries, employee count and revenue.
The response also has the list title, similar lists with their companies, and the FAQs of the page as plain text.
Use an industry slug from the Industries API and a two-letter country code (US, DE, GB) from the Locations API. The list matches the request: the response is never the list of another industry or country.
Coverage: only public list data is returned. Company profiles, executives, people and search are not covered.
Each list 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.
2 optional filters available.
string
Optional
Industry slug, for example software. Required if country is empty. Example: software.
example
string
Optional
Two-letter country code, for example US or DE. Required if industry is empty. Example: US.
US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"faqs": [
{
"answer": "Microsoft's revenue is $331.8B",
"question": "What is Microsoft's revenue?"
}
],
"count": 1,
"title": "Top Software companies in United States - October, 2026",
"filters": {
"country": "US",
"industry": "software"
},
"companies": [
{
"name": "Microsoft",
"phone": "(425) 882-8080",
"stock": "NASDAQ: MSFT",
"domain": "www.microsoft.com",
"founded": 1975,
"location": {
"city": "Redmond",
"state": "Washington",
"country": "United States",
"country_code": "US"
},
"employees": 223000,
"company_id": "24904409",
"industries": [
{
"code": null,
"name": "Software",
"slug": "software",
"score": null,
"primary": false
}
],
"legal_name": "Microsoft",
"description": "Microsoft Corp. engages in the provision of developing and marketing software and hardware services.",
"profile_url": "https://www.zoominfo.com/c/microsoft/24904409",
"revenue_usd": 331839000000
}
],
"similar_lists": [
{
"country": "GB",
"industry": "software",
"companies": [
{
"name": "Sage",
"domain": "www.sage.com",
"company_id": "65012653",
"profile_url": "https://www.zoominfo.com/c/sage-group-plc/65012653"
}
]
}
]
},
"meta": {
"billable": true,
"endpoint_family": "top_lists"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
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": "top_lists"
},
"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": "top_lists"
},
"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.