People

Count people

How many people match your filters. Free. Start every search here to size the market before you preview or spend.

CostWhat it doesKey scopes
FreeReads onlyargorant:read_counts
get/api/v1/people/count

Request

  • Base URL: https://app.argorant.com
  • URL: https://app.argorant.com/api/v1/people/count
  • 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).

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

countinteger

Changes

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