ArgorantDocs

メールアドレスを1件見つける

人物の名前と企業ドメインを入力すると、その人の業務用メールが返ります。1人ずつでも最大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が次の3回分として残ります。GET /api/v1/email-finder/pricingで、料金、残高、上限を確認できます。

catch_allのアドレスは、有力な推測として扱ってください。少ない件数で送信し、バウンスを確認してください。

1人の場合

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が含まれます。GET /api/v1/email-finder/jobs/{job_id}で約30秒ごとにジョブを確認し、.../resultsから行を読み取るか、.../results?format=csvでまとめて取得します。

リストは失敗する代わりに一時停止します。

paused_reason状況対処
spend_limitmax_creditsに達しましたより高い上限で再開します
insufficient_creditsアカウントのクレジットがなくなりましたクレジットを追加してから再開します
daily_limit1日の検索上限に達しました対処は不要です。UTCの午前0時を過ぎると続行します
miss_rateほとんどの検索で見つからなかったため、速度が落とされました対処は不要です。処理は続行します。名前とドメインを確認してください

POST .../resume(必要に応じて{"max_credits": 150})で再開し、POST .../cancelで停止します。検索されなかった行に料金がかかることはありません。

使えるCSVの列は、first_nameとlast_name(またはnameかfull_name)、domain(またはcompany_domainかwebsite)、そして結果とともに返される任意のidまたはrefです。

上限

アカウントごとに、単発の検索は1分あたり30回、検索全体は1日2,000回までです。検索でほとんど何も見つからないアカウントは、しばらくの間1時間あたり20回に制限されます。料金が増えることはありません。これらの上限を超えると、finder_rate_limit、finder_daily_limit、finder_miss_rate_throttleのいずれかを含む429が返ります。

プランがなく、パックで購入したクレジットもないアカウントは、表示とエクスポートと合わせて1日最大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サーバーには、1人向けのargorant_find_emailと、リスト向けのargorant_find_emails(支出の上限の指定が必須)に加え、argorant_find_emails_statusとargorant_manage_find_emailsがあります。ツールを参照してください。

このページの内容