メールアドレスを1件見つける
人物の名前と企業ドメインを入力すると、その人の業務用メールが返ります。1人ずつでも最大10,000人でも、API、コマンドライン、AI、アプリから使えます。
メールアドレス検索は、名、姓、企業ドメインを受け取り、その人の業務用メールを返します。アプリ(サイドバーの「メールアドレス検索」)、REST API、コマンドライン、MCPツールのどれでも同じように動作します。
料金
料金は検索ごとに、結果に応じて、ほかのすべての操作と同じクレジットから支払います。
| 結果 | status | 料金 |
|---|---|---|
| 見つかり、確認済み | valid | 1クレジット |
企業のドメインがすべてのアドレスを受け付けるため、どれも確認できません。最も可能性の高いアドレスがconfirmed: false付きで返ります | catch_all | 1クレジット |
| 見つからなかった | not_found | 0.25クレジット |
| 入力の誤り、メールのないドメイン、または現時点で到達できなかったメールサーバー | 400, no_mail_domain, retry_later | 無料 |
0.25クレジットは、少額の前払い残高から差し引かれます。何も見つからなかった最初の検索で1クレジットが引かれ、そのうち0.75が次の3回分として残ります。GET /api/v1/email-finder/pricingで、料金、残高、上限を確認できます。
catch_allのアドレスは、有力な推測として扱ってください。少ない件数で送信し、バウンスを確認してください。
1人の場合
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"}'{ "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テキストとして、支出の上限とともに送ります。
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_limit | max_creditsに達しました | より高い上限で再開します |
insufficient_credits | アカウントのクレジットがなくなりました | クレジットを追加してから再開します |
daily_limit | 1日の検索上限に達しました | 対処は不要です。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が返ります。
ターミナルから使う
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 pricingAIアシスタントから使う
MCPサーバーには、1人向けのargorant_find_emailと、リスト向けのargorant_find_emails(支出の上限の指定が必須)に加え、argorant_find_emails_statusとargorant_manage_find_emailsがあります。ツールを参照してください。