Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

ZoomInfo Bulk API

Use the Bulk APIs to search, retrieve, and enrich large ZoomInfo company and contact datasets through asynchronous batch processes.With 20x more records than Contact and Company Search and 400x more records than the Contact and Company Enrich, you can leverage Bulk APIs for data ingestion and enrichment at scale.**Bulk Search API**With the Bulk Search API you can:* Search for up to 200K records with a single search query* Preview or redeem up to 500 records per page Two job types are available with the Bulk Search APIs:* The Preview job type returns a company or contact search results preview to help identify records best suited for enrichment. Credits are not charged for the Preview job type.* The Redeem job type enables data retrieval for ingestion, returning selected output fields for a given contact or company. A credit is charged for each unique record that is redeemed. When you submit a search request, an asynchronous job is started, and a job_id is instantly returned. You can use the job_id to check the status of the job and retrieve results.**Bulk Enrich API**With the Bulk Enrich API you can:* Enrich up to 10K records in a single job* Retrieve up to 500 results per page When you submit an enrich request, an asynchronous job is started, and a job_id is instantly returned. You can use the job_id to check the status of the job and enrich results.**Rate Limiting*** You can have up to 5 "active" jobs (Jobs that are in progress are active jobs. Once a job is completed, you can proceed to creating another job)* You can create up to 1 job per second* Each job you create expires after 24 hours

ZoomInfo Bulk API is one of 23 APIs that ZoomInfo publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 168 JSON Schema definitions.

Tagged areas include Bulk. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 168 JSON Schemas.

This API exposes 6 operations across 6 paths, and defines 15 schemas. It is described by OpenAPI 3.1.0, at version 1.0.

Requests are made against a single base URL, https://api.zoominfo.com.

6 operations 6 paths 15 schemas 6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0
Server
https://api.zoominfo.com
Authentication
HTTP Bearer, HTTP Bearer
Resource Areas
1

Authentication & Security 2

ZoomInfo Bulk API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (httpBearer). It accepts HTTP bearer tokens (JWT) (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — JWT token obtained from the /authenticate endpoint

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 6 POST. Each is listed below with its method, path, parameters, and response codes.

Bulk 6

Use the Bulk APIs to search, retrieve, and enrich large ZoomInfo company and contact datasets through asynchronous batch processes. With 20x more records than Contact and Company…

POST
/bulk/search/contact
Zoominfo Bulk Contact Search
BulkContactSearch body → 200
POST
/bulk/search/company
Zoominfo Bulk Company Search
BulkCompanySearch body → 200
POST
/bulk/enrich/contact
Zoominfo Bulk Contact Enrich
BulkContactEnrich body → 200
POST
/bulk/enrich/company
Zoominfo Bulk Company Enrich
BulkCompanyEnrich body → 200
POST
/bulk/job/status
Zoominfo Bulk Job Status
BulkJobStatus body → 200
POST
/bulk/job/results
Zoominfo Bulk Job Results
BulkJobResults body → 200

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are BulkJobStatus (7 properties), BulkCompanySearchRequest (3 properties), Query (2 properties), BulkJobResultsRequest (2 properties). Each schema is shown below with its type and property counts.

BulkJobStatus
object
7 properties 7 required
BulkContactSearch-Preview
object
1 property 1 required
BulkContactSearchRequest
object
2 properties 2 required
BulkContactEnrichRequest
object
2 properties 2 required
MatchPersonInput1
object
1 property 1 required
BulkJobResultsRequest
object
2 properties 2 required
BulkCompanySearchRequest
object
3 properties 3 required
BulkCompanyEnrichRequest
object
2 properties 2 required
BulkCompanyEnrich
object
1 property 1 required
BulkCompanySearch-Preview
object
1 property 1 required
Query
object
2 properties 2 required
BulkJobStatusRequest
object
1 property 1 required
MatchCompanyInput3
object
1 property 1 required
Query1
object
1 property 1 required
BulkContactEnrich
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zoominfo-bulk-api-openapi.yml Raw ↑

Other APIs ZoomInfo publishes across the network.

ZoomInfo Authentication API
ZoomInfo Company Enrich API
ZoomInfo Company Location Enrich API
ZoomInfo Company Master Data Enrich API
ZoomInfo Company Search API
ZoomInfo Compliance API API
ZoomInfo Contact Enrich API
ZoomInfo Contact Search API
ZoomInfo Corporate Hierarchy Enrich API
ZoomInfo Hashtags Enrich API
ZoomInfo Intent Enrich API
ZoomInfo Intent Search API