이메일 파인더 API

이름, 성, 회사 도메인으로 검증된 업무용 이메일을 찾아요.

과금 규칙

이메일 파인더는 검증된 이메일을 찾았을 때만 20 크레딧이 차감돼요. 검증된 결과가 없거나, 입력값이 잘못되었거나, 캐치올 결과인 경우에는 과금되지 않아요. 대량 및 CSV 요청은 작업에서 반환될 수 있는 검증된 이메일 수만큼 현재 크레딧이 충분해야 해요.

이용 방법

다음 값을 보내요: first_name, last_name, domain.
VeriMails가 입력된 이름과 도메인으로 검증된 개인 메일함을 확인해요.
결과는 실시간 검증을 마친 뒤에만 반환돼요.
검증된 메일함을 확인할 수 없으면 API는 다음을 반환해요: not_found 또는 catch_all.
인물 조회의 경우, 확인 가능한 검증된 개인 이메일 주소가 있으면 VeriMails가 이를 반환해요.

이메일 1건 찾기

POST /api/find-email

애플리케이션이나 팀 도구에서 한 건씩 조회할 때 사용하세요.

필드	필수	설명
`first_name`	예	찾을 사람의 이름(first name).
`last_name`	예	찾을 사람의 성(last name).
`domain`	예	회사 도메인(예: `acme.com`). URL을 넣어도 API가 자동으로 정규화해요.

cURL

curl -X POST https://verimails.com/api/find-email \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Jane","last_name":"Doe","domain":"company.com"}'

JSON

{
  "found": true,
  "email": "jane.doe@company.com",
  "status": "found",
  "confidence": 0.95,
  "elapsed_ms": 420
}

최대 100건 동기 방식으로 찾기

소량 배치는 동기식 대량 엔드포인트를 사용하세요. 더 큰 파일은 아래 CSV 방식을 이용하세요.

cURL

curl -X POST https://verimails.com/api/find-email/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "leads": [
      {"first_name":"Jane","last_name":"Doe","domain":"company.com"},
      {"first_name":"Sam","last_name":"Lee","domain":"example.com"}
    ]
  }'

CSV 이메일 파인더

대규모로 이메일을 찾아야 할 때는 CSV를 업로드하세요. CSV에는 이름, 성, 도메인 열이 있어야 해요. 지원하는 열 이름 별칭은 다음과 같아요: firstname, lastname, company_domain, website, company_website.

CSV

first_name,last_name,domain
Jane,Doe,company.com
Sam,Lee,example.com

cURL

curl -X POST https://verimails.com/api/find-email/csv \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@leads.csv"

curl https://verimails.com/api/find-email/csv/JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://verimails.com/api/find-email/csv/JOB_ID/download \
  -H "Authorization: Bearer YOUR_API_KEY" -o finder_results.csv

출력 CSV에 추가되는 열: found_email, finder_status, finder_confidence, finder_elapsed_ms.

상태

상태	의미	결제
`found`	검증된 이메일을 찾았어요.	과금
`not_found`	검증된 개인 이메일을 찾지 못했어요.	과금 없음
`catch_all`	도메인이 모든 주소를 받아들이는 설정이라 메일함을 확인할 수 없어요.	과금 없음
`invalid_input`	필수 이름 또는 도메인 필드가 비어 있어요.	과금 없음
`insufficient_credits`	요청을 처리할 만큼의 크레딧이 계정에 없어요.	과금 없음