---
title: "Search people"
method: GET
path: "/api/v1/people/search"
tags: ["People"]
---

# Search people

`GET /api/v1/people/search`

## Request

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

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` |

## Query parameters

- `q` string
- `title` string
- `exclude_title` string
- `seniority` 'Owner' | 'Founder' | 'Partner' | 'C-Level' | 'VP' | 'Director' | 'Manager' | 'Senior' | 'Entry' | 'Intern'
- `departments` 'Sales' | 'Marketing' | 'Engineering' | 'Product' | 'Finance' | 'Human Resources' | 'Operations' | 'Legal' | 'Customer Success' | 'IT' | 'Design' | 'Data' | 'Research' | 'Executive'
- `industries` string
- `industry` string
- `keywords` string
- `technologies` string
- `employee_range` '1-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001-5000' | '5001-10000' | '10000+' | 'unknown'
- `company_name` string
- `company_domain` string
- `country` string
- `state` string
- `city` string
- `sells_to` string
- `company_category` 'software' | 'payments' | 'fintech' | 'formation' | 'association' | 'marketplace' | 'investors'
- `has_phone` boolean
- `has_linkedin` boolean
- `exclude_keywords` string
- `keyword_scope` 'company' | 'people' | 'any'
- `title_match` 'words' | 'exact' | 'contains'
- `exclude_title_match` 'words' | 'exact' | 'contains'
- `exclude_seniority` 'Owner' | 'Founder' | 'Partner' | 'C-Level' | 'VP' | 'Director' | 'Manager' | 'Senior' | 'Entry' | 'Intern'
- `exclude_departments` 'Sales' | 'Marketing' | 'Engineering' | 'Product' | 'Finance' | 'Human Resources' | 'Operations' | 'Legal' | 'Customer Success' | 'IT' | 'Design' | 'Data' | 'Research' | 'Executive'
- `exclude_industries` string
- `exclude_industry` string
- `exclude_company_domain` string
- `exclude_country` string
- `exclude_state` string
- `exclude_city` string
- `employees_min` string
- `employees_max` string
- `revenue_band` '0-1m' | '1m-10m' | '10m-50m' | '50m-100m' | '100m-250m' | '250m-500m' | '500m-1b' | '1b-10b' | '10b+'
- `revenue_min` string
- `revenue_max` string
- `limit` integer
- `cursor` string
- `offset` integer

## Headers

- `X-Request-Id` string

## Response `200`

OK

- object
  - `total` integer, nullable, required: How many rows exist in total for this query.
  - `limit` integer, required: Rows per page in this answer.
  - `offset` integer, required: Rows skipped before this page.
  - `next_cursor` string, nullable, required: Pass as cursor to get the next page. null on the last page.
  - `has_more` boolean, required: true when another page exists.
  - `total_is_estimate` boolean: Present and true when total is a lower bound, for example when a list reached its upper size.
  - `people` PersonPreview[], required
    - `record_id` string: Stable Argorant id. Reveal, add to a list or ask for phone numbers with it.
    - `preview` string: Initials only, for example J* D.
    - `title` string, nullable: Job title.
    - `seniority` string, nullable: Seniority, for example VP or Director.
    - `departments` string[]: Departments.
    - `company` string, nullable: Company name as recorded.
    - `company_normalized` string, nullable: The company name people say, for example Tidal.
    - `company_domain` string, nullable: Company website domain.
    - `city` string, nullable: City.
    - `state` string, nullable: State or region.
    - `country` string, nullable: Country.
    - `industry` string, nullable: Main industry.
    - `industries` string[]: All industry labels.

## Other responses

- `401`: 401 Unauthorized. `unauthorized` when the API key is missing, wrong or revoked.
- `403`: 403 Forbidden. `scope_missing` when the key lacks argorant:search_segments.
- `422`: 422 Validation error. `validation_error` when a field has the wrong type or is missing.
- `429`: 429 Too many requests. `daily_limit_reached` when the account's search rows for the day are used up; `rate_limited` when too many requests this minute.

---

[API](https://skmtc.dev/argorant/apis/argorant-api.md) · [All operations](https://skmtc.dev/argorant/apis/argorant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/argorant/apis/argorant-api/revisions/4bc28c0085b6?raw)