Command line

npx argorant login           # paste a key from app.argorant.com/profile once
npx argorant account         # plan, credits, request limit, campaign emails

npx runs it without installing. To install it for good, run npm install -g argorant. The tool reads the key from argorant login or from the ARGORANT_API_KEY variable.

Commands

Filters

Every search command (count, search, reveal, export, lists create, adding to a list, companies) takes the same filters as the app, the API and the Claude connector. A comma means any of them. Each list filter has a leave-out twin that removes everyone the include filter would find for the same values, and both can be used together.

How words match:

• --title-match words (default) needs every word as a whole word, so Data does not match Database. exact needs the whole job title, so CEO does not match Founder & CEO. contains finds the text anywhere, also inside a word.
• Keywords look at what the company does by default (its name, tags, industry and description). --keyword-scope people looks at people's own skills and profiles, and any at both plus job titles.
• --industry-match primary matches only the company's main industry, so Software leaves out a retailer or a bank that also carries a software tag. any (the default) matches any of its industries.
• --country-match person (the default) counts where the person is based and leaves out people whose own place is not known. person_or_company uses the company's country for them.

There are more filters too, such as --employees 51-200, --employees-min and --employees-max, --revenue 10m-50m, --revenue-min and --revenue-max, --company (several companies: join the names with |), --has-phone and --has-linkedin. npx argorant filters lists every filter you can use.

npx argorant count --title "VP Sales" --title-match exact --country DACH --exclude-country Switzerland
npx argorant export --keywords fintech --exclude-keywords "venture capital, private equity" -n 500 -o fintech.csv

A saved list fills in the background. lists show <id> says whether it is still filling; adding to a list that is still filling waits for its turn.

Built for scripts and agents

• --json on any command prints the API's answer as it is.
• Lists print a cursor under each page. Pass it with --cursor, or add --all to read every page.
• Every write gets a fresh Idempotency-Key. Pass --idempotency-key <key> to choose your own, so running the same command again returns the first answer instead of doing the work twice.
• Exit codes are 0 for success, 1 for an error (and for find without a result), 2 for a missing or wrong key, 3 for a missing scope, 4 for a rate or daily limit, 5 when a plan or more credits are needed, and 6 when a choice is needed first and nothing was changed (campaigns leads add asks which kinds of addresses to add).
• Commands that change many people or mailboxes (leads remove, leads restore, leads move, lists remove-people, inboxes tag, inboxes update) count first and then ask. --preview only counts, and --yes skips the question.
• Errors print the code, the plain message and the request id.
• Commands that spend credits ask first at a terminal. They do not ask when the output is not a terminal or with --yes or --json, so check your -n in scripts.
• A campaign can be named by its id or by the start of its name.

From a search to a running campaign

npx argorant lists create --name "UK finance leaders" --title "CFO, Finance Director" --country "United Kingdom"
npx argorant campaigns create --name "UK finance Q4" --daily-limit 40 --timezone Europe/London
npx argorant campaigns emails set "UK finance" --step 1 --subject "Quick question, {{first_name}}" --body-file step1.txt
npx argorant campaigns leads add "UK finance" --list 1240
# when the list also holds catch-all or unchecked addresses, it asks first and adds nothing (exit code 6):
npx argorant campaigns leads add "UK finance" --list 1240 --grades valid
# business emails only: add --exclude-private-emails (free mail and home internet addresses are left out)
npx argorant campaigns senders set "UK finance" --all
npx argorant campaigns launch "UK finance"