ZoomInfo API
Welcome to ZoomInfo's API. ZoomInfo is the leading data intelligence platform for B2B go-to-market teams, presenting a trifecta of the broadest, deepest and highest quality B2B data.
Use the API to query the ZoomInfo database for relevant companies and contacts and enrich the data records in your Customer Relationship Management (CRM), Marketing Automation (MA), and other systems in your organization. The API helps you build out your organization's contact and company records by tapping in-depth information such as technologies used, company attributes, corporate hierarchies, funding details, news alerts and scoops, and more. This deep data enables teams to build sophisticated, refined, and targeted prospect segments, as well as improve campaign list building, prospecting, lead routing, scoring, and territory alignment.
API structure
The ZoomInfo API is a set of HTTPS endpoints you can use to programmatically retrieve and integrate ZoomInfo data into your existing technology stack and workflows. Responses are returned in JSON to support integration with common programming languages and development kits.
The Enterprise API supports searching for and enriching company and contact records, and are comprised as follows:
Standard APIs
- The Search API accepts various input criteria which are used to return Contacts, Companies, Scoops, News and Intent records. The purpose of Search is to cast a wide net, returning a list of records that meet the input criteria. The records returned are previews of the full ZoomInfo profile. Use the Enrich API endpoints to return ZoomInfo's full profile for any record.
- The Enrich API is used to retrieve ZoomInfo's full profile data by matching to known contacts or companies. Use the Enrich endpoints to redeem full profiles returned from Search queries, or enrich your existing database of contacts and companies with ZoomInfo data.
- The Lookup API includes a set of endpoints that return available inputs and outputs for corresponding Search or Enrich requests. Use the Input Lookup endpoints to help select the input criteria supported by the different requests. The Lookup Output endpoints provide a full list of fields returned by each endpoint.
- The Usage API lets you check your current API usage and limits.
Scaling APIs
- The Webhooks API is a set of endpoints that lets you configure webhooks subscriptions to automate the update of records - listening for events you subscribe to, and sending updates securely to your application.
- The Bulk API is a set of endpoints that provide bulk search and redeem capabilities for Contacts and Companies, enabling the search and retrieval of large ZoomInfo Company and Contact datasets at scale through asynchronous batch processes.
WebSights API
The WebSights API identifies anonymous website traffic by resolving IP addresses to return company and ISP profiles and IP Geolocation details.
Compliance API
The Compliance API includes endpoints related to data privacy and opt-out compliance for contacts stored in the ZoomInfo database.
Authentication methods
The API supports the following authentication methods:
- Private Key Infrastructure (PKI)
- Username and password
For both authentication methods, a Java Web Token (JWT) is returned which can be programmatically or manually used to access the API.
Public Key Infrastructure (PKI) authentication
The preferred authentication method is to obtain a Client ID and Private key pair and a public library to programmatically generate a JWT that is valid for one hour. To do this:
- Log in to the ZoomInfo GUI using admin credentials with API access.
- Go to Admin Portal > API and click Generate New Key. You are provided with a Client ID and a Private Key.
- Import a public library that authenticates using this Client ID and Private Key and generates a JWT.
ZoomInfo provides supported PKI authentication libraries for Java, Python and NodeJS in Github.
Username and password authentication
You can use the Authentication endpoint to manually supply your username and password, returning a JWT that is valid for one hour.
A developer can alternatively import a public library that authenticates a username and password to return a JWT. ZoomInfo provides supported username and password authentication libraries for Java, Python and NodeJS in Github.
Rate and usage limits
The ZoomInfo API uses rate and usage limits tied to the account provisioned for API access. Your API account is provisioned with:
- Rate limits: A limit to the number of requests you can make within a given time period.
- For the Authentication endpoint, the limit is 1 request per second.
- For the Standard APIs, WebSights API, and Compliance API, the limit is 25 requests per second (1500 request per minute).
- For the Scaling APIs, the limit is 33 requests per second (2000 requests per minute)
- Request limits: An overall number of requests you can perform within the current API contract term.
- Record limits: The number of records you are entitled to retrieve within the current API contract term.
You can track usage status using the Usage Lookup endpoint.
You can also track usage using the response headers of each API call (with the exception of the Authentication and Lookup endpoints).
Error handling and troubleshooting
HTTP status codes
The API will return standard classes of HTTP error status codes (4xx client and 5xx server codes) as well as 2xx success codes.
Common errors
The API will also return error messages specific to the request being performed. These error messages indicate a possible reason for a request failure. The following table lists common error messages and potential user actions to resolve.
Unique request IDs
To assist with troubleshooting issues with a specific request, a unique ID called X-Request-Id
is included in the response header of each request.
Release Notes
View the latest release notes for the ZoomInfo API.