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.
| Cost | What it does | Key scopes |
|---|---|---|
| Free | Reads only | argorant:search_segments |
Authorization
BearerAuth 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
Plain text across name, title, company and description. A request like "software companies selling to restaurants" is understood as the vendors, not the restaurants.
Job title. Knows abbreviations (CFO matches Chief Financial Officer). Comma means or.
Leave out people with these titles. Comma means or.
Comma-separated seniority levels.
Value in
- "Owner"
- "Founder"
- "Partner"
- "C-Level"
- "VP"
- "Director"
- "Manager"
- "Senior"
- "Entry"
- "Intern"
Comma-separated departments.
Value in
- "Sales"
- "Marketing"
- "Engineering"
- "Product"
- "Finance"
- "Human Resources"
- "Operations"
- "Legal"
- "Customer Success"
- "IT"
- "Design"
- "Data"
- "Research"
- "Executive"
Pipe-separated industries from GET /api/v1/lookups/industries.
One industry in plain words; industries is more exact.
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.
Pipe-separated technologies the company uses, from GET /api/v1/lookups/technologies.
Comma-separated company sizes.
Value in
- "1-10"
- "11-50"
- "51-200"
- "201-500"
- "501-1000"
- "1001-5000"
- "5001-10000"
- "10000+"
- "unknown"
Company name, matched as written (Deutsche Bank finds Deutsche Bank AG). Several companies: join the names with |, for example Stripe|Notion.
Company website domains. Comma means or.
Comma-separated countries or regions (Europe, DACH, Nordics, APAC, LATAM). Names from GET /api/v1/lookups/countries.
States or provinces, by name or code. Comma means or.
Cities. Comma means or.
Who the company sells to, for example restaurants or dentists.
What the company itself is, used with sells_to.
Value in
- "software"
- "payments"
- "fintech"
- "formation"
- "association"
- "marketplace"
- "investors"
Only people with a phone number on record.
Only people with a profile URL.
Leave out people that keywords would find for these words. Same matching and the same keyword_scope as keywords. Comma means or.
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.
"company"Value in
- "company"
- "people"
- "any"
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.
"words"Value in
- "words"
- "exact"
- "contains"
Like title_match, for exclude_title only. When it is not set, title_match is used.
Value in
- "words"
- "exact"
- "contains"
Leave out these seniority levels. Comma means or.
Value in
- "Owner"
- "Founder"
- "Partner"
- "C-Level"
- "VP"
- "Director"
- "Manager"
- "Senior"
- "Entry"
- "Intern"
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"
Leave out these industries (pipe-separated, like industries).
Leave out industries in plain words, like industry. Comma means or.
Leave out people at these company website domains. Comma means or.
Leave out these countries or regions (Europe, DACH, Nordics, APAC, LATAM). Comma means or.
Leave out these states or provinces, by name or code. Comma means or.
Leave out these cities. Comma means or.
Smallest number of employees, such as 50 and 500. A company counts when its size range overlaps yours. Accepts 100 or 1k.
Largest number of employees (same overlap rule).
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+"
Smallest yearly revenue in US dollars; a company counts when its revenue range overlaps yours. Accepts 250k, 1.5M or 2B.
Largest yearly revenue in US dollars (same overlap rule).
Rows per page, 1 to 100 (default 10).
1 <= value <= 10010The next_cursor of the previous page. Leave out for the first page.
Rows to skip, as an alternative to cursor.
0 <= value0Header Parameters
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.
^[A-Za-z0-9._-]{8,64}$Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://app.argorant.com/api/v1/people/search?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&limit=10"{ "people": [ { "record_id": "p_8d4ba3d46cc885007c38e437", "preview": "A* S", "title": "VP of Sales", "seniority": "VP", "departments": [ "Sales" ], "company": "Evenito AG", "company_normalized": "Evenito", "company_domain": "evenito.com", "city": "Zurich", "state": null, "country": "Switzerland", "industry": "Software Development", "industries": [ "Software", "Software Development" ] } ], "total": 1843, "limit": 10, "offset": 0, "next_cursor": "bzoxMA", "has_more": true, "note": "Names and contact details are masked. Reveal or export to get emails; counts and searches are free."}