ZoomInfo API in 2026: Access, Documentation, Credits and Rate Limits

Split illustration contrasting a locked enterprise contract icon with a live credit meter, terminal window, and MCP connector representing ZoomInfo's two API access paths

ZoomInfo API in 2026: Access, Documentation, Credits and Rate Limits

Disclosure: This article is published by Datamagnet, which sells a profile data API. ZoomInfo details below come from ZoomInfo's own documentation at docs.gtm.ai, its product pages and the GTM AI pricing page, all checked on November 17, 2026. Contract values come from Vendr, a third-party software-buying platform, and are labeled as such.

You can get ZoomInfo API access in two ways in 2026. GTM AI is self-serve: sign up free with 1,000 data credits and 1,000 AI credits, then create an app in its Developer tab. Enterprise customers create apps in ZoomInfo's Developer Portal under a sales contract. Both use OAuth 2.0 and the same API at https://api.zoominfo.com/gtm.

ZoomInfo API factValueSource
Access pathsGTM AI self-serve, or Enterprise via salesZoomInfo docs
AuthenticationOAuth 2.0: Client Credentials (server) or Authorization Code with PKCE (user)ZoomInfo docs
Search, lookup, find similarFree (count against rate limits)ZoomInfo docs
Enrich a contact or company1 data credit per new record; free to re-enrich for 12 monthsZoomInfo docs
Data credit price$0.38 at the $1,000 spend tier; 70% off first purchase (limited time)GTM AI pricing
AI credit price$0.05 flatGTM AI pricing
Rate limits5 req/s pay-as-you-go; packages 5, 25 or 35 req/sGTM AI pricing; Rate Limits
MCP serverhttps://mcp.zoominfo.com/mcp, OAuth sign-inZoomInfo docs
CLIgtm, via Homebrew or npmZoomInfo docs

Key Takeaways

  • GTM AI made ZoomInfo's API self-serve: a free signup with 1,000 data and 1,000 AI credits, top-ups from $20, and "no contract, no seat fees."
  • The Enterprise API is still sold through a "Request Demo" page, and apps are created in the Developer Portal.
  • ZoomInfo's current docs live at docs.gtm.ai. The old docs.zoominfo.com address now redirects there, and api-docs.zoominfo.com is titled "ZoomInfo API - Legacy."
  • Search is free. Enrichment costs 1 data credit per new record, and a record is free to re-enrich for 12 months.
  • Rate limits are counted per request, not per record: 5 requests a second on pay-as-you-go, and up to 35 on the Scaling package.

Split illustration contrasting a locked enterprise contract icon with a live credit meter, terminal window, and MCP connector representing ZoomInfo's two API access paths

How Do You Get ZoomInfo API Access in 2026?

There are two routes. GTM AI customers sign up on gtm.ai without a sales call, get 1,000 free data and AI credits, and create an app in its Developer tab. Enterprise customers buy through ZoomInfo sales and create apps in the Developer Portal. Either way you need "a GTM.ai or Enterprise license with API access."

ZoomInfo's app-creation guide spells out both paths. "Enterprise customers" sign in to the Developer Portal at developer.zoominfo.com and select Create App, while "self-serve GTM.ai customers" go to the Developer tab in GTM AI and select Create (ZoomInfo docs, Standard App). The listed prerequisite is "A GTM.ai or Enterprise license with API access."

Access pathHow you get inPricingWhere you create apps
GTM AI (self-serve)Free signup; credits from $20, "no sales call"Published per-credit pricesDeveloper tab in GTM AI
GTM AI EnterpriseTalk to salesAnnual volume-based, custom rate limitsDeveloper Portal
Enterprise API"Request Demo" on zoominfo.comNot publishedDeveloper Portal

GTM AI's pricing page describes the self-serve route as "One tier, no contract, no seat fees," and says "Platform access is always free - MCP, API, and CLI included" (GTM AI pricing).

The Enterprise route has not changed. ZoomInfo's Enterprise API page lists Search and Enrich APIs, Scaling APIs for bulk work, WebSights visitor APIs and a Compliance API, with only a "Request Demo" option and no prices (ZoomInfo, Enterprise API). ZoomInfo's pricing guide also lists API and MCP access among platform add-ons (ZoomInfo).

How Does ZoomInfo API Authentication Work?

ZoomInfo uses OAuth 2.0. Server-to-server integrations use the Client Credentials flow: exchange your app's client ID and secret at the token endpoint for a bearer token. Apps acting for a signed-in user, and all partner apps, use the Authorization Code flow with PKCE. Scopes chosen when you create the app limit which endpoints the token can call.

Creating an app takes a name, an authentication type, redirect URLs (for PKCE only) and a set of API scopes. "Your application will be created immediately," and you receive a Client ID and Client Secret (ZoomInfo docs, Standard App).

For server-to-server access, the token request goes to POST https://api.zoominfo.com/gtm/oauth/v1/token with grant_type=client_credentials. ZoomInfo recommends sending the client ID and secret in an Authorization: Basic header. If you omit scope, "the access token is issued with all scopes configured for the application" (ZoomInfo docs, Client Credentials Flow). The response includes expires_in, and the token is sent as Authorization: Bearer <access_token>.

# 1. Get a token (Client Credentials flow)
curl -X POST https://api.zoominfo.com/gtm/oauth/v1/token \
  -u "$ZI_CLIENT_ID:$ZI_CLIENT_SECRET" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials"

# 2. Enrich up to 25 contacts per call (1 data credit per new record)
curl -X POST https://api.zoominfo.com/gtm/data/v1/contacts/enrich \
  -H "Authorization: Bearer $ZI_TOKEN" \
  -H "Content-Type: application/vnd.api+json" \
  -d '{"data":{"type":"ContactEnrich","attributes":{
        "matchPersonInput":[{"personId":12345}],
        "outputFields":["id","firstName","lastName","jobTitle","email"]}}}'

The request body is built from the Enrich Contacts schema; 12345 is a placeholder ID, not one from ZoomInfo's docs.

Contact search and enrich need the api:data:contact scope, described as "Ability to search and enrich ZoomInfo Contact data" (ZoomInfo API reference). To try calls without writing code, generate a bearer token in your app's list and paste it into the API reference. ZoomInfo warns that these are production requests that "will consume credits" (ZoomInfo docs, Test API Access).

What Endpoints Does the ZoomInfo API Have?

The core is the Data API: Search, Enrich, Lookup and Usage. Search covers contacts, companies, intent, news and scoops. Enrich covers contacts, companies, corporate hierarchy, intent, news, org charts, scoops, technologies and hashtags. ZoomInfo also documents Context, GTM Studio, Marketing, Platform, Agent and Data Quality APIs.

The API reference at docs.gtm.ai groups endpoints by API and version (ZoomInfo API reference). These are the endpoints most integrations start with:

EndpointMethod and pathCreditsNotes
Search ContactsPOST /gtm/data/v1/contacts/searchNonePage size 1 to 100, default 25
Enrich ContactsPOST /gtm/data/v1/contacts/enrich1 per new record1 to 25 contacts per call; no-match records not charged
Usage DataGET /gtm/data/v1/users/usageNot statedReturns your usage and limits
Account / Contact ResearchMCP and CLI research toolsAI creditsOne account or contact per call

Search does not use credits: "this endpoint does not consume any credits nor do contacts returned count towards record limits," though each request counts against request limits (ZoomInfo API reference, Search Contacts). Enrich Contacts accepts 1 to 25 match inputs, using IDs, names, emails, company details and other fields, and returns either a Contact resource or a NoMatch (ZoomInfo API reference, Enrich Contacts). Enrich Companies has the same 25-record cap (ZoomInfo docs, Pagination, Batching and Bulk).

Requests and responses use application/vnd.api+json. The Usage endpoint reports totalLimit, currentUsage and usageRemaining for request, record and unique-ID limits (ZoomInfo API reference, Usage Data). For async work, the Agents API runs agent teams, and ZoomInfo's webhooks page says notifications can fire when "credit thresholds are reached," along with job completion, record changes and new signals (ZoomInfo docs, Webhook and Events).

How Many Credits Does Each ZoomInfo API Call Use?

Search, lookup, find-similar and recommended-contact calls are free. Enriching a company, contact or intent record costs 1 data credit per new record, and the record then stays "under management" for 12 months, so re-enriching it costs nothing. Account and Contact Research use AI credits, about 9 to 12 for an account research run.

ZoomInfo's credit documentation names two pools, bulk data credits and AI action credits (ZoomInfo docs, Credit Usage and Limits). Its rules:

  • Enrichment: "1 bulk data credit per new company record" or contact record.
  • Free calls: Lookup, Search Companies, Search Contacts, Find Similar Companies, Find Similar Contacts and Find Recommended Contacts.
  • Records Under Management: "While a record is under management, it can be enriched again without consuming an additional credit." The window is one year from the first enrichment and applies to the whole organization (GTM AI, Credits).
  • Failed matches: records that come back as no match or with an error code are not charged (ZoomInfo API reference).
Credit typeUsed byPriceSource
Data creditEnrich Companies, Contacts, Intent, Scoops, News$0.38 at the $1,000 spend tierGTM AI pricing
AI creditAccount Research, Contact Research, Update GTM Context$0.05 flat; "~1–20 credits depending on depth"GTM AI pricing
NoneSearch, Lookup, Find Similar, Browse Audiences, GTM ContextFreeZoomInfo MCP tools

The 12-month window favors teams that re-check the same account list. Credits also expire "12 months after they are granted, whether free or purchased" (GTM AI pricing), so a large prepaid block only saves money if you use it within the year.

What Are ZoomInfo's API Rate Limits?

GTM AI's pay-as-you-go tier allows 5 requests a second across 5 apps. ZoomInfo's docs list package limits of 5 requests a second on Builder, 25 on Standard and 35 on Scaling, with hourly and daily caps to match. Enterprise limits are custom. Limits count requests, not records, and every response carries rate-limit headers.

PackageRequests/secondRequests/hourRequests/day
Builder510,800129,600
Standard2554,000648,000
Scaling3575,600907,200

Source: ZoomInfo docs, Rate Limits, checked November 17, 2026. Pay-as-you-go: "5 requests a second across 5 apps" (GTM AI pricing).

ZoomInfo GTM AI Daily Rate Limits by Package Builder package allows 129,600 requests per day. Standard allows 648,000 requests per day. Scaling allows 907,200 requests per day. Source: ZoomInfo Rate Limits documentation, checked November 17, 2026. Builder 129,600 Standard 648,000 Scaling 907,200 Source: ZoomInfo Rate Limits docs, checked 2026-11-17
Daily request cap by GTM AI package. Source: ZoomInfo, checked 2026-11-17.

Every response includes X-RateLimit-Limit-Second, X-RateLimit-Remaining-Second and matching hour and day headers. A 429 adds Retry-After, X-RateLimit-Rejected-Bucket and X-RateLimit-Reset. The older X-RateLimit-Limit and X-RateLimit-Remaining headers are deprecated and will be removed on 2027-01-01 (ZoomInfo docs, Rate Limits), so update any backoff code that reads them.

Because limits count requests, throughput depends on records per request. The Rate Limits page says search returns up to 25 records per request through the direct API and up to 10 through MCP and the CLI. The Search Contacts reference allows page sizes up to 100, so test the size your account actually gets. To raise a limit, ZoomInfo says to contact your account team or email [email protected] with your Tenant ID; changes take effect within 24 hours.

Rate-limit gauge dial nearing its red zone beside a locked enterprise contract price tag icon, representing ZoomInfo's package-based rate limits and quote-only pricing

What Can You Do With the ZoomInfo MCP Server?

ZoomInfo's MCP server at https://mcp.zoominfo.com/mcp lets AI clients such as Claude, ChatGPT, Cursor and VS Code call ZoomInfo data through tools. You sign in with OAuth using your ZoomInfo account or SSO. It needs a GTM AI or Enterprise license, and the same plan, credits and API limits apply as on the REST API.

ZoomInfo lists Claude Code, OpenAI Codex, Cursor, VS Code and Antigravity among coding clients, and Claude.ai, Claude Desktop, ChatGPT and Perplexity as chat apps. Any client "supporting Streamable HTTP and OAuth" works (ZoomInfo docs, Connect to ZoomInfo MCP). In Claude Code, the documented command is claude mcp add --transport http zoominfo https://mcp.zoominfo.com/mcp, then /mcp to sign in.

ZoomInfo asks users to turn model training off in their AI client, because "ZoomInfo prohibits data accessed through MCP to be used for AI model training." Search through MCP returns up to 10 records per request (ZoomInfo docs, Rate Limits).

The tool list mirrors the API's credit rules (ZoomInfo docs, Available MCP Tools). Search Companies, Search Contacts, Lookup, Find Similar, Search Intent, Search Scoops, Browse Audiences and GTM Context are free. Enrich Companies, Enrich Contacts, Enrich Intent, Enrich Scoops and Enrich News use bulk data credits. Account Research, Contact Research and Update GTM Context use AI action credits.

Laptop terminal window connected by a dotted line to a chat-bubble AI agent icon, representing the ZoomInfo MCP server linking B2B data to AI agents

What About the ZoomInfo CLI?

The ZoomInfo CLI, called gtm, installs with brew install zoominfo/gtm-ai/gtm-ai-cli or npm install -g @zoominfo/gtm-ai-cli. Sign-in is OAuth in your browser, with no client ID or secret to paste. It shares the hosted backend, authentication, data access and credits of the API and MCP server, and outputs JSON, JSONL, CSV, YAML or tables.

The command families are lookup, companies, contacts, intent, scoops, news, gtm-context, research and raw. Authentication uses gtm auth login, gtm auth whoami and gtm auth logout, and the token is stored in ~/.config/gtm-ai (ZoomInfo docs, ZoomInfo CLI). ZoomInfo's July 9, 2026 launch release called the CLI "open source under the MIT license," with search and lookup free and enrichment drawing on data credits (ZoomInfo release via Yahoo Finance).

ZoomInfo API Documentation: Where to Find It

ZoomInfo's current API documentation is at docs.gtm.ai, which covers the REST API, authentication, rate limits, credits, MCP and the CLI. The older docs.zoominfo.com address now redirects there. api-docs.zoominfo.com is titled "ZoomInfo API - Legacy," so use it only if you maintain an older integration. Pricing is on gtm.ai/pricing.

These are the pages most integrations need, all checked on November 17, 2026:

What you needWhere it is
Docs home and guidesdocs.gtm.ai (docs.zoominfo.com redirects here)
API overviewdocs.gtm.ai/reference/api-overview
Create an appStandard App and Partner App
AuthenticationClient Credentials Flow and Authorization Code Flow (PKCE)
Test callsTest API Access
Rate limitsRate Limits
CreditsCredit Usage and Limits and GTM AI Credits
OpenAPI specOpenAPI Specifications
MCPConnect to ZoomInfo MCP and Available MCP Tools
CLIZoomInfo CLI
Pricinggtm.ai/pricing
Legacy API docsapi-docs.zoominfo.com

ZoomInfo publishes one OpenAPI specification that "describes every public REST endpoint" (ZoomInfo docs, OpenAPI Specifications), which you can use to generate a client.

How Much Does the ZoomInfo API Cost?

GTM AI publishes its API prices: $0.38 per data credit at the $1,000 spend tier, $0.05 per AI credit, 1,000 of each free at signup, 70% off the first data credit purchase for a limited time, and top-ups from $20. Enterprise API and GTM AI Enterprise pricing is quoted by sales and not published.

One data credit pays for one company, contact or intent record "enriched or exported" (GTM AI pricing). The page's example prices 5,000 data credits at $1,900, shown at $570 with the first-purchase discount. AI credits are "Flat rate. No volume tiers," so 2,000 cost $100.

For the Enterprise route there is no public rate card. Vendr, a third-party buying platform, reports a median ZoomInfo contract of about $33,500 a year across the purchases it tracks (Vendr). That covers ZoomInfo contracts generally, not API access alone, so use it only as a rough benchmark. Our ZoomInfo pricing guide breaks down what drives a platform quote.

Where Does ZoomInfo's API Fall Short?

The main friction is in the details. ZoomInfo keeps a legacy doc set beside docs.gtm.ai, credits expire after 12 months, rate-limit increases go through your account team, and its own pages disagree on search page size. The MCP tool list also has no tools for social post content or engagement.

  • Two doc sets. api-docs.zoominfo.com is labeled legacy, and older tutorials point at it. Check that the endpoint you copy uses the /gtm/ paths in docs.gtm.ai.
  • Credits expire. Free and purchased credits both expire 12 months after they are granted (GTM AI pricing).
  • Limit increases are manual. Higher rate limits come through your account team or a support email, not a self-serve setting (Rate Limits).
  • Search size varies. 25 records per request on the direct API and 10 through MCP and the CLI, per the Rate Limits page, but up to 100 per page in the Search Contacts reference.
  • No post or engagement data. ZoomInfo's MCP tools cover companies, contacts, intent, scoops, news and audiences (Available MCP Tools). None returns social posts, commenters or reactions.

What's a Self-Serve Alternative for Public Profile Data?

If what you need is public professional profile and company data by URL, Datamagnet is a per-request API: a person profile or company profile costs 1 credit, with 10 free credits and no card. It does not return emails or phone numbers, so it complements a contact database rather than replacing one.

Datamagnet's rates are published: a person profile by public profile URL is 1 credit, and a company profile by company page URL is 1 credit. Optional add-ons cost +2 each for a person and +10 for company_insights. Post engagement, activity and search pages, such as ICP people search, are 10 credits each, and funding rounds by domain are 5. Plans are $39 for 1,000 credits, $99 for 10,000 and $199 for 25,000, or pay-as-you-go from $0.02 a credit (Datamagnet pricing). You are charged only on successful profile and company requests.

On freshness: with use_cache: "never", a request reads the profile at the moment you call. By default the API may return a stored copy, and company data can be up to 30 days old. Datamagnet has no email or phone lookup, no email verification and no revenue estimates.

You can start with the quickstart and an API key from the authentication guide, and check your balance with the credits endpoint. For agents, Datamagnet's MCP server runs at https://mcp.datamagnet.co/mcp with OAuth sign-in or an API-key Bearer header, and is listed in the official MCP Registry as co.datamagnet/datamagnet.

See every endpoint on the Datamagnet APIs page, the People API, or the full Datamagnet vs ZoomInfo comparison.

Frequently Asked Questions

How do I get ZoomInfo API access in 2026?

Sign up for GTM AI, which is self-serve and free to start with 1,000 data credits and 1,000 AI credits, then create an app in its Developer tab. Enterprise customers buy through ZoomInfo sales and create apps in the Developer Portal. Both routes need a license with API access.

Where is the ZoomInfo API documentation?

ZoomInfo's current API documentation is at docs.gtm.ai, which covers authentication, endpoints, rate limits, credits, MCP and the CLI. The older docs.zoominfo.com address redirects there, and api-docs.zoominfo.com is labeled as the legacy API. Pricing is on gtm.ai/pricing.

How does ZoomInfo API authentication work?

ZoomInfo uses OAuth 2.0. Server-to-server apps use the Client Credentials flow, exchanging a client ID and secret at https://api.zoominfo.com/gtm/oauth/v1/token for a bearer token. Apps acting for a signed-in user, and partner apps, use the Authorization Code flow with PKCE.

How many credits does a ZoomInfo API call use?

Search, lookup and find-similar calls are free. Enriching a company or contact costs 1 data credit per new record, and the record can be re-enriched free for 12 months. Records that come back as no match are not charged. Account and Contact Research use AI credits.

What are ZoomInfo's API rate limits?

GTM AI's pay-as-you-go tier allows 5 requests a second across 5 apps. ZoomInfo's docs list Builder at 5 requests a second and 129,600 a day, Standard at 25 and 648,000, and Scaling at 35 and 907,200. Limits count requests, not records.

How much does the ZoomInfo API cost?

GTM AI charges $0.38 per data credit at the $1,000 spend tier and $0.05 per AI credit, with 1,000 of each free at signup, 70% off the first data credit purchase for a limited time, and top-ups from $20. Enterprise API pricing is quoted by sales.

Sources

Pratik Dani

About Pratik Dani

CEO, Founder