Your first call
The quickstart. With one API key you count a market, look at the people, reveal a few, save them as a list and prepare a campaign. Counting and looking are free.
You need an API key. Create one at app.argorant.com/profile under API keys. It starts with ag_live_ and is shown once. Every new account gets a 7-day trial with 100 credits and 300 campaign emails.
export ARGORANT_API_KEY=ag_live_...Check the key
curl "https://app.argorant.com/api/v1/account" -H "Authorization: Bearer $ARGORANT_API_KEY"You see your plan, your credits, how many requests a minute the key may send and what is left of today's limits.
Count a market, free
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}Not sure which words to use? GET /api/v1/lookups/industries?q=soft and GET /api/v1/lookups/titles?q=head of give the exact names with how many people carry each.
Look at who matches, free
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"Each row shows the role, the company and the place, with the name cut to initials and no contact details. Every row has a record_id.
Reveal a few people
This spends credits, so in an app or an agent, show the price and ask first.
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}'Every email is checked right before you get it. You pay 1 credit per person whose email passes and nothing for the rest. credits_charged says what it cost.
Save the search as a list
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"}}'Saving is free and reveals nobody. Keep the list_id.
Prepare a campaign
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}'The campaign starts as a draft. Nothing is sent until you launch it. Find and email 200 people shows the rest: the emails, the people, the mailboxes and the launch.
The same steps in the terminal: npx argorant count, npx argorant search, npx argorant reveal, npx argorant list create, npx argorant campaigns create. In Claude or ChatGPT, connect https://mcp.argorant.com/mcp and ask in plain words.
Guides
Step-by-step guides for the jobs people do most with Argorant: the first call, finding and emailing people, replies, credits, mailboxes and webhooks.
Find and email 200 people
From who you sell to, to a running campaign: narrow to about 200 people, write the emails with a personal line, pick the mailboxes and launch after a yes.