General Overview

The ZoomInfo GTM API gives applications and AI agents structured access to ZoomInfo's B2B intelligence: companies, contacts, intent signals, scoops, news, usage data, and lookup values for valid filters.

Use the API when you need to:

• Search for companies or contacts that match a target profile.
• Enrich known companies or contacts with full ZoomInfo data.
• Resolve valid filter values before search.
• Monitor credit usage and usage limits.
• Build custom GTM applications, internal workflows, and agent tools on top of ZoomInfo data.

Base URL:

https://api.zoominfo.com/gtm

The API is versioned and defined from ZoomInfo's TypeSpec specification. Endpoint schemas, request bodies, response bodies, and field constraints are generated from the same source of truth used by the API reference.

Core Concepts

Search before enrich

Search endpoints return ranked matches and stable ZoomInfo identifiers. Enrich endpoints return full records and may consume credits. For most workflows:

1. Use Lookup to resolve valid filter values.
2. Use Search to find matching companies, contacts, intent signals, or events.
3. Use Enrich only for records that need full detail.
4. Use the returned ZoomInfo IDs in later calls instead of display names.

Lookup values reduce bad calls

Many API filters use controlled values: industries, regions, job functions, management levels, departments, technologies, intent topics, and other ZoomInfo taxonomies. Use Lookup before Search when the user provides natural-language criteria.

Credits are tied to enrichment

Search, lookup, and discovery-style calls are generally free. Enrichment calls may consume bulk data credits when a record is enriched for the first time within your organization's Records Under Management window. Account and contact research actions may consume AI action credits.

Entitlements apply to every call

API and MCP calls respect your ZoomInfo package, user entitlements, scopes, and credit access. The API does not return fields or datasets your account is not entitled to access.

Common Workflows

Build a target account list

Lookup industries, regions, employee ranges, and technologies
-> Search Companies by firmographic and technographic criteria
-> Enrich selected companies
-> Export or activate selected records

Example:

{
  "workflow": "build_target_accounts",
  "criteria": {
    "industry": "Computer Software",
    "employeeCount": { "min": 200, "max": 1000 },
    "region": "United States",
    "technologies": ["Salesforce", "Snowflake"]
  },
  "limit": 50
}

Build a contact list for outbound

Search Companies
-> Search Contacts at matched companies
-> Enrich selected contacts
-> Return name, title, company, email, phone, accuracy score, and source metadata

Research an account

Resolve company
-> Enrich company
-> Search relevant contacts
-> Pull intent, scoops, and news
-> Synthesize an account brief

Use ZoomInfo inside an AI agent

ZoomInfo supports agent access through the ZoomInfo MCP server and custom MCP-compatible clients. Use MCP when an AI client needs to discover tools, inspect schemas, and call ZoomInfo data tools directly from a conversation or agent workflow.

See:

• ZoomInfo MCP Overview
• Custom MCP Integration
• MCP Tools Reference
• Credits & Billing
• Security & Data

API Reliability and Limits

Default rate limit: 25 requests per second.

Premium add-on: 30 requests per second.

Premium+ add-on: 35 requests per second.

All clients should implement exponential backoff for 429 and 5xx responses.

Next Steps

• Authenticate with OAuth 2.0.
• Review scopes.
• Read pagination, batching, and bulk guidance.
• Review rate limits and credit usage.
• Try a search -> enrich workflow.
• For AI agents, review the MCP integration reference.