最初の呼び出し
クイックスタートです。1つのAPIキーで、市場の件数を確認し、人物を見て、数人を表示し、リストとして保存し、キャンペーンを準備します。件数確認と閲覧は無料です。
APIキーが必要です。app.argorant.com/profileの「APIキー」で作成してください。キーはag_live_で始まり、一度だけ表示されます。新しいアカウントにはすべて、100クレジットとキャンペーンメール300通付きの7日間の無料トライアルがあります。
export ARGORANT_API_KEY=ag_live_...キーを確認する
curl "https://app.argorant.com/api/v1/account" -H "Authorization: Bearer $ARGORANT_API_KEY"プラン、クレジット、キーが1分間に送れるリクエスト数、今日の上限の残りが表示されます。
市場の件数を確認する(無料)
curl -G "https://app.argorant.com/api/v1/people/count" \
-H "Authorization: Bearer $ARGORANT_API_KEY" \
--data-urlencode "title=CFO" --data-urlencode "country=Germany" --data-urlencode "employee_range=51-200"
# {"count": 4210}どの語を使えばよいかわからない場合は、GET /api/v1/lookups/industries?q=softとGET /api/v1/lookups/titles?q=head ofで、正確な名前とそれぞれに該当する人数がわかります。
該当する人物を見る(無料)
curl -G "https://app.argorant.com/api/v1/people/search" \
-H "Authorization: Bearer $ARGORANT_API_KEY" \
--data-urlencode "title=CFO" --data-urlencode "country=Germany" --data-urlencode "employee_range=51-200" --data-urlencode "limit=10"各行には役職、企業、所在地が表示されます。名前はイニシャルだけで、連絡先は含まれません。どの行にもrecord_idがあります。
数人を表示する
この操作はクレジットを消費します。アプリやエージェントでは、先に価格を示して確認を取ってください。
curl -X POST "https://app.argorant.com/api/v1/people/reveal" \
-H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Idempotency-Key: first-reveal-1" \
-H "Content-Type: application/json" \
-d '{"title":"CFO","country":"Germany","employee_range":"51-200","limit":5}'どのメールも、受け取る直前にチェックされます。支払うのはメールがチェックを通過した人物1人につき1クレジットだけで、それ以外は無料です。credits_chargedで費用がわかります。
検索をリストとして保存する
curl -X POST "https://app.argorant.com/api/v1/lists" \
-H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Idempotency-Key: first-list-1" \
-H "Content-Type: application/json" \
-d '{"name":"CFOs Germany 51-200","filters":{"title":"CFO","country":"Germany","employee_range":"51-200"}}'保存は無料で、誰も表示されません。list_idを控えておいてください。
キャンペーンを準備する
curl -X POST "https://app.argorant.com/api/v1/campaigns" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: first-campaign-1" \
-H "Content-Type: application/json" -d '{"name":"CFOs Germany Q4","daily_limit":40}'キャンペーンは下書きとして作成されます。開始するまで何も送信されません。続き(メール、人物、メールボックス、開始)は200人を見つけてメールを送るで説明しています。
ターミナルでも同じ手順を実行できます。npx argorant count、npx argorant search、npx argorant reveal、npx argorant list create、npx argorant campaigns createです。ClaudeやChatGPTでは、https://mcp.argorant.com/mcpを接続して、普段の言葉で頼んでください。