📊 Data API - Overview
The Data API provides comprehensive access to search and retrieve various data types from ZoomInfo's extensive database. This powerful API enables you to access rich business intelligence data through a streamlined two-step process.
🔍 Available Data Types
The Data API currently supports the following data types:
- Contact - Individual professional profiles and contact information
- Company - Business profiles and organizational data
- Scoops - Business intelligence and company updates
- Intent - Purchase intent signals and buyer behavior data
- News - Industry news and company-related articles
🚀 API Workflow
The standard flow for using the Data API consists of two main steps:
1. 🔎 Search
Use a variety of parameters to identify specific records you wish to retrieve from the system.
Key Points:
- Counts against your Rate Limit and Request Limit
- Does NOT count against your Record Limit or Credits
- Helps you identify the exact records you need before enrichment
2. 💎 Enrich
Once you've identified the desired record, use the appropriate Enrich endpoint to retrieve detailed information.
Features:
- Specify the exact record using unique ID (recommended)
- Choose specific fields to retrieve
- Alternative: Use search parameters similar to Search API
Usage Limits:
- Every enriched record counts against your Record Limit
- First-time retrieval within 12 months charges a Credit
- See Credit Usage and Limits for more information
📋 HTTP Status Codes
The following status codes apply to all Search and Enrich endpoints within the Data API:
| Status Code | Description | Details |
|---|---|---|
200 | ✅ Success | Request completed successfully |
400 | ❌ Bad Request | Invalid request parameters or format |
401 | 🔐 Unauthorized | Authentication required or invalid credentials |
403 | 🚫 Forbidden | Access denied - insufficient permissions |
429 | ⏱️ Too Many Requests | Rate limit exceeded - please retry later |
💡 Best Practices
- Use unique IDs when calling Enrich endpoints for precise record retrieval
- Monitor your limits to avoid hitting rate or record limits
- Cache results when appropriate to minimize API calls
- Handle errors gracefully with proper retry logic for rate limits
📚 Additional Resources
- API Authentication Guide
- Rate Limiting Documentation
- Credit Usage and Billing
- API Examples and Tutorials
For technical support or questions, please contact ourDeveloper Support Team.