People

Search people

A preview of the people who match: role, seniority, company, place and industry, with names cut to initials and no contact details. Free. Use it to check that the filters find the right people, then reveal, save a list or export.

A page holds up to 10 people for customer keys, and on a plan there is no daily limit on preview rows; during the trial an account can preview 1,000 rows a day through an AI assistant and 500 through an API key (all its keys together). To work with more people, save a list or start an export. Each row carries the record_id you can reveal, add to a list or ask phone numbers for.

CostWhat it doesKey scopes
FreeReads onlyargorant:search_segments
get/api/v1/people/search

Request

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

Query parameters

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.

seniority'Owner' | 'Founder' | 'Partner' | 'C-Level' | 'VP' | 'Director' | 'Manager' | 'Senior' | 'Entry' | 'Intern'

Comma-separated seniority levels.

departments'Sales' | 'Marketing' | 'Engineering' | 'Product' | 'Finance' | 'Human Resources' | 'Operations' | 'Legal' | 'Customer Success' | 'IT' | 'Design' | 'Data' | 'Research' | 'Executive'

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.

company_category'software' | 'payments' | 'fintech' | 'formation' | 'association' | 'marketplace' | 'investors'

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.

exclude_seniority'Owner' | 'Founder' | 'Partner' | 'C-Level' | 'VP' | 'Director' | 'Manager' | 'Senior' | 'Entry' | 'Intern'

Leave out these seniority levels. Comma means or.

exclude_departments'Sales' | 'Marketing' | 'Engineering' | 'Product' | 'Finance' | 'Human Resources' | 'Operations' | 'Legal' | 'Customer Success' | 'IT' | 'Design' | 'Data' | 'Research' | 'Executive'

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

Rows per page, 1 to 100 (default 10).

cursorstring

The next_cursor of the previous page. Leave out for the first page.

offsetinteger

Rows to skip, as an alternative to cursor.

Headers

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.

Response

OK

totalinteger nullable required

How many rows exist in total for this query.

limitinteger required

Rows per page in this answer.

offsetinteger required

Rows skipped before this page.

next_cursorstring nullable required

Pass as cursor to get the next page. null on the last page.

has_moreboolean required

true when another page exists.

total_is_estimateboolean

Present and true when total is a lower bound, for example when a list reached its upper size.

Changes

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