Your first call
From a fresh account to a verified CSV in four steps. Counts and previews are free, so nothing is billed until you decide.
Get a key
Create an account, verify your email, then mint a key at app.argorant.com/profile → API keys. It starts with ag_live_ and is shown once.
export ARGORANT_API_KEY=ag_live_…
npx argorant whoami # or: curl https://app.argorant.com/api/mcp/account -H "Authorization: Bearer $ARGORANT_API_KEY"Count a market, free
curl -G "https://app.argorant.com/api/mcp/people/count" \
-H "Authorization: Bearer $ARGORANT_API_KEY" \
--data-urlencode "industry=fintech" --data-urlencode "title=CFO" --data-urlencode "country=Germany"
# → { "ok": true, "count": 12480 }Free text in q matches name, title, company and location; the structured filters narrow precisely: title, seniority, departments, industry, keywords, country, state, city, company_name, company_domain, has_email, has_phone, has_linkedin.
Preview it, masked
curl -G "https://app.argorant.com/api/mcp/people/preview" \
-H "Authorization: Bearer $ARGORANT_API_KEY" \
--data-urlencode "industry=fintech" --data-urlencode "title=CFO" --data-urlencode "country=Germany" --data-urlencode "limit=10"Rows carry initials, role, company and location. No emails, phones or profile URLs, and no credits.
Export the verified ones
curl -X POST "https://app.argorant.com/api/mcp/exports" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{"filters":{"industry":"fintech","title":"CFO","country":"Germany"},"limit":25}'
# → { "job_id": 84213, "status": "queued" }
curl "https://app.argorant.com/api/mcp/exports/84213" -H "Authorization: Bearer $ARGORANT_API_KEY"
curl -L "https://app.argorant.com/api/mcp/exports/84213/download" -H "Authorization: Bearer $ARGORANT_API_KEY" -o cfos.csvEvery address is verified while the job builds. Undeliverable rows are dropped and not billed.
Same four steps in the terminal: argorant count, argorant search, argorant export -n 25 -o cfos.csv. Next: turn that list into a campaign in Campaigns end to end.