캐치올(catch-all) 주소까지 판별하는 이메일 검증 API
REST 호출 한 번으로 메일함이 있는지 검사합니다. 캐치올 도메인에서는 대부분의 API가 “accept-all(모든 주소 수신)”이나 “위험”에서 멈추지만, 이 API는 같은 응답에 유효 또는 무효 결과를 드립니다. 이 이메일 검증 API는 개발팀에 깔끔한 JSON 데이터를 제공해, 아웃리치 파이프라인 전반에서 발신자 평판을 지키도록 돕습니다.
curl -X POST https://api.giggal.ai/v1/verify \
-H "Authorization: Bearer tp_live_xxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"email":"alex.smith@example.com"}'무료 크레딧 1,000개, 신용카드 불필요. 크레딧 유효기간 없음.
Giggal.ai는 SourceForge와 Slashdot에서 Leader로 평가받았습니다
API 호출 한 번으로 받는 결과
호출 한 번으로 전체 도달률 데이터를 받습니다. 최상위 전송 상태, 위험 평가, 숫자로 된 도달률 점수, 메일함 속성, 캐치올 결과가 함께 들어 있습니다.
{
"success": true,
"data": {
"email": "alex.smith@example.com",
"is_valid": true,
"status": "deliverable",
"risk_level": "low",
"deliverability_score": 92,
"catch_all_score": 89,
"catch_all_verdict": "valid",
"details": {
"general": {
"domain": "example.com",
"reason": "Mailbox confirmed deliverable"
},
"attributes": {
"free_email": false,
"role_account": false,
"disposable": false,
"catch_all": true,
"has_plus_tag": false,
"mailbox_full": false,
"no_reply": false
},
"mail_server": {
"smtp_provider": "google",
"mx_record": "aspmx.l.google.com"
}
}
},
"meta": {
"creditsUsed": 1
}
}응답 상태 값을 처리하는 방법
기본 전송 상태는 status 필드로 반환됩니다. 백엔드 애플리케이션에서 각 enum 값을 다음과 같이 해석하고 처리하십시오.
| 상태 | 의미 | 권장 조치 |
|---|---|---|
| deliverable | 수신 메일 서버가 수신자를 받아들였습니다. 메일함이 활성 상태입니다. | 발송해도 안전합니다. 주요 아웃리치 캠페인에 포함하십시오. |
| undeliverable | 메일함이 없거나, 형식이 잘못되었거나, 도메인에 MX 레코드가 없거나, 일회용 도메인입니다. | 발송하지 마십시오. 하드 바운스를 피하려면 캠페인에서 지우십시오. |
| unknown | 서버 응답이 분명하지 않습니다. 보통 그레이리스팅이나 연결 시간 초과 때문입니다. | 나중에 다시 검사하십시오. 알 수 없음 결과에 사용한 크레딧은 자동으로 환불됩니다. |
캐치올 주소도 같은 호출에서 판별
일반 검사는 캐치올 도메인에서 실패합니다. 회사 메일 서버가 들어오는 모든 주소를 받으면, 일반 도구는 실제 메일함과 오타 주소에서 똑같이 긍정 응답을 받습니다. 더 검증할 수 없으므로, 대부분의 도구는 주소에 “위험” 또는 “accept-all” 표시를 붙이고 판단을 고객님께 넘깁니다.
일반적인 B2B 리스트의 약 30%는 캐치올 도메인이거나 Proofpoint, Mimecast 같은 보안 이메일 게이트웨이(SEG) 뒤에 있는 도메인입니다. 이 주소들을 지우면 실제 구매자를 버리게 되고, 검증하지 않고 보내면 반송이 급증합니다.
이 검증 엔진은 같은 호출 안에서 캐치올 심층 판별을 실행합니다. 메일함이 있는지 검사해 catch_all_verdict(“valid” 또는 “invalid”)와 0~100 사이의 catch_all_score를 반환합니다. 자세한 내용은 캐치올 검증 가이드와 보안 이메일 게이트웨이 뒤의 메일함 검사 가이드를 참고하십시오.
기존 검증 API
accept-all 도메인에서 멈춤
{
"email": "sarah.connor@cyberdyne.com",
"status": "risky",
"reason": "accept_all_domain",
"is_deliverable": null,
"action": "manual_review_required"
}불확실한 판단이 팀에 넘어옵니다. 보내고 높은 반송률을 감수하거나, 실제 구매 후보를 버려야 합니다.
Giggal.ai API
캐치올을 같은 호출에서 판별
{
"email": "sarah.connor@cyberdyne.com",
"status": "deliverable",
"is_valid": true,
"catch_all_verdict": "valid",
"catch_all_score": 94,
"details": { "catch_all": true }
}활성 메일함이 확인됩니다. 실제 캐치올 리드를 남기고 발신자 평판을 지킬 수 있습니다.
단일, 대량, 캐치올 검사용 엔드포인트
연락처 하나를 검사하든 큰 리스트를 검증하든, 이 이메일 검증 API에는 성능과 안정성을 고려한 용도별 엔드포인트가 있습니다.
단일 이메일 검증
이메일 주소 하나를 동기 방식으로 검증합니다. 주소가 있는지 검사하고, 도메인 진단을 실행하고, 캐치올 주소를 같은 호출에서 판별합니다. 전체 JSON 결과를 반환합니다.
엔드포인트 문서 보기대량 이메일 검증
작업 1개에 주소 최대 50,000개를 비동기 방식으로 처리합니다. 중복 주소와 잘못된 형식은 서버에서 제거합니다. 이중 과금을 막는 Idempotency-Key 헤더를 지원합니다.
작업 폴링과 결과
GET /v1/jobs/:jobId 엔드포인트로 10~15초마다 작업 진행 상황을 확인합니다. 결과는 페이지당 최대 500건씩 가져옵니다. 결과는 48시간 동안 안전하게 보관됩니다.
대량 캐치올 판별
완료된 대량 작업에서 캐치올로 표시된 주소에 캐치올 심층 판별을 실행합니다. 점수 열과 상태 열이 있는 CSV 파일로 결과를 다운로드합니다.
캐치올 문서 보기모든 응답에 들어 있는 플래그
유효 또는 무효 외에도 모든 응답에는 자세한 메일함 속성이 들어 있습니다. 리드를 분류하고, 악용을 막고, 자동 필터 규칙을 적용할 때 사용합니다.
| 플래그 | 필드 경로 | 설명과 사용법 |
|---|---|---|
| 일회용 | details.attributes.disposable | 임시 일회용 메일함을 찾아냅니다. 체험판 악용을 막으려면 바로 차단하십시오. |
| 역할 계정 | details.attributes.role_account | 부서 공용 메일함(info@, billing@, support@)을 찾아냅니다. CRM 팀에 배정하십시오. |
| 무료 이메일 | details.attributes.free_email | 개인용 웹메일 도메인(gmail.com, yahoo.com)을 표시해 개인 메일함과 회사 잠재 고객을 구분합니다. |
| 캐치올 | details.attributes.catch_all | 호스트가 모든 메일을 받는지 표시합니다. catch_all_verdict와 함께 사용하면 유효한 리드를 살릴 수 있습니다. |
| 플러스 태그 | details.attributes.has_plus_tag | 하위 주소 별칭(user+tag@)을 사용하는 주소를 찾아냅니다. 여러 계정을 만드는 악용을 막습니다. |
| 메일함 가득 참 | details.attributes.mailbox_full | 저장 용량을 초과한 메일함입니다. 이 주소로 보낸 메일은 소프트 바운스됩니다. |
| 회신 불가(No-Reply) | details.attributes.no_reply | 아무도 확인하지 않는 발송 전용 주소를 표시합니다. 대화형 아웃리치는 이 주소로 보내지 마십시오. |
| 블랙리스트 검사 | details.blacklist.is_blacklisted | 도메인과 서버 IP를 주요 DNSBL 목록에서 확인하고 평판 점수를 제공합니다. |
이메일 검증 API 활용 사례
엔드포인트는 데이터 파이프라인, CRM 워크플로, 데이터베이스에 바로 연결됩니다.
CRM과 데이터 웨어하우스 동기화
Salesforce, HubSpot, Snowflake에 동기화하기 전에 연락처 데이터를 계속 검증합니다. 오래된 기록을 정기적으로 정리해 연락처 데이터를 정확하게 유지합니다.
캠페인 리스트 정리
대규모 아웃리치 발송 전에 이메일 리스트를 정리합니다. 간단한 수작업이라면 이메일 리스트 정리 화면에서 리스트를 바로 업로드할 수도 있습니다.
리드 보강 파이프라인
인바운드 SDR 도구나 아웃바운드 보강 도구가 새 회사 이메일을 찾을 때마다 메일함 검사를 자동으로 실행합니다. 영업 담당자는 검증된 주소에만 연락합니다.
워크플로 자동화
연동 페이지에서 검증 엔드포인트를 Zapier, n8n, Make, 웹훅 워크플로에 바로 연결합니다.
MCP를 통한 AI 에이전트
Claude, ChatGPT, Cursor와 직접 만든 AI 에이전트가 MCP 서버를 통해 대화 중에 연락처를 바로 검증합니다.
가입 폼 검증
사용자가 가입 폼이나 리드 수집 폼에 입력하는 주소를 바로 검사하고 싶으십니까? 실시간 폼 검사용으로 만든 이메일 유효성 검사 API를 확인해 보십시오.
코드 예제
단일 검사와 대량 검사용 서버 측 코드입니다. API 키는 환경 변수에 보관하십시오.
// Node.js (Node 18+)
const res = await fetch('https://api.giggal.ai/v1/verify', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ email: 'alex.smith@example.com' }),
});
const data = await res.json();
if (data.success) {
console.log('Status:', data.data.status); // deliverable, undeliverable, unknown
console.log('Catch-all result:', data.data.catch_all_verdict); // valid | invalid
} else {
console.error('Verification error:', data.error);
}import os
import requests
url = "https://api.giggal.ai/v1/verify"
headers = {
"Authorization": f"Bearer {os.environ['GIGGAL_API_KEY']}",
"Content-Type": "application/json"
}
payload = {"email": "alex.smith@example.com"}
response = requests.post(url, json=payload, headers=headers)
result = response.json()
if result.get("success"):
data = result["data"]
print("Status:", data["status"])
print("Catch-All Result:", data.get("catch_all_verdict"))
else:
print("Error:", result.get("error"))대량 워크플로: 제출, 폴링, 결과 가져오기
배치 작업 제출은 호출 한 번이면 됩니다. 작업 상태가 completed가 될 때까지 10~15초마다 폴링하십시오.
// 1. Submit batch job (up to 50,000 emails)
const submitRes = await fetch('https://api.giggal.ai/v1/verify-batch', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': 'batch-job-2026-10-01-01',
},
body: JSON.stringify({
name: 'Q4 Sales Leads',
emails: ['alex.smith@example.com', 'maria.garcia@example.org'],
}),
});
const { data: job } = await submitRes.json();
const jobId = job.jobId;
// 2. Poll job status until completed
// GET https://api.giggal.ai/v1/jobs/${jobId}
// 3. Fetch paginated verification results
const resultsRes = await fetch(`https://api.giggal.ai/v1/jobs/${jobId}/results?page=1&limit=500`, {
headers: { 'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}` },
});
const results = await resultsRes.json();이메일 검증 API 요금
월 약정 없는 간단한 종량제 요금입니다. 크레딧 1개로 주소 1개를 검증합니다. 단일 API 검사에서는 캐치올 판별이 같은 크레딧 1개에 포함됩니다. 대량 배치 작업에서는 일반 검증이 주소 1개당 크레딧 1개이고, 캐치올 행에 심층 검증을 실행하면 검사한 캐치올 주소 1개당 크레딧 1개가 듭니다. 크레딧은 유효기간이 없고, 알 수 없음 결과는 자동으로 환불됩니다.
더 많은 양이 필요하십니까? 전체 요금 구간을 확인하십시오.
요청 한도와 오류
API 키마다 기본 요청 한도가 적용됩니다. 모든 요청의 한도 상태는 표준 헤더인X-RateLimit-Limit과X-RateLimit-Remaining으로 반환됩니다.
15분 단위 요청 한도
- 단일 검사 (/v1/verify)15분당 요청 300회
- 배치 작업 생성15분당 요청 30회
- 캐치올 작업 생성15분당 요청 30회
- 작업 폴링과 결과15분당 요청 600회
HTTP 상태 오류 코드
- 400 Bad Request: 형식이 잘못되었거나 JSON 본문이 올바르지 않습니다.
- 401 Unauthorized: API 키가 없거나, 만료되었거나, 올바르지 않습니다.
- 402 Payment Required: 계정의 크레딧 잔액이 부족합니다.
- 404 Not Found: 요청한 작업 ID가 없습니다.
- 409 Conflict: 멱등성 키(idempotency key)의 페이로드가 충돌합니다.
- 410 Gone: 배치 작업 결과가 48시간이 지나 만료되었습니다.
- 429 Too Many Requests: 요청 한도를 초과했습니다.
오류 응답 형식과 페이로드 설명은 API 오류 문서에서 자세히 확인할 수 있습니다.
고객 후기
Giggal.ai를 사용하는 엔지니어링, 영업, 그로스 팀의 실제 후기입니다. 후기는 고객이 작성한 원문(영어) 그대로 싣습니다.
"Before Giggal, our team spent hours manually reviewing catch-all addresses because other tools couldn't verify them with confidence. Now we upload large email lists, verify them in minutes, and move directly into campaign preparation."
Vernon L.
G2 인증 리뷰어
"Fast and accurate email verification, excellent catch-all detection, easy-to-use interface, quick processing for large lists, lower bounce rates, improved sender reputation, and more confidence before launching email campaigns."
Billy W.
SourceForge 리뷰어
"Giggal Email Verifier makes email validation fast, simple, and reliable. It helps us clean our lists, reduce bounce rates, and improve the overall performance of our outreach campaigns. The accuracy of the verification results makes it a valuable tool."
Hazel Peterson
Product Hunt 리뷰어
이메일 검증 API FAQ
인증, 메일함 검사, 캐치올 처리에 관해 자주 묻는 기술 질문입니다.
네. 새 계정은 가입 즉시 무료 크레딧 1,000개를 받으며, 신용카드는 필요 없습니다. 개발자 대시보드에서 API 키를 만들고 바로 검증 요청을 보낼 수 있습니다. 무료 크레딧은 유효기간이 없고, 전체 메일함 검사와 캐치올 심층 판별을 포함한 모든 엔드포인트를 사용할 수 있습니다.
API는 메일함이 있는지 검사합니다. DNS와 MX 조회를 실행하고, 수신 메일 서버에 연결해 해당 메일함이 있고 메일을 받을 수 있는지 확인합니다. 메시지를 전송하기 전에 연결을 정상적으로 닫으므로, 수신자는 이메일을 받지 않습니다.
캐치올 도메인에서는 메일 서버가 모든 주소를 받을 수 있다고 응답합니다. 그래서 일반 도구는 “위험” 또는 “알 수 없음”을 반환합니다. Giggal은 메일함이 있는지 검사하고, 0~100 사이의 catch_all_score와 함께 유효 또는 무효 결과를 반환합니다. 실제 리드를 버리지 않아도 됩니다.
“알 수 없음” 상태는 수신 메일 서버가 제한 시간 안에 분명한 답을 주지 않을 때 나옵니다. 보통 강한 그레이리스팅이나 일시적인 서버 장애 때문입니다. 결론이 나지 않은 결과에는 비용이 청구되지 않습니다. 알 수 없음 상태로 끝난 검증에 사용한 크레딧은 계정 잔액으로 자동 환불됩니다.
단일 검증 요청은 호출 한 번에 이메일 1개를 동기 방식으로 검사하고 JSON 응답을 바로 반환합니다. 리스트 검증에는 대량 API 엔드포인트를 사용하며, 배치 작업 1개에 이메일 주소 최대 50,000개를 비동기 방식으로 처리합니다. 작업 폴링으로 진행 상황을 확인하고, 처리가 끝나면 페이지 단위로 결과를 가져옵니다.
네. Giggal.ai는 공식 원격 MCP(Model Context Protocol) 서버(https://mcp.giggal.ai/mcp)를 운영합니다. Claude와 ChatGPT는 OAuth로 이 서버에 연결하며, API 키가 필요 없습니다. Cursor, VS Code 같은 클라이언트의 로컬 개발 환경에서는 API 키로 로컬 giggal-mcp 서버를 설정해 편집기에서 바로 주소를 검증할 수 있습니다.
이메일 검증 API는 수신 메일 서버와 직접 통신하고, DNS 레코드를 확인하고, 캐치올 주소를 판별해 실제 메일함이 있는지 평가합니다. 영업 리스트와 고객 데이터베이스에 사용합니다. 이메일 유효성 검사 API는 주로 가입 폼의 실시간 검사에 사용합니다. 제출 시점에 형식을 확인하고, 일회용 도메인을 찾아내고, 가짜 계정을 막습니다. 폼 보호가 필요하다면 이메일 유효성 검사 API를 확인해 보십시오.
세 가지를 확인하십시오. 첫째, 실제 캐치올 판별입니다. 그래야 B2B 연락처의 최대 30%를 “위험” 분류로 잃지 않습니다. 둘째, 알 수 없음 결과를 자동으로 환불하는 투명한 과금 정책입니다. 셋째, 숨은 정기 요금이나 월 최소 금액이 없는 명확한 검증당 요금입니다.
몇 분 안에 이메일 검증을 시작하십시오
무료 크레딧 1,000개를 드립니다. 신용카드는 필요 없습니다.
