첫 호출
빠른 시작 가이드입니다. 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"플랜, 크레딧, 이 키가 분당 보낼 수 있는 요청 수, 오늘 한도의 남은 양이 표시됩니다.
시장 규모 집계하기(무료)
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크레딧을 내고, 나머지는 무료입니다. 비용은 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를 연결하고 평소 말로 요청하세요.