문서/대량 검증

대량 검증

이메일 주소 CSV를 업로드하고 리스트 전체의 결과를 받아보세요.

Markdown 보기 OpenAPI JSON

개요

대량 검증을 사용하면 한 번의 작업으로 수천 개의 이메일 주소를 검증할 수 있어요. 대시보드나 API로 CSV 파일을 업로드하고, 작업이 완료되면 결과를 다운로드하세요.

ℹ️
대량 검증은 대시보드와 API에서 이용할 수 있어요. CSV 파일은 POST /api/bulk로 업로드하고, 상태는 GET /api/bulk/{job_id}로 확인한 뒤, 결과는 다음 경로에서 다운로드하세요: /api/bulk/{job_id}/download.

API로 업로드하기

API 키와 함께 multipart 형식으로 CSV를 업로드하세요. 필요하면 email_column 파라미터로 이메일 열을 지정할 수 있어요. 이메일 열 이름이 다음과 다를 때 사용하세요: email.

bash
curl -X POST https://verimails.com/api/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@leads.csv" \
  -F "name=May outreach" \
  -F "email_column=Email Address"

대시보드로 업로드하기

  1. 다음에 로그인하세요: verimails.com/dashboard
  2. 사이드바에서 대량 검증 메뉴를 클릭하세요
  3. CSV 파일 업로드
  4. 작업이 완료될 때까지 기다리기 (작업 목록에 표시돼요)
  5. 결과 CSV 다운로드

CSV 형식

CSV에는 이메일 주소가 담긴 열이 있어야 해요. VeriMails는 다음과 같은 일반적인 헤더를 자동으로 감지해요: email, Email Address, work_email, business_email. 헤더 없는 단일 열 CSV도 지원하지만, 명확한 이메일 헤더를 두는 것이 가장 좋아요:

csv
email
john@example.com
jane@company.com
info@business.io
sales@corp.net

추가 열은 결과 파일에 그대로 유지되며 처리에 영향을 주지 않아요.

지원 형식

결과 형식

전체 결과 파일은 원본 CSV 열을 유지하고, 발송 가능 여부를 나타내는 명확한 열을 추가해요:

추가되는 열설명
Safe to SendYes (검증 상태가 유효일 때); No (유효하지 않음, 캐치올, 일회용, 알 수 없음, 위험 결과일 때).

작업 상태 확인하기

대시보드의 작업 목록에서 실시간 진행 상황을 볼 수 있어요. API로는 GET /api/bulk/{job_id} 엔드포인트를 작업 상태가 다음 값이 될 때까지 폴링하세요: completed 또는 failed.

웹훅 알림

대량 작업 완료 웹훅은 곧 지원될 예정이에요. 참고: 웹훅 →

💡
팁: 실시간으로 리스트를 만들 때는 단건 검증 API 로 수집하는 즉시 주소를 검증하세요. 대량 검증은 기존 리스트를 정리하는 데 가장 적합해요.