Find, save and export

The filters every search shares, saved lists, CSV exports, phone numbers and enrichment, and what each one costs.

Filters

Count, search, reveal, lists, exports and campaigns all use the same filters. The word lists give the exact industry, country, keyword, technology and title names, with how many people carry each.

Filter	Example	How it works
`q`	`software companies selling to restaurants`	Plain words across name, title, company and description
`title`	`CFO, Finance Director`	A comma means or. Knows abbreviations. `exclude_title` leaves titles out
`seniority`	`C-Level,VP`	Owner, Founder, Partner, C-Level, VP, Director (also matches Head of), Manager, Senior, Entry, Intern
`departments`	`Finance`
`industries`	`Software Development`	Exact names from the industries list; a pipe means or
`keywords`	`logistics, freight`	Words that describe what the company does: its name, tags, industry and description. The widest filter for niches. `keyword_scope=people` looks at people's own skills instead, `keyword_scope=any` at both
`technologies`	`Shopify`	What the company uses
`employee_range`	`11-50,51-200`	Company size
`country`, `state`, `city`	`Germany` or `DACH`	Names or regions such as Europe, DACH, Nordics
`company_domain`, `company_name`	`stripe.com`	One company
`has_phone`, `has_linkedin`	`true`	Only people with a phone number or a profile
`business_email_only`	`true`	Only people whose email is at their company's own domain. Off unless you set it, so private addresses are left out only on request
`exclude_assistants`	`false`	On by default. A title search leaves out assistant titles such as executive assistant or assistant to. Set it to `false` to keep them

Every count, search, list and export answer says what was applied beyond your own filters. applied_filters shows business_email_only when you switched it on, and applied_defaults shows whether assistant titles were left out and which ones. A saved list stores both, next to the request as you sent it (filters.request).

Regions can overlap. Egypt is in both Middle East and Africa, Mexico is in both North America and LATAM, and Turkey counts as Middle East, not Europe. A person is counted once, even when several of the regions you name include their country. EMEA is Europe, the Middle East and Africa together.

Saved lists

A list keeps a search so you can export it or add it to a campaign later.

Shell

curl -X POST "https://app.argorant.com/api/v1/lists" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: uk-finance-list" -H "Content-Type: application/json" \
  -d '{"name":"UK finance leaders","filters":{"title":"CFO, Finance Director","country":"United Kingdom"}}'

A saved search answers at once. snapshot_total is the number of people when the count finishes in time; otherwise it is null, with count_status pending and a status_url. GET /api/v1/lists/{id}/fill shows the status, the counts, progress_percent and eta_seconds. Add verbose=true to see the saved search too.

Send record_ids instead of filters to keep exactly the people you picked. GET /api/v1/lists shows all your lists, GET /api/v1/lists/{id}/people pages through the people in one, POST /api/v1/lists/{id}/items adds more, PATCH renames and DELETE removes a list. The list_id goes straight into POST /api/v1/campaigns/{id}/leads.

Exports

An export builds a CSV in the background.

Shell

curl -X POST "https://app.argorant.com/api/v1/exports" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: uk-finance-export" -H "Content-Type: application/json" \
  -d '{"filters":{"title":"CFO, Finance Director","country":"United Kingdom"},"limit":500}'

Check status_url until status is done, then download from download_url. Every email is checked while the file is built, and you pay 1 credit per person whose email passes. People you exported before are left out unless you set "exclude_previously_exported": false, so you never pay twice for the same person. Above 50,000 rows the export becomes a batch of files; check it at GET /api/v1/export-batches/{batch_id}. POST /api/v1/lists/{id}/export exports a saved list the same way.

Phone numbers

Add "include_phones": true to an export, or ask for numbers for up to 100 people with POST /api/v1/people/phones and their record_ids. A phone number costs 10 credits, only when one is returned, and numbers you already have are free. Phone numbers come with the Pro plan. GET /api/v1/people/phones/pricing shows the price and whether your plan includes them.

Enrich one record

When you already have an email, or a name and a company domain, POST /api/v1/enrich fills in the person: 1 credit for a match whose email passes, nothing for a miss, and the same person again is free. A company domain alone returns the company profile for free.