People

Reveal people

Full details for people, with name, title, company, work email, profile URL and place. Send record_ids from a search (up to 25), or the same filters as search to take the next people who match. Every email is checked right before you get it; only people whose email passes are returned and charged. A person you revealed before is free to reveal again. Ask the user before you spend: show the count and the price first.

A key can reveal 100 people a day. For bigger numbers use a saved list and an export, or add the list to a campaign.

Cost	What it does	Key scopes
1 credit per contact whose email passes the check; contacts that fail are left out and cost nothing	Spends credits	argorant:unlock_contacts

post/api/v1/people/reveal

Request

Base URL: https://app.argorant.com
URL: https://app.argorant.com/api/v1/people/reveal
Auth: HTTP bearer

Headers

Idempotency-Keystring

Any unique text up to 128 characters. A retry with the same key and the same body within 24 hours returns the first answer (with the header Idempotent-Replayed: true) instead of doing the work twice. The same key with another body answers 409 idempotency_conflict.

X-Request-Idstring

Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.

Request body

record_idsstring[]

Up to 25 record ids from a search. Leave out to reveal by filters.

qstring

Plain text across name, title, company and description. A request like "software companies selling to restaurants" is understood as the vendors, not the restaurants.

titlestring

Job title. Knows abbreviations (CFO matches Chief Financial Officer). Comma means or.

exclude_titlestring

Leave out people with these titles. Comma means or.

Comma-separated seniority levels.

Comma-separated departments.

industriesstring

Pipe-separated industries from GET /api/v1/lookups/industries.

industrystring

One industry in plain words; industries is more exact.

keywordsstring

Comma-separated words that describe what the company does, such as fintech or freight forwarding. They match the company's name, tags, industry and description. They do not match a person's own skills unless keyword_scope is people or any. The widest filter for niches without their own industry.

technologiesstring

Pipe-separated technologies the company uses, from GET /api/v1/lookups/technologies.

employee_range'1-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001-5000' | '5001-10000' | '10000+' | 'unknown'

Comma-separated company sizes.

company_namestring

Company name, matched as written (Deutsche Bank finds Deutsche Bank AG). Several companies: join the names with |, for example Stripe|Notion.

company_domainstring

Company website domains. Comma means or.

countrystring

Comma-separated countries or regions (Europe, DACH, Nordics, APAC, LATAM). Names from GET /api/v1/lookups/countries.

statestring

States or provinces, by name or code. Comma means or.

citystring

Cities. Comma means or.

sells_tostring

Who the company sells to, for example restaurants or dentists.

What the company itself is, used with sells_to.

has_phoneboolean

Only people with a phone number on record.

has_linkedinboolean

Only people with a profile URL.

exclude_keywordsstring

Leave out people that keywords would find for these words. Same matching and the same keyword_scope as keywords. Comma means or.

keyword_scope'company' | 'people' | 'any'

company (default): only what the company does, that is its name, tags, industry and description. people: only the person's own skills and profile; use it when the user wants people who have a skill themselves, such as people who know Python. any: both, plus job titles.

title_match'words' | 'exact' | 'contains'

words (default): every word must appear as a whole word, so Data does not match Database. exact: the whole job title must be one of the values, ignoring case, so CEO does not match Founder & CEO. contains: the text may appear anywhere, also inside a word; slower, for special cases.

exclude_title_match'words' | 'exact' | 'contains'

Like title_match, for exclude_title only. When it is not set, title_match is used.

Leave out these seniority levels. Comma means or.

Leave out these departments. Comma means or.

exclude_industriesstring

Leave out these industries (pipe-separated, like industries).

exclude_industrystring

Leave out industries in plain words, like industry. Comma means or.

exclude_company_domainstring

Leave out people at these company website domains. Comma means or.

exclude_countrystring

Leave out these countries or regions (Europe, DACH, Nordics, APAC, LATAM). Comma means or.

exclude_statestring

Leave out these states or provinces, by name or code. Comma means or.

exclude_citystring

Leave out these cities. Comma means or.

employees_minstring

Smallest number of employees, such as 50 and 500. A company counts when its size range overlaps yours. Accepts 100 or 1k.

employees_maxstring

Largest number of employees (same overlap rule).

revenue_band'0-1m' | '1m-10m' | '10m-50m' | '50m-100m' | '100m-250m' | '250m-500m' | '500m-1b' | '1b-10b' | '10b+'

Yearly company revenue in US dollars, as bands. A comma means any of them.

revenue_minstring

Smallest yearly revenue in US dollars; a company counts when its revenue range overlaps yours. Accepts 250k, 1.5M or 2B.

revenue_maxstring

Largest yearly revenue in US dollars (same overlap rule).

limitinteger

How many people when revealing by filters, 1 to 25 per call (default 10).

grade'valid' | 'valid_plus_catchall'

valid: only confirmed addresses. valid_plus_catchall: also addresses at domains that accept every email. Default: both.

Example request

{
  "q": "head of growth",
  "title": "CFO,VP Finance",
  "exclude_title": "assistant,intern",
  "seniority": "C-Level,VP",
  "departments": "Finance",
  "industries": "Software Development|Financial Services",
  "industry": "fintech",
  "keywords": "solar,renewable",
  "technologies": "Shopify|Klaviyo",
  "employee_range": "11-50,51-200",
  "company_name": "Stripe",
  "company_domain": "stripe.com",
  "country": "Germany,Austria",
  "state": "Bavaria",
  "city": "Munich",
  "sells_to": "restaurants",
  "exclude_keywords": "staffing,recruiting",
  "exclude_seniority": "Intern,Entry",
  "exclude_departments": "Human Resources",
  "exclude_industries": "Staffing and Recruiting",
  "exclude_industry": "staffing",
  "exclude_company_domain": "competitor.com",
  "exclude_country": "Switzerland",
  "exclude_state": "CA,NY",
  "exclude_city": "Berlin",
  "employees_min": "50",
  "employees_max": "500",
  "revenue_band": "10m-50m",
  "revenue_min": "1M",
  "revenue_max": "50M",
  "limit": 10
}

Response

record_idstring

Stable Argorant id of this person.

first_namestring nullable

First name.

last_namestring nullable

Last name.

full_namestring nullable

Full name.

titlestring nullable

Job title.

senioritystring nullable

Seniority.

departmentsstring[]

Departments.

companystring nullable

Company name as recorded.

company_normalizedstring nullable

The company name people say.

company_domainstring nullable

Company website domain.

emailstring email nullable

Work email. Present only when it passed the check.

email_status'valid' | 'catch_all' | 'risky' | 'null' nullable

Result of the check at reveal time: valid, or catch_all for a domain that accepts every address.

phonestring nullable

Phone number, only when this account already unlocked it. Ask for numbers with POST /api/v1/people/phones.

linkedin_urlstring uri nullable

Profile URL.

citystring nullable

City.

statestring nullable

State or region.

countrystring nullable

Country.

industrystring nullable

Main industry.

industriesstring[]

All industry labels.

Changes

No recorded changes to this operation across all 1 revision of this API.