ZoomInfo API를 사용하면 자체 소프트웨어에서 ZoomInfo의 기업 및 연락처 레코드를 조회하고, 전체 프로필을 CRM에 불러오고, 구매 시그널을 읽고, AI 리서치를 실행할 수 있습니다. 개발자는 세 가지 방식으로 ZoomInfo에 접근합니다. HTTPS 기반 REST 인터페이스, AI 어시스턴트용 ZoomInfo MCP 서버, 그리고 터미널 클라이언트입니다. ZoomInfo에 따르면 세 가지 모두 하나의 로그인과 크레딧 잔액을 공유합니다.
이 가이드는 ZoomInfo가 개발자에게 제공하는 기능, ZoomInfo API 문서의 위치, 인증 방식, 주요 엔드포인트 그룹, API 가격, ZoomInfo MCP, 그리고 별도의 Chorus API를 다룹니다. 마지막에는 캠페인 전에 보강된 이메일 주소를 안전하게 확인하는 방법을 소개합니다. 모든 내용은 2026년 10월에 확인한 ZoomInfo의 공식 문서와 가격 화면을 근거로 합니다. 저희는 ZoomInfo와 제휴 관계가 아닙니다. BillionVerify는 이메일 검증 서비스이며, 영업 리스트에 데이터를 공급하는 도구에 대해 글을 씁니다.
핵심 사실 (2026년 10월 확인):
- ZoomInfo는 현재 API를 docs.zoominfo.com에 문서화하고 있으며, 이 주소는 docs.gtm.ai로 연결됩니다. 이전 Enterprise API는 "Legacy"로 표시되어 있으며 지원 중단이 진행 중입니다.
- 현재 API는 OAuth 2.0 앱을 통해 요청에 서명하며, 모든 호출은 https://api.zoominfo.com/gtm 으로 전송됩니다.
- 레코드 검색은 무료입니다. 레코드를 보강(enrich)하면 처음 한 번 크레딧 1개가 차감되며, 계약 플랜에서는 해당 레코드가 12개월 동안 보장됩니다.
- GTM.ai는 셀프서비스 방식의 ZoomInfo API 가격을 공개합니다. 가입 시 무료 스타터 크레딧이 제공되고, 이후에는 유료로 충전합니다.
- ZoomInfo MCP는 https://mcp.zoominfo.com/mcp 에 있으며 Claude, ChatGPT, Cursor, Codex 및 기타 MCP 클라이언트와 함께 작동합니다.
ZoomInfo API: 간단한 답변
네. ZoomInfo는 API를 제공하며, 그동안 많이 달라졌습니다. 오래된 튜토리얼은 사용자 이름, 비밀번호, JSON Web Token을 사용하는 Java 시대의 서비스를 설명합니다. ZoomInfo의 자체 레거시 문서는 이제 이 서비스가 "폐기 절차가 진행 중"이라고 경고하며, 개발자에게 새로운 서비스를 기반으로 신규 작업을 구축하라고 안내합니다.
오늘날의 ZoomInfo API는 GTM.ai 개발자 사이트 뒤에 있습니다. 앱을 만들고, 스코프를 선택하고, 자격 증명을 베어러 토큰으로 교환한 뒤, 하나의 기본 URL 아래에 있는 엔드포인트를 호출합니다. 여기서부터는 필터로 레코드를 조회하고, 선택한 레코드의 전체 프로필을 가져오고, 타깃 계정의 인텐트·스쿠프·뉴스를 읽고, AI 브리핑을 실행하고, GTM Studio 오디언스를 관리할 수 있습니다.
어떤 엔드포인트가 열리는지는 요금제가 결정하며, 가격도 마찬가지입니다. ZoomInfo의 개요 문서는 이를 분명하게 밝힙니다. "구독에 따라 접근할 수 있는 API 스코프와 엔드포인트가 결정되며, 인증된 모든 요청에는 속도 제한이 적용됩니다."
ZoomInfo API로 할 수 있는 일
ZoomInfo의 개요 문서는 개발자를 위한 세 가지 작업을 설명합니다. 통합 구축, 기업과 연락처 검색, 그리고 웹훅을 통한 변경 사항 대응입니다. 문서에 따르면 REST 요청, MCP 서버 또는 터미널 클라이언트를 사용하면 "1억 개 이상의 기업, 5억 명 이상의 전문가, 50개 이상의 실시간 구매 및 비즈니스 시그널"에 접근할 수 있습니다.
레퍼런스는 엔드포인트를 여러 패밀리로 묶어 놓았습니다. 아래 표는 각 패밀리와 그 역할을 쉬운 말로 정리한 것입니다.
| 레퍼런스의 패밀리 | 용도 |
|---|---|
| Data V1 | 조회용 목록과 기업, 연락처, 인텐트, 뉴스, 스쿱 레코드 |
| Context V1 | 계정 요약, 인사이트, 유사 계정 및 유사 인물, 그리고 자체 GTM 설정 |
| GTM Studio V1 | 오디언스, 폴더, 컬럼, 행, 그리고 오디언스별 보강(enrichment) 작업 |
| Marketing V1 | ZoomInfo Marketing용 오디언스 업로드 |
| Platform V1 | 내보내기 및 참여(engagement) 레코드 |
| Agent V1 | ZoomInfo의 AI 에이전트 시작 및 실행 내역 조회 |
| Data Quality V1 | CRM에 들어가기 전에 목록을 파싱, 정규화, 세분화, 점수화 |
Data V1이 핵심이며, 문서의 여러 페이지에서 반복되는 패턴을 따릅니다. 첫째, 조회(lookup)는 업종 이름이나 관리 수준처럼 필터가 허용하는 정확한 값을 반환합니다. 둘째, 검색(search)은 조건에 맞는 레코드를 찾습니다. 셋째, 보강(enrich) 요청은 선택한 레코드의 전체 프로필을 반환합니다.
ZoomInfo API 문서: 어디서 읽어야 할까
ZoomInfo API 문서를 읽을 수 있는 곳은 두 군데이며, 이 둘을 혼동하는 것이 가장 흔한 실수입니다. 첫 번째는 현재 개발자 사이트로, 탭은 Get Started, Recipes, API Reference, MCP로 구성되어 있습니다. 두 번째는 api-docs.zoominfo.com에 있는 이전 Enterprise 사이트로, 기존 연동을 위해 유지되고 있습니다.

스크린샷: ZoomInfo API 레거시 문서. 상단의 안내문은 신규 작업을 새 사이트로 안내합니다.
레거시 사이트의 제목은 "ZoomInfo API - Legacy"입니다. 여기에는 이전 Standard 엔드포인트(Search, Enrich, Lookup, Usage), Scaling 엔드포인트(Webhooks, Bulk), WebSights 서비스, Compliance 서비스가 여전히 설명되어 있습니다. 또한 PKI 및 사용자 이름·비밀번호 로그인도 다루며, 이때 발급된 토큰은 한 시간 동안 유효합니다. 이 지침에 따라 만든 연동은 당분간 계속 실행할 수 있지만, 신규 프로젝트는 현재 사이트에서 시작해야 합니다. 두 사이트 모두 가격을 표시하지 않으므로, ZoomInfo API 가격은 아래 가격 섹션과 계약서에서 확인할 수 있습니다.
현재 문서는 기계가 읽기에도 편리합니다. llms.txt 파일에 모든 문서가 나열되어 있고, 사이트에 따르면 어떤 주소 뒤에든 .md를 붙이면 Markdown을 받을 수 있습니다. 또한 레퍼런스는 OpenAPI 사양을 공개하므로 Postman 같은 도구로 계약을 가져올 수 있습니다. 레퍼런스에서는 bearer 토큰을 붙여 넣고 페이지에서 직접 실제 호출을 시험해 볼 수 있습니다.
레퍼런스에서 호출을 시험할 때는 주의할 점이 있습니다. 테스트 액세스에 관한 문서 글은 Developer Portal의 토큰으로 보낸 호출이 "실제 프로덕션 요청으로 처리된다"고 경고합니다. 이런 호출은 크레딧을 소모하고 한도에도 반영되므로, 소량의 배치로 테스트하세요.
ZoomInfo API 인증 방식
새로운 ZoomInfo API는 OAuth 2.0을 사용합니다. 문서에 따르면 OAuth를 통해 애플리케이션은 "비밀번호나 장기 API 키 자격 증명을 공유하지 않고" ZoomInfo에 접근할 수 있습니다. 무언가를 호출하기 전에 먼저 애플리케이션을 만들어야 합니다. 엔터프라이즈 고객은 ZoomInfo Developer Portal에서 만들고, 셀프서브 사용자는 GTM.ai의 Developer 탭에서 만듭니다. 어느 경로든 접근 권한이 활성화된 GTM.ai 또는 Enterprise 라이선스가 필요합니다.
생성에는 몇 분이면 충분합니다. 이름, 선택 사항인 로고와 설명을 입력하고, 인증 방식을 고르고, 필요하면 리디렉션 URL을 추가한 다음, 스코프를 선택합니다. Create App을 클릭하면 ZoomInfo가 앱의 자격 증명인 ID와 시크릿을 발급합니다. 문서는 두 값을 모두 안전하게 보관하고 브라우저 코드에는 절대 노출하지 말라고 안내합니다.
앱 유형은 두 가지이고 OAuth 플로우도 두 가지입니다.
| 앱 유형 | Authorization Code Flow (PKCE) | Client Credentials Flow |
|---|---|---|
| 표준 앱, 자사 팀용 | 지원 | 지원 |
| 파트너 앱, 여러 고객을 대상으로 하는 승인된 파트너용 | 지원 | 지원 안 함 |
누가 행동하는지를 기준으로 플로우를 고르세요. 앱이 로그인한 사용자를 대신해 ZoomInfo를 호출한다면 PKCE를 사용하는 Authorization Code Flow를 쓰세요. ZoomInfo는 S256 챌린지 방식을 요구하며, 이 플로우는 액세스 토큰과 리프레시 토큰을 반환합니다. 백엔드 서비스, 예약 작업, 동기화에는 Client Credentials Flow를 쓰세요. 로그인하는 사람이 없으므로 통합 사용자를 지정해야 하며, ZoomInfo는 모든 요청을 해당 사용자의 것으로 기록합니다.
서버 간 작업을 위한 토큰 요청은 POST 한 번이면 됩니다. 자격 증명은 Basic 인증으로 보내는 것이 권장됩니다.
POST https://api.zoominfo.com/gtm/oauth/v1/token Authorization: Basic <client_id:client_secret, base64> Content-Type: application/x-www-form-urlencoded grant_type=client_credentials
응답에는 access_token, 초 단위의 expires_in 값, 스코프 목록, 그리고 Bearer 값의 token_type이 들어 있습니다. 문서의 샘플에서는 expires_in이 1000이므로, 호출할 때마다 새 토큰을 요청하지 말고 토큰을 캐시해 두었다가 타이머에 맞춰 갱신하세요. 이후의 각 요청은 Authorization: Bearer <access_token>을 보냅니다.
ZoomInfo OAuth 스코프
스코프는 토큰이 접근할 수 있는 범위를 결정하므로, 앱에 필요한 것만 요청해야 합니다. 대부분의 팀은 레코드 스코프부터 시작합니다.
| 스코프 값 | 열리는 범위 |
|---|---|
| api:data:company | 회사 레코드와 기업 계층 구조 |
| api:data:contact | 연락처 레코드와 조직도 |
| api:data:intent | 인텐트 시그널 |
| api:data:news 및 api:data:scoops | 뉴스 기사와 스쿱 |
| api:audience:read 및 api:audience:manage | GTM Studio 및 마케팅 오디언스 읽기 또는 관리 |
| api:data-quality:execute | Data Quality 준비 파이프라인 실행 |
토큰에 없는 스코프가 필요한 호출은 403 오류와 ZI0002 코드로 실패합니다. ZI0003은 다릅니다. 이는 사용 중인 패키지에 해당 엔드포인트가 포함되어 있지 않다는 뜻입니다. 첫 번째 문제는 Developer Portal에서 해결할 수 있고, 두 번째는 ZoomInfo 계정 매니저에게 문의해야 합니다.
주요 엔드포인트 카테고리
대부분의 통합은 네 종류의 엔드포인트를 사용하며, 종류마다 비용이 다릅니다. 조회(Lookup) 호출과 검색은 크레딧을 소모하지 않습니다. 반면 인리치먼트는 크레딧을 소모합니다. 아래 표는 가장 먼저 살펴봐야 할 호출을 정리한 것입니다.
| 호출 | 기능 | 비용 |
|---|---|---|
| Lookup | 산업, 관리 수준 등 허용되는 필터 값을 나열합니다 | 무료 |
| Search Contacts | 직무, 위치, 기업 특성, 시그널로 사람을 찾습니다 | 무료 |
| Search Companies | 산업, 규모, 위치, 기술로 어카운트를 찾습니다 | 무료 |
| Enrich Contacts | 전체 연락처 프로필을 반환하며, 요청당 최대 25건입니다 | 신규 레코드당 1크레딧 |
| Enrich Companies | 기업 정보(firmographics)를 반환하며, 요청당 최대 25건입니다 | 레코드가 신규일 때 1크레딧 |
| Enrich Intent | 기업의 구매 의도 시그널을 반환합니다 | 크레딧 소모 |
| Account and Contact Research | ZoomInfo와 CRM 컨텍스트를 결합한 AI 브리핑 | AI 크레딧 |
필터 목록은 깁니다. ZoomInfo의 "Companies & Contacts" 문서에 따르면 기업 쪽은 40개가 넘는 필터 그룹을, 연락처 쪽은 25개가 넘는 필터 그룹을 지원합니다. 기업 필터는 식별 정보, 기업 정보(firmographics), 규모, 위치, 기술, 기업 구조, 품질 플래그를 포함합니다. 연락처 필터는 이름, 직책, 직무 기능, 관리 수준, 위치, 그리고 하한선으로 활용할 수 있는 연락처 정확도 점수를 포함합니다.
코드를 작성하기 전에 알아두면 좋은 몇 가지 규칙이 있습니다. 요청과 응답은 JSON:API 콘텐츠 타입인 application/vnd.api+json을 사용합니다. 검색은 page[number]와 page[size]로 결과를 페이지 단위로 넘깁니다. 인리치 요청에는 outputFields 목록이 필요하며, requiredFields 목록을 지정하면 이메일 같은 핵심 필드가 없는 레코드는 제외됩니다. 각 인리치 결과에는 matchStatus가 포함되며, 예를 들어 FULL_MATCH 또는 NO_MATCH가 있습니다. LIMIT_EXCEEDED는 계정의 크레딧이 모두 소진되었음을 의미합니다.
속도 제한과 처리량
제한은 서비스를 보호하며, 목록을 얼마나 빠르게 불러올 수 있는지를 결정합니다. ZoomInfo는 초당 상한을 패키지에 연동하며, 그 패키지는 API 요금의 일부입니다.

스크린샷: 세 가지 패키지 등급이 나와 있는 ZoomInfo의 제한 관련 문서.
| 패키지 | 초당 | 시간당 | 일당 |
|---|---|---|---|
| Builder | 5건 요청 | 10,800 | 129,600 |
| Standard | 25건 요청 | 54,000 | 648,000 |
| Scaling | 35건 요청 | 75,600 | 907,200 |
모든 요청은 세 가지 구간에 대해 동시에 검사됩니다. 어느 한 구간이라도 소진되면 429 응답을 받게 됩니다. ZoomInfo에 따르면 거부된 요청은 할당량을 사용하지 않으므로, 제한에 걸린 뒤 재시도해도 남은 할당량이 줄어들지 않습니다. 별도의 크레딧 관련 문서에는 기본값인 초당 25건을 넘는 초당 30건 및 35건의 프리미엄 추가 옵션도 나와 있습니다.
응답에는 X-RateLimit-Limit-Second, X-RateLimit-Remaining-Hour처럼 현재 사용 현황을 보여 주는 헤더가 포함됩니다. 429 응답에는 Retry-After, 거부된 버킷을 알려 주는 헤더, 초기화 타임스탬프가 추가됩니다. 구간 접미사가 없는 두 개의 기존 헤더는 사용 중단(deprecated)으로 표시되어 있으며 2027-01-01에 제거될 예정이므로, 이 헤더를 읽는 코드는 옮겨 두어야 합니다.
제한은 레코드가 아니라 요청에 적용됩니다. 검색 호출은 REST에서는 최대 25개 레코드를 반환하지만 MCP나 CLI에서는 10개만 반환하므로, Standard 상한에서는 초당 처리 레코드 수가 한쪽은 625개, 다른 쪽은 250개가 됩니다. 재시도의 경우, 초당 제한에 걸렸을 때는 짧은 지수 백오프를 사용하고, 시간당 또는 일일 제한에 걸렸을 때는 Retry-After까지 대기하세요. 상한을 높이는 것은 계정 담당 팀과 협의할 가격 문제인데, 더 높은 상한은 추가 옵션이나 더 큰 패키지로 제공되기 때문입니다.
ZoomInfo API 가격 및 크레딧
팀들이 ZoomInfo API 가격에 대해 가장 많이 묻는데, 답은 두 부분으로 나뉩니다. 엔터프라이즈 가격은 계정 매니저를 통해 연간 사용량 기준으로 견적이 제시되며, 공개된 가격표는 없습니다. 셀프서비스 API 가격은 GTM.ai가 공개하고 있으므로 누구나 확인할 수 있습니다.

스크린샷: 두 개의 크레딧 슬라이더가 있는 GTM.ai 가격 화면.
GTM.ai 가격 화면에는 플랫폼 접근이 항상 포함된다고 나와 있습니다. MCP 접근, REST 접근, CLI 접근이 포함되며, 조회, 검색, 유사 항목 찾기 호출은 무료입니다. 무료 등급은 초당 5건의 요청과 5개의 앱으로 제한됩니다. 새 계정은 신용카드 없이 각 종류의 크레딧을 1,000개씩 받습니다. 그 이후에는 종량제로 과금되며, 충전은 $20부터 가능하고 계약이나 좌석 요금은 없습니다.
크레딧에는 두 종류가 있습니다.
- 데이터 크레딧은 데이터 보강에 사용됩니다. 크레딧 하나는 보강되거나 내보내진 단일 회사, 연락처 또는 인텐트 레코드를 포괄합니다. 슬라이더는 기본값인 5,000크레딧 설정에서 크레딧당 $0.38를 표시했으며, 첫 구매 시 기간 한정 70% 할인이 적용되기 전 가격은 $1,900로 표기되어 있었습니다.
- AI 크레딧은 리서치와 기타 AI 작업에 사용됩니다. 화면에는 개당 $0.05의 정액 요금이 표시되며, 2,000개는 $100이고 이는 약 200건의 계정 또는 연락처 리서치 호출에 해당한다고 설명합니다.
동일한 가격 모델이 모든 접점에 적용됩니다. REST 요청, CLI, ZoomInfo MCP 모두 공유 크레딧 잔액에서 차감되며, 검색은 각각 무료로 유지됩니다. Data Quality 서비스의 가격도 같은 개념을 따릅니다. 이메일을 파싱, 검증, 정규화하는 데는 비용이 들지 않지만, 세그먼트 실행, 점수 실행, 주소 검증, 전화 회선 유형 확인에는 크레딧이 소비됩니다. Data Quality는 베타 단계이며, 문서에 따르면 베타 사용량은 초기 무상 제공량 없이 정상 요금으로 청구됩니다.
ZoomInfo API 가격을 비교할 때는 표시 가격보다 크레딧 규칙이 더 중요합니다. ZoomInfo의 크레딧 문서에 따르면, 12개월 롤링 기간 중 처음 보강된 레코드는 크레딧 1개가 들며, 이후 해당 레코드는 1년간 Under Management 상태가 됩니다. 관리 상태에 있는 동안에는 다시 보강해도 추가 비용이 들지 않지만, 각 요청은 여전히 레코드 한도에 포함됩니다. 가격 FAQ에는 이 보장이 엔터프라이즈 혜택이며 무료 등급에는 적용되지 않고, 모든 크레딧은 부여된 후 12개월이 지나면 만료된다고 덧붙여져 있습니다.
조회와 검색이 무료이기 때문에, 이 가격 모델에서 가장 저렴한 워크플로는 넓게 조회하고, 결과의 순위를 매긴 뒤, 실제로 사용할 항목만 보강하는 것입니다. ZoomInfo의 에이전트 가이드도 같은 말을 하며, 에이전트에게 "보강 루프를 피하고" 연락처 25건을 보강하기 전에 확인하라고 권고합니다. 해당 배치가 최대 25크레딧을 소모할 수 있기 때문입니다.
레거시 서비스의 경우 API 가격은 계약서에 명시되어 있습니다. Usage 엔드포인트와 응답 헤더는 계약 기간 동안의 요청 한도, 레코드 한도, 고유 레코드 한도를 보고합니다. 공개 문서에는 샘플 값만 나와 있으므로, 해당 수치는 계정 팀에 문의하세요.
ZoomInfo MCP: AI 어시스턴트 연결하기
ZoomInfo MCP는 AI 어시스턴트가 ZoomInfo를 직접 호출할 수 있게 해 주는 호스팅형 Model Context Protocol 서버입니다. ZoomInfo 라이선스가 필요하며, 요금제와 한도, 크레딧이 모두 MCP 사용에 그대로 적용되므로 별도의 ZoomInfo MCP 요금은 없습니다. 이 서버를 사용하려면 Streamable HTTP와 OAuth를 지원하는 클라이언트와, 최초 로그인을 위한 브라우저가 필요합니다.
ZoomInfo MCP 문서는 다양한 클라이언트를 다룹니다. Claude Code에서는 claude plugin install zoominfo@claude-plugins-official 명령으로 공식 플러그인을 설치하거나, claude mcp add --transport http zoominfo https://mcp.zoominfo.com/mcp 명령으로 서버를 직접 추가할 수 있습니다. 그런 다음 /mcp를 실행해 로그인합니다. Codex에는 플러그인 방식과 커스텀 방식이 있습니다. Cursor와 VS Code는 서버 주소가 담긴 짧은 JSON 항목을 사용합니다. Claude, ChatGPT, Perplexity는 ZoomInfo를 기본 제공 커넥터로 지원하므로, 커넥터 메뉴에서 추가한 뒤 ZoomInfo 계정 정보로 로그인하면 됩니다.
눈에 띄는 규칙이 하나 있습니다. ZoomInfo는 "MCP를 통해 접근한 데이터를 AI 모델 학습에 사용하는 것을 금지"하며, 연결하기 전에 AI 계정에서 모델 학습을 꺼 둘 것을 요구합니다.

스크린샷: 크레딧 유형과 함께 표시된 ZoomInfo MCP 도구 목록.
도구는 두 가지로 나뉩니다. 데이터 도구는 레코드를 어시스턴트에 제공하며, 어시스턴트가 이를 단계별로 연결해 사용합니다. 컨텍스트 에이전트는 ZoomInfo 레코드에 CRM과 통화 이력을 결합하는 서브 에이전트를 실행합니다.
| 도구 | 기능 | 크레딧 유형 |
|---|---|---|
| Search Companies, Search Contacts | 조건으로 레코드 찾기 | 무료 |
| Lookup | 사용 가능한 필터 값 표시 | 무료 |
| Find Similar Companies, Find Similar Contacts, Find Recommended Contacts | 유사 대상 및 아웃리치 준비 완료 목록 | 무료 |
| Search Intent, Search Scoops | 신호로 계정 발견 | 무료 |
| Enrich Companies, Enrich Contacts | 최대 25개 레코드의 전체 프로필 | 대량 데이터 |
| Enrich Intent, Enrich Scoops, Enrich News | 한 회사에 대한 신호 | 대량 데이터 |
| Account Research, Contact Research | 한 회사 또는 한 사람에 대한 AI 브리핑 | AI 작업 |
"핀테크 기업의 영업 VP를 찾아줘"와 같은 프롬프트는 검색만 하므로 비용이 들지 않습니다. "이 연락처 50개를 보강해서 Salesforce로 보내줘"와 같은 프롬프트는 크레딧을 소모합니다. GTM.ai 요금 FAQ도 같은 구분을 둡니다. ZoomInfo MCP에서는 호출되는 도구가 요금을 결정합니다.
ZoomInfo는 ZoomInfo MCP와 동일한 백엔드를 사용하는 명령줄 클라이언트도 제공하며, 로그인과 크레딧도 같습니다. Homebrew(brew install zoominfo/gtm-ai/gtm-ai-cli) 또는 npm으로 설치하고 gtm auth login을 실행한 다음, gtm companies search, gtm contacts enrich 같은 명령을 호출합니다. 출력 형식은 JSON, CSV, YAML 또는 표로 선택할 수 있습니다.
실전 예시: 찾은 다음 보강하기
ZoomInfo API 문서에는 캘리포니아의 소프트웨어 회사에서 마케팅 디렉터를 찾는 튜토리얼이 있습니다. 이 튜토리얼은 조회(lookup), 검색(search), 보강(enrich)의 세 가지 호출을 순서대로 사용합니다. 아래 명령은 튜토리얼의 필드 이름을 따르므로, 샘플 값은 직접 사용하는 값으로 바꾸세요.
먼저 검색입니다. 비용이 들지 않으며, 이메일 주소가 아니라 일치 힌트만 반환합니다.
curl --request POST \
--url 'https://api.zoominfo.com/gtm/data/v1/contacts/search?page%5Bnumber%5D=1&page%5Bsize%5D=25' \
--header 'accept: application/vnd.api+json' \
--header 'content-type: application/vnd.api+json' \
--header 'authorization: Bearer <access_token>' \
--data '{"data":{"type":"ContactSearch","attributes":{"state":"California","managementLevel":"Director","jobFunction":"Marketing","requiredFields":"email"}}}'
응답에는 firstName, jobTitle, contactAccuracyScore 같은 필드와 hasEmail 같은 불리언 값, 그리고 사람마다 id가 나열됩니다. 두 번째로, 원하는 ID만 골라 보강합니다. 호출당 최대 25개까지 가능합니다.
curl --request POST \
--url 'https://api.zoominfo.com/gtm/data/v1/contacts/enrich' \
--header 'content-type: application/vnd.api+json' \
--header 'authorization: Bearer <access_token>' \
--data '{"data":[{"type":"ContactEnrich","attributes":{"personId":"4191419698"}}],"outputFields":["firstName","lastName","jobTitle","email"],"requiredFields":["email"]}'
각 결과에는 matchStatus가 포함됩니다. FULL_MATCH는 요청한 필드와 함께 반환됩니다. NO_MATCH는 attributes가 비어 있는 상태로 반환됩니다. ZoomInfo 레퍼런스에 따르면 레코드를 찾지 못하거나 오류가 반환될 때는 크레딧이 차감되지 않습니다.
비용을 아끼는 두 가지 습관이 있습니다. 검색하기 전에 값을 먼저 조회하세요. lookup이 알지 못하는 자유 텍스트 업종이나 직함은 코드 PFAPI0006과 함께 400을 반환하기 때문입니다. 그리고 보강한 ID는 저장해 두세요. ZoomInfo가 Under Management 기간 동안 캐시할 것을 권장하기 때문입니다.
자주 발생하는 ZoomInfo API 오류
문서에는 모든 오류 코드가 나열되어 있습니다. 아래 네 가지가 대부분의 실패를 차지합니다.
| 상태 및 코드 | 의미 | 대처 방법 |
|---|---|---|
| 400, PFAPI0006 | 필터 값이 유효하지 않음 | 값을 조회한 뒤 나열된 그대로 사용하세요 |
| 401, ZI0001 | 토큰이 유효하지 않거나 만료됨 | 새 토큰을 받거나 리프레시 토큰을 사용하세요 |
| 403, ZI0002 또는 ZI0003 | 스코프가 없거나, 패키지에 해당 엔드포인트가 없음 | 스코프를 추가하거나 계정 매니저에게 문의하세요 |
| 429, ZI0004 | 요청이 너무 많음 | 잠시 대기한 뒤 Retry-After 지연 시간이 지나면 재시도하세요 |
서버 오류는 다릅니다. 500은 일정 시간 후 재시도할 만하고, 504는 다음에 더 작은 요청을 보내는 것이 좋습니다. 크레딧 관련 문서에서는 400, 401, 403은 원인을 해결하기 전까지 재시도하지 말라고 안내합니다.
ZoomInfo Chorus API
Chorus는 통화 녹음과 대화 인텔리전스를 위한 별도의 ZoomInfo 제품이며, 자체 인터페이스를 갖추고 있습니다. ZoomInfo Chorus API는 위에서 다룬 페이지들과는 다른 사이트인 api-docs.chorus.ai에 있으며, OAuth 앱 모델을 사용하지 않습니다. Chorus API 문서는 사용자, 인게이지먼트, 녹음을 다룹니다.
소개 문서에서는 Chorus API를 사용자 데이터 조회, 인게이지먼트(미팅 및 다이얼러 통화) 데이터 조회, 새 녹음 업로드, 녹음 삭제가 가능한 REST API라고 설명합니다. 인증은 토큰으로 이루어집니다. 각 Chorus 사용자는 역할이 허용하는 경우 개인 설정에서 토큰을 생성할 수 있으며, 이 토큰은 Authorization 헤더에 넣습니다. 비공개로 표시된 녹음은 반환되지 않으며, Chorus 접근 제어 설정이 모든 요청에 적용됩니다.
ZoomInfo Chorus API 문서 트랜스크립트
가장 흔한 질문은 통화 텍스트, 즉 녹음된 통화에서 오간 말에 관한 것입니다. Chorus 사이트의 메뉴에는 Conversations, Engagement filter, Emails 그룹이 있으므로, 현재 필드 목록은 Conversations에서 확인하세요. 저희가 읽은 소개 문서에는 트랜스크립트 엔드포인트가 명시되어 있지 않습니다. Chorus 녹음을 Zoom Revenue Accelerator로 이전하는 방법을 설명한 Zoom의 가이드에는 녹음 객체 안에 발화(utterance)로 트랜스크립트가 담긴 대화 응답이 나와 있습니다.
두 종류의 레코드가 모두 필요하다면 자격 증명을 두 가지 준비해야 합니다. 메인 서비스용 OAuth 앱과 Chorus용 사용자별 토큰입니다. 두 자격 증명은 한도나 크레딧을 공유하지 않습니다. 통화 텍스트는 docs.gtm.ai가 아니라 Chorus 사이트에서 시작하세요. 모든 Chorus 엔드포인트에는 Chorus 토큰이 필요하므로, 먼저 Chorus 관리자에게 접근 권한을 요청하세요. 저희가 읽은 페이지에는 공개된 Chorus API 가격이 나와 있지 않으므로, 비용도 관리자에게 문의하세요.
전송 전에 ZoomInfo API에서 가져온 이메일 검증하기
enrich 호출은 이메일 주소를 알려 주지만, 그 메일함이 오늘 여러분의 메시지를 받아 줄지는 알려 주지 않습니다. ZoomInfo는 Data Quality 문서에서 이 점을 분명히 밝히고 있습니다. 이메일의 경우 해당 제품은 파싱, 유효성 검사, 정규화만 지원하며, 문서에는 "there is no email verification or bounce checking."이라고 적혀 있습니다. 또한 이 유효성 검사는 구조적인 것이라고 덧붙입니다. 주소에 @와 도메인이 있는지만 확인할 뿐, 그 주소가 반송을 피할 수 있는지는 확인하지 않습니다.
검증 단계가 필요한 곳이 바로 이 간극입니다. 간단한 파이프라인은 다음과 같습니다:
- 무료로 쿼리하고 결과의 순위를 매깁니다.
- 연락할 계획인 컨택에 대해서만 requiredFields에 email을 넣어 enrich합니다.
- 반환된 주소를 검증 서비스로 보냅니다.
- valid 결과는 유지하고, catch-all 및 unknown 결과는 검토하며, invalid 결과는 제외합니다.
- 정리된 리스트를 CRM 또는 시퀀서에 불러옵니다.
BillionVerify는 REST 인터페이스와 호스팅형 MCP 서버로 3단계를 담당합니다. 아래의 모든 내용은 billionverify.com/docs에 있는 저희 문서를 기반으로 합니다. 기본 URL은 https://api.billionverify.com/v1이며, 키는 BV-API-KEY 헤더에 넣습니다. 요청 한 번으로 주소 하나를 확인합니다:
curl -X POST https://api.billionverify.com/v1/verify/single \
-H "BV-API-KEY: sk_xxx" -H "Content-Type: application/json" \
-d '{"email":"jane@company.com","check_smtp":true}'
응답에는 valid, invalid, catchall 같은 상태와 함께 일회용(disposable), 역할 기반(role), catch-all 주소에 대한 플래그가 포함됩니다. 대량 호출은 한 번에 최대 50개의 주소를 받습니다. 대규모 내보내기 파일은 CSV, TXT 또는 XLSX 파일을 업로드하고, 작업이 끝날 때까지 진행 상황을 확인한 뒤 결과를 다운로드하세요. 파일 작업이 완료되면 웹훅으로 시스템에 알릴 수도 있습니다.

스크린샷: Claude Code에 서버를 추가하는 명령어가 표시된 BillionVerify MCP 서버 개요.
팀이 이미 어시스턴트를 통해 작업하고 있다면, 동일한 검증을 MCP에서 실행할 수 있습니다. https://mcp.billionverify.com/mcp의 BillionVerify 원격 서버는 OAuth로 로그인합니다. 이 서버의 도구로 단일 주소 또는 50개 묶음 검증, 잔액 조회, 파일 작업 진행 확인, 다운로드 링크 생성, 웹훅 관리를 할 수 있습니다. 따라서 어시스턴트가 ZoomInfo MCP로 ZoomInfo를 조회한 다음, 같은 대화 안에서 저희 도구로 결과를 확인할 수 있습니다.
요금은 valid 또는 invalid 결과에 크레딧 1개가 사용되고, unknown 결과는 무료이며, 24시간 이내 재확인도 무료입니다. 계정을 사용하는 날마다 무료 크레딧 20개를 받으며 월 최대 600개까지 받을 수 있습니다. 크레딧은 만료되지 않으며 카드도 필요 없습니다. 내보내기 파일에 초점을 맞춘 안내는 ZoomInfo 이메일 검증 페이지를 참고하세요.
무료 도구 두 가지가 개별 레코드 확인에 도움이 됩니다. 역방향 이메일 조회는 주소 뒤에 있는 도메인과 공개 신호를 보여 줍니다. 전화번호 검증기는 enrich 호출로 얻은 직통 번호가 해당 국가에서 유효한지 확인하고 회선 유형을 보여 줍니다.
ZoomInfo 기반 개발 팁
ZoomInfo API 문서에서 얻은 몇 가지 습관만 지켜도 크레딧과 시간을 아낄 수 있습니다.
- 위의 오류 표에서 알 수 있듯이, 열거형 필터에는 항상 조회(lookup) 값을 사용하세요.
- 보강(enrich)하기 전에 연락처 정확도 점수나 hasEmail 같은 필드로 결과의 순위를 매기세요.
- 25건씩 묶어서 보강하고, 이미 가지고 있는 ID는 캐시해 두세요.
- 남은 할당량 헤더를 확인하고, 한도에 도달하기 전에 속도를 늦추세요. 대량 적재 전에는 API 요금을 다시 확인하세요.
- 가장 좁은 범위의 스코프만 요청하고, 클라이언트 시크릿은 서버에 보관하세요.
회사에 대한 배경 정보는 ZoomInfo 가이드를 읽어 보세요. 팀원이 앱을 만드는 웹 앱에 접속하지 못한다면, ZoomInfo 로그인 가이드에서 로그인, SSO, 2단계 인증을 다룹니다.
자주 묻는 질문
ZoomInfo에 API가 있나요?
ZoomInfo에는 API가 있으며, 문서는 docs.zoominfo.com에 있습니다. 현재 버전은 OAuth 앱을 통해 로그인합니다. 이전 Enterprise 서비스에는 Legacy 라벨이 붙어 있으며 단계적으로 종료되고 있습니다.
ZoomInfo API 문서는 어디에 있나요?
ZoomInfo API 문서는 docs.zoominfo.com에 있으며, 이 주소는 이제 docs.gtm.ai로 연결됩니다. 레거시 Enterprise 페이지는 api-docs.zoominfo.com에 남아 있고, Chorus는 api-docs.chorus.ai에 별도의 사이트가 있습니다.
ZoomInfo API 비용은 얼마인가요?
ZoomInfo API 가격은 구매 방식에 따라 달라집니다. GTM.ai는 셀프 서비스 가격을 공개하며, 시작 시 각 유형별로 1,000 크레딧을 제공하고 $20 단위로 충전할 수 있습니다. Enterprise 계약 가격은 ZoomInfo 영업팀에서 견적을 받습니다.
ZoomInfo API는 무료인가요?
ZoomInfo API는 GTM.ai에서 시작 잔액이 제공되며 신용카드 없이 무료로 시작할 수 있습니다. 조회와 검색은 비용이 들지 않고, 데이터 보강(enrichment)은 시작 크레딧을 모두 소진한 뒤부터 크레딧을 사용합니다.
ZoomInfo API 키는 어떻게 받나요?
현재 ZoomInfo API에는 단일 키가 없습니다. Developer Portal 또는 GTM.ai의 Developer 탭에서 앱을 만들면 ZoomInfo가 자격 증명을 제공합니다. 레거시 버전은 클라이언트 ID와 개인 키, 또는 사용자 이름과 비밀번호를 사용했습니다.
ZoomInfo API 속도 제한은 어떻게 되나요?
ZoomInfo API는 Builder에서 초당 5회, Standard에서 25회, Scaling에서 35회 호출을 허용합니다. 각 패키지에는 시간당 및 일일 한도도 있으며, 429 응답을 통해 어느 구간의 한도에 도달했는지 알 수 있습니다.
ZoomInfo MCP란 무엇인가요?
ZoomInfo MCP는 AI 어시스턴트가 자연어로 ZoomInfo 레코드를 조회하고 가져올 수 있게 해 주는 호스팅 서버입니다. ZoomInfo 라이선스와 OAuth 로그인이 필요하며, ZoomInfo MCP는 REST 호출과 동일한 크레딧을 차감합니다.
ZoomInfo MCP는 추가 비용이 드나요?
ZoomInfo MCP에는 별도 가격이 없습니다. 검색만 하는 도구는 무료이며, 데이터를 보강하거나 리서치를 실행하는 도구는 REST 요청과 같은 잔액에서 크레딧을 사용합니다.
ZoomInfo Chorus API란 무엇인가요?
ZoomInfo Chorus API는 대화 인텔리전스 제품인 Chorus의 REST 인터페이스입니다. 사용자와 참여(engagement) 데이터를 읽을 수 있고, 녹음을 업로드하거나 삭제할 수도 있습니다. 메인 서비스의 OAuth 앱이 아니라 사용자별 토큰을 사용합니다.
ZoomInfo Chorus API 문서의 통화 녹취록은 어디에서 찾을 수 있나요?
통화 녹취록은 메인 ZoomInfo API가 아니라 Chorus API에 속합니다. 최신 필드는 api-docs.chorus.ai의 Conversations 그룹에서 확인하고, 테스트하기 전에 Chorus 관리자에게 토큰을 요청하세요.
ZoomInfo API에서 이메일 주소를 가져올 수 있나요?
ZoomInfo API로 연락처를 보강하면 비즈니스 이메일을 가져올 수 있으며, 이메일에 대한 requiredFields 항목을 지정하면 이메일이 없는 레코드는 건너뜁니다. ZoomInfo의 자체 Data Quality 제품은 전달 가능 여부를 검증하지 않으므로, 발송 전에 주소를 확인하세요.
ZoomInfo에서 반환된 이메일을 검증해야 하나요?
ZoomInfo가 반환한 주소는 업데이트 사이에 사람들이 이직하기 때문에 캠페인 전에 검증해야 합니다. BillionVerify의 REST 인터페이스와 MCP 서버는 각 주소를 확인하고 catch-all, unknown, disposable, role 결과를 각각 별도로 보고합니다.
영상 보기: 전화번호를 검증하는 방법: 무료 전화번호 검사기
