ArgorantDocs

最初の呼び出し

クイックスタートです。1つのAPIキーで、市場の件数を確認し、人物を見て、数人を表示し、リストとして保存し、キャンペーンを準備します。件数確認と閲覧は無料です。

APIキーが必要です。app.argorant.com/profileの「APIキー」で作成してください。キーはag_live_で始まり、一度だけ表示されます。新しいアカウントにはすべて、100クレジットとキャンペーンメール300通付きの7日間の無料トライアルがあります。

Shell
export ARGORANT_API_KEY=ag_live_...

キーを確認する

Shell
curl "https://app.argorant.com/api/v1/account" -H "Authorization: Bearer $ARGORANT_API_KEY"

プラン、クレジット、キーが1分間に送れるリクエスト数、今日の上限の残りが表示されます。

市場の件数を確認する(無料)

Shell
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で、正確な名前とそれぞれに該当する人数がわかります。

該当する人物を見る(無料)

Shell
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があります。

数人を表示する

この操作はクレジットを消費します。アプリやエージェントでは、先に価格を示して確認を取ってください。

Shell
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で費用がわかります。

検索をリストとして保存する

Shell
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を控えておいてください。

キャンペーンを準備する

Shell
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を接続して、普段の言葉で頼んでください。

このページの内容