ArgorantDocs

이메일 하나 찾기

인물의 이름과 회사 도메인을 넣으면 업무용 이메일이 나옵니다. 한 명씩 또는 최대 10,000명까지, API, 명령줄, AI, 앱에서 쓸 수 있습니다.

이메일 찾기는 이름, 성, 회사 도메인을 받아 그 인물의 업무용 이메일을 돌려줍니다. 앱(사이드바의 이메일 찾기), REST API, 명령줄, MCP 도구에서 똑같이 작동합니다.

비용

조회할 때마다 결과에 따라 다른 모든 기능과 같은 크레딧에서 비용을 냅니다.

결과status가격
찾았고 확인됨valid1크레딧
기업 도메인이 모든 주소를 받아서 어떤 주소도 확인할 수 없습니다. 가장 가능성이 높은 주소가 confirmed: false 표시와 함께 제공됩니다catch_all1크레딧
찾지 못함not_found0.25크레딧
잘못된 입력, 이메일이 없는 도메인, 지금 연결할 수 없는 메일 서버400, no_mail_domain, retry_later무료

0.25크레딧은 소액 선불 잔액에서 차감됩니다. 아무것도 찾지 못한 첫 조회에서 1크레딧이 들고, 남은 0.75크레딧은 다음 세 번의 조회에 쓰입니다. GET /api/v1/email-finder/pricing은 가격, 잔액, 한도를 보여 줍니다.

catch_all 주소는 꽤 믿을 만한 추정으로 다루세요. 적은 양으로 보내고 반송을 지켜보세요.

한 명

Shell
curl -X POST "https://app.argorant.com/api/v1/email-finder/find" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: find-jane-doe-acme" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Jane", "last_name": "Doe", "domain": "acme.com"}'
JSON
{ "status": "valid", "email": "jane.doe@acme.com", "confirmed": true, "confidence": 95, "credits_charged": 1,
  "message": "Found and confirmed jane.doe@acme.com. 1 credit charged." }

각 호출은 그 호출의 결과에 따라 과금됩니다. 아무것도 찾지 못한 조회를 그대로 반복하지 말고, 먼저 이름이나 도메인을 고치세요. {"name": "Dr. Jane Doe", "domain": "acme.com"}처럼 전체 이름을 보내도 됩니다.

여러 명

최대 10,000명을 rows나 CSV 텍스트로, 지출 한도와 함께 보내세요.

Shell
curl -X POST "https://app.argorant.com/api/v1/email-finder/jobs" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: q4-accounts-finder" \
  -H "Content-Type: application/json" \
  -d '{"name": "Q4 accounts", "max_credits": 100, "rows": [{"first_name": "Jane", "last_name": "Doe", "domain": "acme.com", "ref": "crm-1042"}]}'

응답에는 job_id와 리스트에 들 수 있는 최대 비용인 maximum_charge가 들어 있습니다. 약 30초마다 GET /api/v1/email-finder/jobs/{job_id}로 작업을 확인하고, .../results에서 행을 읽거나 .../results?format=csv로 한 번에 받으세요.

리스트는 실패하지 않고 일시정지됩니다.

paused_reason일어난 일할 일
spend_limitmax_credits에 도달했습니다더 높은 한도로 재개하세요
insufficient_credits계정의 크레딧이 떨어졌습니다크레딧을 추가한 뒤 재개하세요
daily_limit일일 조회 한도에 도달했습니다할 일은 없습니다. UTC 자정이 지나면 계속됩니다
miss_rate대부분의 조회에서 아무것도 찾지 못해 속도가 느려졌습니다할 일은 없습니다. 계속 진행됩니다. 이름과 도메인을 확인하세요

POST .../resume(선택으로 {"max_credits": 150})으로 재개하고 POST .../cancel로 중지하세요. 조회하지 않은 행은 과금되지 않습니다.

사용할 수 있는 CSV 열은 first_name과 last_name(또는 name이나 full_name), domain(또는 company_domain이나 website), 그리고 결과와 함께 돌아오는 선택 항목 id 또는 ref입니다.

한도

계정당 단건 조회는 분당 30회, 하루 2,000회입니다. 조회 결과가 거의 나오지 않는 계정은 한동안 시간당 20회로 느려집니다. 그렇다고 비용이 더 드는 일은 없습니다. 이 한도를 넘으면 finder_rate_limit, finder_daily_limit, finder_miss_rate_throttle 중 하나와 함께 429를 받습니다.

플랜도 없고 크레딧 팩의 크레딧도 없는 계정은 하루에 새 이메일을 최대 10개까지 찾을 수 있으며, 이 수에는 공개와 내보내기도 함께 포함됩니다. 그 이후에는 429 daily_limit_reached를 받습니다.

터미널에서

Shell
npx argorant find "Jane Doe" --domain acme.com
npx argorant find --file people.csv -o found.csv --max-credits 100
npx argorant find status <job_id>
npx argorant find pricing

AI 어시스턴트에서

MCP 서버에는 한 명을 위한 argorant_find_email과 리스트를 위한 argorant_find_emails(반드시 지출 한도를 설정해야 함)가 있고, argorant_find_emails_status와 argorant_manage_find_emails도 있습니다. 도구를 참고하세요.

이 페이지의 내용