ArgorantDocs

Count people

gethttps://app.argorant.com/api/v1/people/count
GET
/api/v1/people/count

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

Authorization

BearerAuth
AuthorizationBearer <token>

Your API key from app.argorant.com/profile, sent as Authorization: Bearer <key>. A connector sign-in token (ag_mcp_...) works the same way.

In: header

Query Parameters

q?string

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

title?string

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

exclude_title?string

Leave out people with these titles. Comma means or.

seniority?string

Comma-separated seniority levels.

Value in

  • "Owner"
  • "Founder"
  • "Partner"
  • "C-Level"
  • "VP"
  • "Director"
  • "Manager"
  • "Senior"
  • "Entry"
  • "Intern"
departments?string

Comma-separated departments.

Value in

  • "Sales"
  • "Marketing"
  • "Engineering"
  • "Product"
  • "Finance"
  • "Human Resources"
  • "Operations"
  • "Legal"
  • "Customer Success"
  • "IT"
  • "Design"
  • "Data"
  • "Research"
  • "Executive"
industries?string

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

industry?string

One industry in plain words; industries is more exact.

keywords?string

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.

technologies?string

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

employee_range?string

Comma-separated company sizes.

Value in

  • "1-10"
  • "11-50"
  • "51-200"
  • "201-500"
  • "501-1000"
  • "1001-5000"
  • "5001-10000"
  • "10000+"
  • "unknown"
company_name?string

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

company_domain?string

Company website domains. Comma means or.

country?string

Comma-separated countries or regions (Europe, DACH, Nordics, APAC, LATAM). Names from GET /api/v1/lookups/countries. 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.

state?string

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

city?string

Cities. Comma means or.

sells_to?string

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

company_category?string

What the company itself is, used with sells_to.

Value in

  • "software"
  • "payments"
  • "fintech"
  • "formation"
  • "association"
  • "marketplace"
  • "investors"
has_phone?boolean

Only people with a phone number on record.

has_linkedin?boolean

Only people with a profile URL.

exclude_keywords?string

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

keyword_scope?string

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.

Default"company"

Value in

  • "company"
  • "people"
  • "any"
title_match?string

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.

Default"words"

Value in

  • "words"
  • "exact"
  • "contains"
exclude_title_match?string

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

Value in

  • "words"
  • "exact"
  • "contains"
exclude_seniority?string

Leave out these seniority levels. Comma means or.

Value in

  • "Owner"
  • "Founder"
  • "Partner"
  • "C-Level"
  • "VP"
  • "Director"
  • "Manager"
  • "Senior"
  • "Entry"
  • "Intern"
exclude_departments?string

Leave out these departments. Comma means or.

Value in

  • "Sales"
  • "Marketing"
  • "Engineering"
  • "Product"
  • "Finance"
  • "Human Resources"
  • "Operations"
  • "Legal"
  • "Customer Success"
  • "IT"
  • "Design"
  • "Data"
  • "Research"
  • "Executive"
exclude_industries?string

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

exclude_industry?string

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

exclude_company_domain?string

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

exclude_country?string

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

exclude_state?string

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

exclude_city?string

Leave out these cities. Comma means or.

employees_min?string

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

employees_max?string

Largest number of employees (same overlap rule).

revenue_band?string

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

Value in

  • "0-1m"
  • "1m-10m"
  • "10m-50m"
  • "50m-100m"
  • "100m-250m"
  • "250m-500m"
  • "500m-1b"
  • "1b-10b"
  • "10b+"
revenue_min?string

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

revenue_max?string

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

founded_min?integer

Companies founded in this year or later, such as 2015. Companies whose founding year is not known are left out.

Range1600 <= value
founded_max?integer

Companies founded in this year or earlier, such as 2020.

Range1600 <= value
near_place?string

People within a distance of a place. Give the place (near_place) as a city or postal code, such as Denver, Colorado, or as a latitude and longitude, plus a distance (radius) and a unit. By default a person counts where they are based, or where their company is when their own place is not known; radius_target person or company uses only that place.

near_lat?number

Latitude of the center, with near_lon and radius, instead of near_place.

near_lon?number

Longitude of the center.

radius?number

Distance around the place, 0.5 to 500.

Range0.5 <= value <= 500
radius_unit?string

mi (default) or km.

Default"mi"

Value in

  • "mi"
  • "km"
radius_target?string

any (default): where the person is based, or their company when that is not known. person: only where the person is based. company: only where their company is based.

Default"any"

Value in

  • "any"
  • "person"
  • "company"
gender?string

female or male, based on first name and country. Names used for both women and men are left out, so a gender filter finds fewer people than the same search without it. Not available for lending audiences.

Value in

  • "female"
  • "male"
business_email_only?boolean

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. When it is on, the answer says so under applied_filters.

Defaultfalse
exclude_assistants?boolean

On by default. A job title search leaves out assistant titles such as assistant to, executive assistant or personal assistant. Set it to false to keep them. The answer lists what it left out under applied_defaults, and a saved list keeps the setting.

Defaulttrue

Header Parameters

X-Request-Id?string

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.

Match^[A-Za-z0-9._-]{8,64}$

Response Body

application/json

application/json

application/json

application/json

application/json

Shell
curl -X GET "https://app.argorant.com/api/v1/people/count?q=head+of+growth&title=CFO%2CVP+Finance&exclude_title=assistant%2Cintern&seniority=C-Level%2CVP&departments=Finance&industries=Software+Development%7CFinancial+Services&industry=fintech&keywords=solar%2Crenewable&technologies=Shopify%7CKlaviyo&employee_range=11-50%2C51-200&company_name=Stripe&company_domain=stripe.com&country=Germany%2CAustria&state=Bavaria&city=Munich&sells_to=restaurants&exclude_keywords=staffing%2Crecruiting&exclude_seniority=Intern%2CEntry&exclude_departments=Human+Resources&exclude_industries=Staffing+and+Recruiting&exclude_industry=staffing&exclude_company_domain=competitor.com&exclude_country=Switzerland&exclude_state=CA%2CNY&exclude_city=Berlin&employees_min=50&employees_max=500&revenue_band=10m-50m&revenue_min=1M&revenue_max=50M&founded_min=2015&founded_max=2020&near_place=Denver%2C+Colorado&near_lat=39.7392&near_lon=-104.9847&radius=25"
JSON
{  "count": 18432}