Find, save, export
The data half of the workflow. Filters, saved lists, exports and what happens to credits.
Filters
Every search endpoint and the campaign enrollment share one filter vocabulary. Use the lookups to discover valid labels (industries, countries, keywords, field values) before filtering.
| Filter | Example | Note |
|---|---|---|
q | "fintech CFOs germany" | Free text across name, title, company, location |
title | CFO, Finance Director | Comma = OR; exclude_title removes roles |
seniority | c_suite, vp, director | |
departments | finance, engineering | |
industry | fintech | Plain English, resolved through the industries lookup |
keywords | logistics, freight | Company tags; the widest reliable filter |
country / state / city | Germany | Names are canonical, DE works too |
company_domain / company_name | stripe.com | |
has_email / has_phone / has_linkedin | true |
Saved lists
A list is a named segment you can export or enroll into a campaign without re-typing filters.
curl -X POST "https://app.argorant.com/api/mcp/lists" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{"name":"UK finance leaders","filters":{"title":"CFO, Finance Director","country":"United Kingdom"}}'
# → { "list_id": 1240, "snapshot_total": 6140 }The list_id goes straight into POST /api/v1/campaigns/{id}/leads as list_id.
Exports
Exports are asynchronous. Create the job, poll GET /api/mcp/exports/{job_id} until status is done, then download. Above 50,000 rows use export batches. Each job re-verifies every address at build time; you pay one credit per deliverable contact, nothing for the rest. Set skip_previously_exported: true to never pay twice for the same person.
Enrich
When you already have an address or a name plus a domain, POST /api/mcp/enrich fills in the record (1 credit per match; a miss or an address that fails verification is free). A company domain alone returns the company profile for free.