본문으로 건너뛰기
블랙프라이데이: 모든 요금제 20% 할인, 12월 1일까지.할인 보기

Apollo.io API: 키, 엔드포인트, 제한 및 MCP 서버

Leo
LeoFounder, BillionVerify

Apollo.io API 가이드: API 키 생성, 상태 점검, people search 및 enrichment 호출, rate limit·크레딧 확인, MCP 서버 연결.

키, 엔드포인트, 속도 제한, MCP Server, 이메일 검증을 보여주는 Apollo.io API 대시보드

Apollo.io API를 사용하면 자체 코드로 사람을 검색하고, 레코드를 보강하며, 영업 워크플로를 관리할 수 있습니다. Apollo.io API 키를 사용해 HTTPS로 호출합니다. 키를 생략하고 AI 클라이언트가 Apollo.io MCP 서버를 통해 동일한 데이터에 접근하도록 할 수도 있습니다. 두 경로 모두 요금제의 크레딧을 사용하며 요금제 한도를 따릅니다.

이 가이드는 첫 클릭부터 첫 호출까지 Apollo.io API를 단계별로 안내합니다. 키를 생성하는 방법과 키를 찾을 수 있는 위치를 설명합니다. Apollo.io API 문서, 상태 확인, 사람 검색, 데이터 보강, 요청 제한 및 크레딧 비용을 다룹니다. 마지막으로 Apollo.io의 공식 MCP 서버와 API가 반환하는 주소를 확인하는 절차를 소개합니다. 모든 내용은 2026년 10월에 확인한 공식 개발자 문서 docs.apollo.io에서 가져왔습니다. Apollo.io는 여러 페이지를 최근 업데이트된 페이지로 표시하므로, 구축하는 당일에 세부 정보를 다시 확인하세요.

저희는 Apollo.io와 제휴 관계가 없습니다. BillionVerify는 이메일 검증 서비스입니다. 플랫폼을 더 폭넓게 살펴보려면 Apollo.io 가이드를 읽어보세요.

주요 사실(2026년 10월 확인):

  • 무료 요금제를 포함한 모든 등급에서 어느 정도의 API 액세스가 제공됩니다. 무료 계정은 특정 엔드포인트를 사용하려면 회사 이메일이 필요합니다.
  • Apollo.io API는 x-api-key 헤더에 키를 담아 전송하며, 기본 URL은 https://api.apollo.io/api/v1입니다.
  • 범위가 지정된 Apollo.io API 키는 선택한 엔드포인트에만 접근할 수 있습니다. 마스터 키는 모든 엔드포인트에 접근할 수 있습니다.
  • 대부분의 엔드포인트는 유료 요금제에서 분당 200회 호출을 허용하며, 무료 요금제에서는 50회입니다.
  • Apollo.io MCP 서버는 https://mcp.apollo.io/mcp에 있으며 OAuth로 로그인합니다.

Apollo.io API가 하는 일

Apollo.io는 API를 사용해 데이터를 프로그래밍 방식으로 검색, 보강, 생성 및 관리할 수 있다고 설명합니다. 그 기반에는 2억 4천만 명 이상의 연락처와 3천만 개 회사로 구성된 데이터베이스가 있습니다. 문서에서는 이 작업을 세 가지로 구분합니다.

  • 통합 구축. 제품을 Apollo.io 데이터에 연결하고, 계정을 생성하며, 시퀀스를 운영합니다.
  • 데이터 보강. 사람 및 회사 레코드를 하나씩 또는 일괄적으로 채웁니다.
  • 사람 찾기. 직함, 위치, 직급 및 다양한 필터로 검색합니다.

사용 중인 요금제에 따라 사용할 수 있는 엔드포인트, 호출 속도 및 각 호출 비용이 결정됩니다. Apollo.io는 또한 자사 도구로 앱에서 할 수 없는 작업은 수행할 수 없다고 말합니다. 계정에 특정 기능이 없다면 API로 해당 기능을 사용할 수 없습니다.

API를 포함하는 요금제는 무엇인가요?

개발자 FAQ에 따르면 모든 요금제에서 기본 액세스를 제공합니다. 더 고급 기능은 특정 요금제에서만 사용할 수 있습니다. Apollo.io 가격 가이드에서 요금제와 크레딧 풀을 확인할 수 있습니다.

무료 계정에는 한 가지 제한이 있습니다. 일부 사람 검색, 데이터 보강 및 레코드 엔드포인트는 회사 이메일 주소로 등록된 계정이 필요합니다. 해당 엔드포인트 페이지에 이 내용이 명시되어 있습니다. 유료 계정에는 적용되지 않습니다.

Apollo.io API는 누구를 위한 것인가요?

주로 다음 세 그룹이 사용합니다.

  1. 영업 및 RevOps 팀: 보강된 데이터를 CRM 또는 데이터 웨어하우스로 전송하려는 팀입니다.
  2. 소프트웨어 회사의 개발자: 자체 제품에 Apollo.io 데이터를 통합하려는 개발자입니다.
  3. 파트너: 마켓플레이스 통합을 구축하는 파트너입니다. 이들은 키 대신 OAuth 2.0으로 로그인합니다.

Apollo.io는 라이선스 관련 안내도 덧붙입니다. Apollo.io 사용자가 아닌 사람에게 데이터를 공유, 공개 또는 재판매하려면 별도 계약이 필요합니다.

Apollo.io API 문서: 모든 내용이 있는 곳

Apollo.io API 문서는 docs.apollo.io에 있습니다. 상단 바는 Get Started, API, MCP, CLI, OpenAPI 및 Changelog로 나뉩니다. API 섹션에는 각 엔드포인트마다 하나의 페이지가 있습니다.

자격 증명 패널과 예시 응답이 표시된 People API Search용 Apollo.io API 문서 페이지

스크린샷: Apollo.io 개발자 문서의 People API Search 페이지로, Apollo.io의 키 테스트 가이드에서 가져왔습니다.

모든 엔드포인트 페이지는 동일한 형식을 따릅니다. 상단의 "Endpoint essentials" 상자에는 주요 액세스 경로, OAuth 범위, 사용 가능한 사용자 및 필요한 크레딧 수가 나와 있습니다. 그 아래에는 매개변수가 표시됩니다. 오른쪽에서는 언어 선택기, 자격 증명 필드, cURL 요청 및 예시 응답을 확인할 수 있습니다.

페이지에서 실시간으로 테스트할 수 있습니다. 헤더 필드에 키를 붙여 넣고, 필수 매개변수를 입력한 다음 Try It을 누르세요. 200은 호출이 성공했다는 의미입니다. 키가 없어도 각 예시 응답을 열어 스키마를 확인할 수 있습니다.

OpenAPI 파일

Apollo.io는 전체 API를 하나의 OpenAPI 3 파일로 https://docs.apollo.io/openapi/apollo-rest-api.json에 게시합니다. 문서가 변경될 때마다 다시 생성됩니다. 이 파일을 Postman이나 다른 API 클라이언트에 불러오면 모든 엔드포인트와 해당 매개변수가 함께 추가됩니다. 또한 코드 생성기에 전달하여 원하는 언어로 타입이 지정된 클라이언트를 만들 수도 있습니다.

Postman에서는 미리 구성된 API Key 인증에 키를 보관하고 apiKey 변수를 설정하세요. 문서에서는 키를 Bearer 토큰으로 붙여 넣으면 401이 반환된다고 경고합니다. Bearer 토큰은 OAuth 파트너용입니다.

머신 판독용 색인

문서는 docs.apollo.io/llms.txt에 일반 텍스트 색인도 게시합니다. 이 색인에는 모든 페이지가 Markdown 링크로 나열되어 있습니다. AI 코딩 도구는 사이트를 크롤링하지 않고도 이를 읽어 적절한 엔드포인트 페이지를 찾을 수 있습니다.

Apollo.io API 키를 가져오는 방법

Apollo.io API 키는 docs 사이트가 아니라 앱 내부에서 생성됩니다. 경로는 Settings, Integrations, API Keys 순서입니다. 관리자만 이 작업을 수행할 수 있으며, 키를 관리할 수 있는 권한 프로필을 가진 사용자도 가능합니다.

Apollo.io API 키에 액세스하는 방법은 다음과 같습니다.

  1. Apollo.io를 열고 Settings > Integrations > API Keys를 클릭합니다. developer.apollo.io의 개발자 대시보드에도 같은 페이지가 표시됩니다.
  2. Create new key를 클릭합니다.
  3. 이름과 설명을 입력합니다.
  4. 키가 호출할 수 있는 각 endpoint를 선택하거나 Set as master key를 켭니다.
  5. Create API key를 클릭합니다.
  6. Copy를 클릭하고 키를 안전한 곳에 붙여 넣습니다.

이름, 설명, API 선택 항목 및 마스터 키 토글이 표시된 Apollo.io 새 API 키 생성 대화 상자

스크린샷: Apollo.io 개발자 포털의 새 API 키 생성 대화 상자. Apollo.io 문서에서 가져왔습니다.

Apollo.io는 마지막 단계에서 전체 키를 표시합니다. 그때 복사하세요. 키를 잃어버리면 대시보드에서 다시 생성하세요.

기존 Apollo.io API 키를 찾을 수 있는 위치

이전에 만든 Apollo.io API 키를 찾아야 한다면 개발자 대시보드로 돌아가 API keys를 엽니다. 만든 각 키가 목록에 표시됩니다. 포털 사이드바에는 Quick Start, Usage, Subscription 페이지도 있습니다. 같은 사이드바에는 파트너를 위한 OAuth Registration 페이지도 있습니다.

Apollo.io에서는 기존 키로 두 가지 작업을 수행할 수 있습니다. Regenerate는 새 보안 키를 생성하고 복사합니다. Delete는 키를 영구적으로 삭제합니다. 이전 키를 사용하던 모든 스크립트가 작동하지 않으므로, 둘 다 되돌릴 수 없는 작업으로 취급하세요.

마스터 키와 범위 지정 키 중 무엇을 선택해야 하나요?

Apollo.io API 키를 만들 때 이 선택은 다른 어떤 선택보다 중요합니다.

유형액세스할 수 있는 범위용도
범위 지정 키(기본값)선택한 endpoint만대부분의 통합
마스터 키모든 endpoint마스터 키가 필요한 endpoint 및 키를 통한 MCP 서버

선택하지 않은 endpoint를 범위 지정 키로 호출하면 403 오류가 반환됩니다. workspace user list와 같은 일부 endpoint는 마스터 키로만 작동합니다. Apollo.io는 마스터 키를 비밀번호처럼 취급하라고 안내합니다. 계정에 허용된 모든 API 작업을 수행할 수 있습니다.

키는 어떤 사용자로 작동하나요?

Apollo.io API 키는 개인이 아니라 workspace를 식별합니다. Apollo.io는 어떤 팀원이 키를 사용했는지 알 수 없습니다. 모든 요청은 workspace에서 가장 오래 활동한 활성 관리자로 작동하며, 해당 사용자가 호출로 생성되는 항목을 소유합니다. 그 사용자가 누구인지 확인하려면 크레딧이 차감되지 않는 현재 사용자 프로필 조회 endpoint를 호출하세요.

이 점은 제한된 권한으로 로그인한 상태에서 키를 만드는 팀에게 놀라울 수 있습니다. 키는 코드가 액세스할 수 있는 범위를 제한하지 않습니다.

Apollo.io API 상태 확인

새 키를 테스트하는 가장 빠른 방법은 단일 상태 확인 요청을 보내는 것입니다. 이는 auth/health에 대한 GET 요청 하나이며, 크레딧이 사용되지 않습니다.

curl --request GET \
  --url 'https://api.apollo.io/api/v1/auth/health' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

모든 설정이 올바르면 Apollo.io API 상태 확인은 두 가지 값을 반환합니다.

{ "healthy": true, "is_logged_in": true }

두 값이 모두 true이면 키가 작동합니다. 둘 중 하나라도 false이면 키 뒤에 불필요한 공백이나 줄바꿈이 있는지 확인한 다음 요청을 다시 보내세요. Postman에서는 Authorization 유형을 No Auth로 설정하고 대신 키를 헤더로 추가하세요.

Apollo.io API가 다운되었나요?

이 용어를 검색하는 사람들은 때때로 다른 답을 원합니다. 서비스 자체가 다운되었는지 알고 싶은 것입니다. auth/health 호출은 전체 플랫폼이 아니라 사용자의 키와 로그인 상태를 테스트합니다. 장애가 발생한 경우 Apollo.io는 status.apollo.io에서 상태 페이지를 운영합니다.

코드 USAGE.RATE_LIMIT.PLATFORM_RATE_LIMIT과 함께 429 응답이 반환되면 플랫폼 전반의 높은 부하로 인해 플랫폼이 트래픽을 거부하고 있다는 의미입니다. 이는 사용자의 요금제와는 관련이 없습니다. 문서에서는 60초 기다린 후 다시 시도하라고 안내합니다.

Apollo.io API의 주요 엔드포인트 그룹

참조 문서에는 수십 개의 엔드포인트가 나열되어 있습니다. 이들은 여섯 그룹으로 나뉩니다.

그룹다루는 내용예시
검색 및 보강사람과 회사 찾기, 레코드 정보 채우기People API 검색, 사람 정보 보강, 조직 검색
레코드 관리계정, 연락처, 거래, 목록, 메모연락처 생성, 계정 일괄 업데이트, 목록에 레코드 추가
잠재 고객과 소통시퀀스, 이메일, 통화, 작업, 대화연락처를 시퀀스에 추가, 지금 이메일 보내기
AI 어시스턴트기본 제공 어시스턴트에 작업 전달어시스턴트 작업 실행, 어시스턴트 작업 상태 확인
워크스페이스사용자, 사서함, 사용자 지정 필드사용자 목록 가져오기, 사용자 지정 필드 생성
분석 및 사용량보고서, 사용량 통계, 웹훅 결과분석 보고서 조회, 사용량 통계 보기

레코드 관리, 시퀀스 및 대부분의 워크스페이스 호출은 0 크레딧을 사용합니다. 비용은 검색 및 정보 보강에 발생하며, 이에 대해서는 아래에서 다룹니다.

검색은 정보 보강이 아닙니다

이 구분은 신규 사용자에게 혼란을 줍니다. Apollo.io의 사람 데이터베이스를 검색하면 프로필이 반환됩니다. 결과에는 이메일이나 전화번호가 포함되지 않습니다. 해당 정보를 얻으려면 정보 보강 엔드포인트를 추가로 호출해야 합니다. 직접 저장한 연락처를 검색하는 경우에는 다른 엔드포인트 세트를 사용하며, 제한도 다르게 적용됩니다.

Apollo.io API 사람 검색 문서

Apollo.io API 사람 검색 문서는 하나의 POST 엔드포인트인 /mixed_people/api_search를 다룹니다. Apollo.io는 아직 연락처로 저장하지 않은 새로운 잠재 고객을 사람으로 설명합니다.

curl --request POST \
  --url 'https://api.apollo.io/api/v1/mixed_people/api_search?person_titles[]=sales%20director&person_locations[]=california&per_page=10' \
  --header 'accept: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

매개변수는 쿼리 문자열에 포함합니다. 다음 기준으로 검색 범위를 좁힐 수 있습니다.

  • 직책: person_titles[], 제외할 직책을 지정하는 person_not_titles[].
  • 직급: person_seniorities[].
  • 위치: 거주지를 지정하는 person_locations[], 회사 본사를 지정하는 organization_locations[].
  • 회사 규모 및 매출: organization_num_employees_ranges[] 및 revenue_range[min].
  • 기술: 회사가 사용하는 1,500개 이상의 기술에 대한 필터.
  • 채용 신호: q_organization_job_titles[] 및 채용 공고 수.
  • 이메일 상태: contact_email_status[], verified, unverified, likely to engage, unavailable 등의 값.
  • 페이지 매김: page 및 per_page.

사람 검색 엔드포인트는 0 credits를 사용합니다. 페이지당 최대 100개의 레코드를 반환합니다. 또한 표시 한도가 50,000개 레코드, 즉 500페이지로 설정되어 있습니다. 이 한도 이하로 유지하려면 필터를 추가하세요.

Apollo.io API 사람 검색이 반환하는 항목

사람 검색 응답에는 total_entries 개수와 people 목록이 포함됩니다. 이메일과 전화번호는 제외됩니다. 연락처 정보를 가져오려면 각 결과를 enrichment 엔드포인트로 전달하세요.

검색에는 고유한 제한이 있으며, 아래 rate limit 섹션에 설명되어 있습니다.

contact_email_status[]로 검색하는 경우 값의 출처를 기억하세요. 이 값은 해당 주소에 대한 Apollo.io 자체 레코드를 설명합니다. 실시간 mailbox 테스트 결과가 아닙니다.

Apollo.io API 사람 검색 문서를 더 빠르게 읽는 방법

Endpoint essentials 상자부터 시작하세요. 크레딧 사용량과 무료 계정 액세스 행을 확인하세요. 그런 다음 필요한 필터를 찾기 위해 매개변수 목록을 훑어보세요. 마지막으로 수천 개의 결과를 페이지별로 가져오기 전에 per_page=10으로 작은 요청을 한 번 실행하세요.

Apollo.io API로 사람 데이터 보강하기

데이터 보강은 이미 보유한 레코드를 새로 고칩니다. Apollo.io는 사람 데이터를 위한 두 가지 엔드포인트를 제공합니다.

  • 사람 데이터 보강: POST /people/match, 호출당 한 명.
  • 대량 사람 데이터 보강: 단일 요청에서 최대 10명.

Apollo.io가 올바른 사람을 매칭하려면 충분한 세부 정보가 필요합니다. 이메일 주소만 있어도 작동합니다. 이름과 회사 도메인을 함께 보내도 됩니다. 엔드포인트는 LinkedIn URL, 조직 이름 또는 Apollo.io 사람 ID도 허용합니다. 이름만 보내면 아무것도 보강되지 않은 200 응답을 받을 수 있습니다.

모든 응답에서 match_confidence를 확인하세요. 값은 high, medium, low 또는 none입니다.

curl --request POST \
  --url 'https://api.apollo.io/api/v1/people/match?email=mark%40sumware.com' \
  --header 'accept: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

응답에는 해당 사람의 직책, 고용 이력, 회사 데이터와 verified 같은 email_status가 포함됩니다. 이 상태는 Apollo.io 자체의 레이블입니다. 이 가이드의 뒷부분에서 수행하는 검사는 주소 자체를 테스트합니다.

전화번호, 개인 주소 및 워터폴

세 가지 선택적 스위치가 반환되는 데이터를 변경합니다.

  • reveal_personal_emails=true는 개인 주소를 추가합니다. Apollo.io는 GDPR 적용 지역에 있는 사람들의 개인 주소를 공개하지 않습니다.
  • reveal_phone_number=true는 휴대전화를 포함한 모든 전화번호를 추가합니다. webhook_url이 필요합니다. Apollo.io가 전화번호를 비동기적으로 확인한 뒤 웹훅으로 전송하며, 완료까지 몇 분이 걸릴 수 있습니다.
  • run_waterfall_email 및 run_waterfall_phone은 먼저 Apollo.io를 검색한 다음, 설정된 외부 데이터 제공업체를 검색합니다. 최종 결과도 웹훅으로 전달됩니다.

중복 결제 피하기

나중에 같은 사람을 다시 보강하면 동일한 데이터에 대해 크레딧을 다시 사용할 수 있습니다. Apollo.io는 보강한 사람을 연락처로 변환할 것을 권장합니다. 연락처는 조직에 속하므로 해당 데이터를 계속 이용할 수 있습니다.

Apollo.io API 요청률 제한

요청률 제한은 키나 사용자별이 아니라 팀별로 적용됩니다. 또한 엔드포인트별로 적용되며, 분, 시간, 하루의 세 가지 시간 창이 동시에 실행됩니다. 적용되는 모든 시간 창의 제한을 지켜야 합니다.

제한FreeBasicProfessionalOrganization
분당 요청 수50200200200
시간당 요청 수200400400600
일일 요청 수6002,0002,0006,000

위 표가 기본 제한입니다. 유료 플랜에서는 검색 및 보강 엔드포인트에 더 높은 제한이 적용됩니다.

  • 보강 엔드포인트: 유료 플랜에서는 분당 1,000건의 요청이 가능하며, 시간별 또는 일일 상한이 없습니다. Free 계정은 분당 50건이며, 대량 엔드포인트에서는 20건입니다.
  • 검색 엔드포인트: 유료 플랜에서는 분당 200건, 시간당 6,000건, 일일 50,000건입니다.
  • 더 낮은 제한: 쿼리 분석 보고서는 시간당 5건의 요청만 허용합니다.

Apollo.io의 문서에서는 높은 보강 제한이 무제한 호출을 보낼 수 있는 권한을 의미하지 않는다고 설명합니다. 보강할 수 있는 양은 여전히 크레딧 잔액에 따라 결정됩니다.

보강 일일 및 시간별 요청률 제한을 보여주는 Apollo.io API 개발자 포털 Usage 페이지

스크린샷: Apollo.io 문서에 나온 Apollo.io 개발자 포털의 Usage 페이지로, 보강 엔드포인트의 일일 및 시간별 제한을 보여줍니다.

응답 헤더와 429 오류

Apollo.io는 인증된 호출에 헤더를 추가합니다. 각 시간 창에 대해 제한, 지금까지의 사용량, 남은 요청 수를 보여줍니다.

  • x-rate-limit-minute, x-rate-limit-hourly, x-rate-limit-24-hour
  • x-minute-usage, x-hourly-usage, x-24-hour-usage
  • x-minute-requests-left, x-hourly-requests-left, x-24-hour-requests-left
  • retry-after: 429와 함께 전송되며, 시간 창이 재설정될 때까지 남은 초를 알려줍니다.

제한을 초과하면 429가 반환됩니다. retry-after를 읽고 기다리세요. 시간 창은 첫 요청 시 시작되며 시계의 정시 기준과 연결되지 않습니다. 오류 본문에는 error_details 객체가 포함됩니다. 자체 제한의 경우 해당 객체의 code는 USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED입니다.

코드에서 팀의 현재 제한을 읽으려면 view API usage stats 엔드포인트를 호출하세요. 한 번의 호출로 최대 74개의 엔드포인트 경로를 확인할 수 있으며, 크레딧도 차감되지 않습니다.

Apollo.io API 크레딧: 비용이 발생하는 항목

많은 호출은 무료입니다. Apollo.io에 따르면 레코드를 생성, 업데이트, 나열 또는 관리하는 엔드포인트는 크레딧 0개를 사용합니다. 크레딧은 보강, 조직 검색, 뉴스 검색 및 AI 인사이트 엔드포인트에 사용되며, 적격 데이터가 반환될 때만 차감됩니다.

엔드포인트크레딧 비용
사람 보강사람당 1~9개: 인구통계 또는 이메일에 1개, 휴대폰 번호가 반환되면 8개 추가
대량 사람 보강동일한 방식 적용, 요청당 최대 10명
조직 보강조직당 1개
조직 검색페이지당 1개, 페이지당 최대 100개 결과
뉴스 기사 검색페이지당 1개, 페이지당 최대 25개 결과
조직 채용 공고페이지당 1개
전체 인물 정보 가져오기사람당 1개
어시스턴트 작업가변적이며, 어시스턴트가 수행하는 작업에 따라 결정

사람 검색은 무료이므로, 먼저 검색한 다음 가장 적합한 결과만 보강하는 방식이 합리적입니다. 크레딧을 사용하는 엔드포인트에서 페이지를 넘길 때마다 모든 페이지에 대해 크레딧이 차감됩니다. Apollo.io는 규모를 확장하기 전에 소규모 테스트를 실행하고 사용량을 확인할 것을 권장합니다.

워터폴 보강은 더 많은 비용이 들 수 있습니다. 이메일 워터폴은 일반적으로 1~4개의 크레딧을 사용하며, 일부 설정에서는 20개 이상을 사용할 수 있습니다. 전화번호 워터폴은 일반적으로 8~25개를 사용하며, 일부 설정에서는 45개 이상을 사용할 수 있습니다.

지출을 추적하려면 앱에서 설정 > 결제 및 크레딧 > 크레딧 사용량을 엽니다. 개발자 대시보드의 사용량 탭에는 현재 결제 주기에 사용된 전화번호 및 이메일 크레딧이 표시됩니다. 기존 요금제는 다를 수 있으므로 워크스페이스의 크레딧 정보 페이지를 확인하세요.

오류 및 상태 코드

대부분의 Apollo.io API 엔드포인트는 다음과 같은 간단한 상태 코드 목록을 공유합니다.

코드의미일반적인 원인
401인증되지 않음키가 없거나, 유효하지 않거나, 비활성 계정에서 발급됨
403금지됨플랜에 API 액세스가 없거나, 범위가 지정된 키에 해당 엔드포인트가 포함되지 않음
404찾을 수 없음레코드가 존재하지 않거나 사용자에게 표시되지 않음
422처리할 수 없음매개변수가 유효하지 않거나 누락됨
429요청이 너무 많음속도 제한을 초과함
500서버 오류Apollo.io 측의 오류이므로 다시 시도해야 함

Apollo.io는 오류를 하나의 형식으로 통합하고 있습니다. 엔드포인트가 새 형식으로 전환된 경우 응답에는 안정적인 code, message, suggestions 및 context가 포함된 error_details 객체가 들어 있습니다. 메시지 텍스트가 아니라 error_details.code를 기준으로 코드 분기를 처리하세요. Apollo.io는 2027년 2월 16일에 기존 최상위 오류 필드를 제거할 예정이므로, 지금 새 객체를 기반으로 구축하세요.

Apollo.io MCP 서버

MCP는 AI 도구가 외부 서비스를 호출할 수 있도록 하는 표준입니다. Apollo.io MCP 서버는 Claude, ChatGPT 및 유사한 클라이언트를 사용자의 Apollo.io 계정과 연결합니다. 그러면 자연어로 다음과 같이 요청할 수 있습니다. SaaS 회사의 VP급 마케팅 리더를 찾아줘, 또는 이 잠재 고객 10명의 정보를 보강해줘.

AI 커넥터, 코딩 플러그인, 독립형 MCP 서버의 세 가지 연결 방법을 보여주는 Apollo.io MCP 문서 페이지

스크린샷: 개발자 문서의 Apollo.io MCP 페이지, 2026년 10월.

연결 방법 세 가지

경로작동 방식
AI 커넥터ChatGPT, Claude, Perplexity, Replit 및 Cursor에 내장된 통합 기능. 서버 설정이 필요하지 않습니다.
코딩 플러그인Codex와 같은 도구를 위한 퍼스트파티 플러그인.
독립형 MCP 서버원격 서버를 지원하는 모든 MCP 클라이언트를 하나의 URL로 연결합니다.

독립형 설정은 간단합니다.

설정값
Endpointhttps://mcp.apollo.io/mcp
TransportStreamable HTTP
Sign-inOAuth 2.0
Local install필요 없음
API key브라우저가 없는 클라이언트가 아니라면 필요 없음

Claude Code에서는 한 개의 명령어로 서버를 추가할 수 있습니다. 명령어를 실행한 다음 /mcp를 입력하고 OAuth 로그인을 완료하세요.

claude mcp add --transport http apollo https://mcp.apollo.io/mcp

여러 워크스페이스를 관리한다면 각 워크스페이스마다 다른 이름으로 동일한 URL을 추가하세요. 각 연결에 개별적으로 로그인합니다.

브라우저가 없는 서버

OAuth에는 브라우저 창이 필요합니다. cron 작업이나 CI 파이프라인에는 브라우저가 없습니다. 이러한 경우 서버는 X-Api-Key로 전송된 API key를 허용합니다. 이 key는 master key여야 합니다. 범위가 지정된 key는 403과 API_INACCESSIBLE 코드를 반환합니다. MCP 서버는 선택할 수 있는 endpoint 중 하나가 아니기 때문입니다.

이 key를 모든 production secret과 동일하게 보관하세요. 이 key는 워크스페이스의 admin 역할을 하며 워크스페이스 credits를 사용합니다. 새로운 MCP 도구는 master key에 즉시 적용되지만, 클라이언트가 캐시된 도구 목록을 유지할 수 있습니다. 다시 연결한 뒤 tools/list를 호출해 목록을 새로 고침하세요.

Apollo.io MCP 서버로 할 수 있는 작업

도구 목록에는 검색 및 잠재 고객 발굴, 사람 및 회사 정보 보강, 연락처, 목록, 시퀀스, 일회성 이메일, 작업, 이메일 도메인 확인 및 분석이 포함됩니다. 정보 보강 작업은 credits를 사용합니다. 대부분의 다른 작업에는 credits가 필요하지 않습니다. Apollo.io는 사람 검색 결과에 이메일이나 전화번호가 포함되지 않는다고 안내하므로, assistant가 해당 정보를 얻으려면 정보 보강 단계를 실행해야 합니다.

문서에 나온 실용적인 제한 사항은 다음과 같습니다.

  • 연결에 대한 추가 요금은 없습니다. 사용자의 요금제, 권한 및 credits가 적용됩니다.
  • 대량 삭제와 같은 파괴적 작업은 지원되지 않습니다.
  • 서버는 사용자의 권한을 따릅니다. OAuth를 사용하면 로그인한 사용자로 작동합니다.
  • Apollo.io MCP는 별도의 rate limits를 사용하며 rate limit headers를 반환하지 않습니다.
  • Apollo.io는 MCP 데이터에 대한 AI 모델 학습을 금지하므로, 먼저 AI 클라이언트에서 학습 기능을 끄세요.

Apollo.io는 credits를 사용하는 작업을 Approval required로 설정할 것을 권장합니다. 그래야 대화가 많은 assistant가 자체적으로 credits를 모두 소진하는 일을 막을 수 있습니다.

Apollo.io API를 사용하는 다른 방법

  • Apollo.io CLI. 전체 API에 액세스할 수 있는 명령줄 도구입니다. Homebrew, 사전 빌드된 바이너리 또는 소스에서 설치할 수 있습니다. OAuth를 사용하므로 키가 필요하지 않습니다.
  • OAuth 2.0. 파트너는 이를 사용해 상호 고객을 위한 API를 호출하며, 문서에는 완성된 통합을 위한 마켓플레이스 애플리케이션도 나와 있습니다.
  • Chrome 확장 프로그램. 코딩보다 클릭을 선호한다면 Apollo Chrome 확장 프로그램 가이드를 읽어보세요.

발송 전에 Apollo.io API에서 주소 확인하기

어떤 경로를 선택하든 데이터에는 한 가지 약점이 있습니다. 데이터베이스에서 가져온다는 점입니다. 사람들은 직장을 바꾸고, 기업은 새로운 도메인으로 이전합니다. email_status 필드는 Apollo.io 자체 레이블일 뿐, 최신 테스트 결과가 아닙니다. 존재하지 않는 주소로 콜드 이메일을 보내면 반송되고, 반송은 발신자 평판을 해칩니다.

따라서 데이터 보강과 시퀀스 사이에 확인 단계를 추가하세요. BillionVerify는 메시지를 보내지 않고 각 주소를 테스트합니다. 구문, 도메인, MX 레코드를 확인하고, 요청하면 SMTP를 통해 사서함도 확인합니다. 일회용 주소와 역할 기반 주소를 표시합니다. Catch-all은 유효한 주소로 계산하지 않고 별도의 결과로 보고합니다. 알 수 없는 결과에는 비용이 들지 않으며, 24시간 이내 재확인은 무료입니다. API를 연결하기 전에 무료 웹 검사기에서 직접 이메일 주소가 존재하는지 확인할 수 있습니다.

상태, 전달 가능 여부 및 사유 필드를 보여주는 BillionVerify 이메일 인증 API 결과

BillionVerify는 각 주소에 대해 상태, 전달 가능 여부 플래그와 사유를 반환합니다.

간단한 파이프라인

간단한 파이프라인은 네 단계로 구성됩니다.

  1. API를 통해 무료 인물 검색을 실행합니다.
  2. 가장 적합한 일치 항목만 데이터 보강합니다.
  3. 각 주소를 BillionVerify REST API로 보냅니다.
  4. 전달 가능한 주소만 시퀀스에 추가합니다.

BillionVerify 호출은 하나의 POST 요청입니다. BV-API-KEY 헤더에 키를 보내고, 실시간 사서함 테스트를 위해 check_smtp를 true로 설정하세요.

curl -X POST https://api.billionverify.com/v1/verify/single \
  -H "BV-API-KEY: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"mark@sumware.com","check_smtp":true}'

응답에는 status, is_deliverable, is_catchall, is_role, is_disposable 및 reason이 포함됩니다. 한 번의 호출로 최대 50개 주소를 처리하려면 일괄 처리 경로를 사용하세요. 전체 내보내기 파일의 경우 CSV, TXT 또는 XLSX 파일을 업로드하고 나중에 결과를 다운로드할 수 있습니다. 전체 참조 자료는 BillionVerify 문서에 있습니다.

AI 클라이언트에서 확인하기

이미 Apollo.io의 MCP 설정을 AI 클라이언트에 연결했다면, 그 옆에 BillionVerify의 호스팅 MCP 서버를 추가하세요. 서버 주소는 https://mcp.billionverify.com/mcp이며 로그인에는 OAuth를 사용합니다. 그러면 어시스턴트가 한 번의 대화에서 Apollo.io를 통해 잠재 고객 정보를 보강하고 주소를 확인할 수 있습니다. 어떤 상태를 허용할지, catch-all을 어떻게 처리할지 등 정책을 알려주세요.

기타 확인 방법

  • Apollo 이메일 인증 페이지에서 내보내기 작업 흐름을 설명합니다.
  • 의심스러운 연락처는 무료 역방향 이메일 조회를 통해 확인할 수 있으며, 해당 주소와 공개적으로 연결된 정보를 보여줍니다.
  • 웹훅으로 반환된 전화번호도 테스트해야 합니다. 무료 전화번호 검증기는 해당 번호가 국가 기준으로 유효한지와 회선 유형을 보여줍니다.

BillionVerify는 계정을 사용하는 날마다 무료 크레딧 20개를 제공하며, 한 달 최대 600개까지 받을 수 있습니다. 크레딧은 만료되지 않으며 신용카드가 필요하지 않습니다.

Apollo.io API 구축 팁

  • 통합마다 범위가 지정된 키 하나로 시작하세요. 하나가 유출되면 해당 키만 폐기하면 됩니다.
  • 먼저 상태 점검을 실행하세요. 코드를 디버깅하기 전에 키 문제를 배제할 수 있습니다.
  • Endpoint essentials 상자를 읽으세요. Apollo.io API의 사람 검색 문서에는 크레딧 비용이 처음부터 표시됩니다.
  • 인리치먼트 전에 검색하세요. 검색은 무료지만 인리치먼트는 무료가 아닙니다.
  • per_page=10으로 테스트하세요. 소규모 실행으로 비용 부담이 커지기 전에 크레딧 비용을 확인할 수 있습니다.
  • retry-after를 준수하세요. 제한된 엔드포인트를 계속 호출하면 대기 시간만 늘어납니다.
  • error_details.code를 읽으세요. 메시지 텍스트는 예고 없이 변경될 수 있습니다.
  • 전송 전에 검증하세요. 반송될 주소에 사용한 크레딧은 두 배로 낭비됩니다.

자주 묻는 질문

Apollo.io에 API가 있나요?

네, Apollo.io에는 REST API가 있습니다. 이를 통해 사람과 회사를 검색하고, 연락처를 보강하며, 계정·딜·시퀀스를 업데이트할 수 있습니다. 기본 액세스는 모든 요금제에 포함됩니다. 사용 중인 요금제에 따라 호출할 수 있는 엔드포인트, 호출 속도 및 각 호출 비용이 달라집니다.

Apollo.io API 키는 어떻게 받나요?

Apollo.io 키는 Settings의 Integrations 영역에서 발급합니다. API Keys를 열고 Create new key를 선택하세요. 키 이름을 지정하고 호출할 수 있는 엔드포인트를 선택한 뒤 확인하고, 시크릿을 즉시 복사합니다. 관리자 또는 적절한 권한 프로필을 가진 사용자가 발급할 수 있습니다.

Apollo.io API 키는 어디에서 찾을 수 있나요?

Apollo.io API 키 목록은 API Keys 페이지에 있으며, 앱이나 개발자 대시보드에서 이동할 수 있습니다. 전체 시크릿은 키를 만들 때 표시됩니다. 시크릿을 잃어버리면 키를 재생성해야 하며, 새 키가 발급됩니다.

Apollo.io API는 무료인가요?

레코드를 생성, 나열 또는 업데이트하는 Apollo.io API 호출은 무료이며, 사람 검색도 무료입니다. 보강 및 일부 검색 엔드포인트는 데이터를 반환할 때 크레딧을 차감합니다. 무료 계정은 무료 요금제의 한도 내에서 API를 호출할 수 있지만, 일부 엔드포인트에는 회사 이메일이 필요합니다.

Apollo.io API의 호출 속도 제한은 어떻게 되나요?

유료 요금제에서는 대부분의 Apollo.io API 엔드포인트가 분당 200회 호출을 허용하며, 시간별 및 일일 한도는 요금제에 따라 다릅니다. 무료 요금제는 분당 50회, 시간당 200회, 일일 600회입니다. 제한은 팀 및 엔드포인트별로 적용되며, 429 응답은 한도를 초과했다는 뜻입니다.

Apollo.io API 상태 확인은 어떻게 테스트하나요?

Apollo.io 상태 확인은 키 헤더를 설정한 뒤 auth/health 경로로 보내는 GET 요청입니다. healthy: true 및 is_logged_in: true 응답은 키가 작동한다는 의미입니다. 크레딧은 차감되지 않습니다.

Apollo.io API 사람 검색에서 이메일을 반환하나요?

아니요. Apollo.io 사람 검색 엔드포인트는 이메일이나 전화번호 없이 프로필만 반환합니다. 연락처 정보를 받으려면 결과에 사람 보강 또는 대량 사람 보강 엔드포인트를 실행해야 하며, 크레딧이 차감됩니다.

Apollo.io API 문서는 어디에 있나요?

Apollo.io API 문서는 docs.apollo.io에 있습니다. 각 엔드포인트에는 매개변수, 테스트 패널 및 예시 응답이 포함된 자체 페이지가 있습니다. OpenAPI 파일을 다운로드해 Postman으로 가져올 수도 있습니다.

Apollo.io MCP 서버란 무엇인가요?

Apollo.io MCP 서버는 Model Context Protocol을 통해 AI 클라이언트와 워크스페이스를 연결합니다. URL은 https://mcp.apollo.io/mcp이며, Streamable HTTP와 OAuth를 사용하고 로컬 설치가 필요하지 않습니다. 요금제, 권한 및 크레딧은 계속 적용됩니다.

Apollo.io에 가장 적합한 MCP 서버는 무엇인가요?

Apollo.io는 공식 MCP 서버 하나를 제공하며, 문서에서도 이를 설명합니다. 타사 옵션은 테스트하지 않았습니다. 앱과 동일한 권한 및 크레딧 규칙을 원한다면 공식 서버를 선택하세요.

Apollo.io API에서 가져온 이메일을 검증해야 하나요?

네, 캠페인을 진행하기 전에 Apollo.io API에서 가져온 모든 이메일 주소를 확인하세요. email_status 필드는 Apollo.io 자체 기록을 반영하며, 사람들은 직장을 옮기기도 합니다. BillionVerify API로 빠르게 확인하면 유효하지 않은 주소를 제거하고 발신자 평판을 보호할 수 있습니다.

영상 보기: 전화번호를 검증하는 방법: 무료 전화번호 검사기

영상 보기: 보내기 전에 Apollo 이메일을 검증하는 방법

Leo
LeoFounder, BillionVerify
이메일 검증 인사이트

오늘 검증을 시작하세요

BillionVerify로 오늘부터 이메일 검증을 시작하세요. 로그인할 때마다 매일 무료 크레딧 20개를 받고 매월 최대 600개까지 쌓입니다 - 신용카드 불필요. 정확한 이메일 검증으로 이메일 마케팅 ROI를 개선하는 수천 개 기업과 함께하세요.

신용카드 불필요 · 실시간 API 및 일괄 검증 · 확인 불가 결과는 무료

0
확인 불가 결과에 사용되는 크레딧
실시간
API 속도
$0.00014
이메일당
600/월
영구 무료