Search: POST /v1/people/search

POSThttps://api.milda.ai/v1/people/search

Search

application/json

Description

This endpoint lets you retrieve employee lists (up to 25 companies at a time) or update existing person records.

Input Parameters

Company Filters (`company_filters`)

Provide one of the following to define companies: - Company IDs (company_ids) from Milda’s Company Search/Data endpoints
- Company websites, e.g. https://milda.ai/api or milda.ai
- Emails, e.g. john@milda.ai (the domain is used to identify the company)

Person Filters (`person_filters`)

You can narrow down results using: - Seniority (e.g. Director, C-Suite)
- Job title keyword
- Department
- Country / City / Region (person’s location, may differ from company’s)
- Person ID

Additional options: - Update existing data: submit up to 1000 person_ids to refresh latest info
- Exclude persons: use exclude_person_ids
- Limit results: set maximum number of persons to return

Response

Returns all people matching the criteria
Each person record includes 11 fields, such as:
Person ID
Name
LinkedIn URL
Country & city
Seniority
Department
Other metadata

Example:
If you submit 25 company URLs and filter by seniority = Directors, C-Suite, Heads, Presidents, plus job title containing "revenue", you’ll get all matching people across those companies.

Credit Usage

0.05 credits per person returned

Rate Limit

1 request per second

Headers

nameinreqdescription

tokenheaderyesAPI token. Issued per account; check it with GET /v1/credit-usage.

Request body

PeopleSearchRequest

PeopleSearchRequesttypereq2 fields

+person_filtersPersonFiltersyes

person_idsstring[]—Specific person IDs to include (max 1000)

senioritySeniorityLevel[] | null—Job seniority levels to include

departmentDepartment[] | null—Work departments to include

countriesCountryCode[] | null—Include people from these countries

term_must_match_job_titlestring | null—Required term in job title

term_must_not_match_job_titlestring | null—Excluded term in job title

term_must_match_current_job_experiencestring | null—Required term in current job description

term_must_match_past_job_experiencestring | null—Required term in previous job description

has_linkedinboolean—Only include people with LinkedIn profiles

exclude_person_idsstring[]—Person IDs to exclude from results (max 100k)

+company_filtersPersonCompanyFiltersyes

company_idsstring[]—Specific company IDs to include (max 25)

urlsstring[]—Company domains or URLs to include (max 25, ignored if company_ids provided)

countriesCountryCode[] | null—Include companies from these countries

exclude_countriesCountryCode[] | null—Exclude companies from these countries

locationsCountryCode[] | null—Include companies active in these locations

locations_notCountryCode[] | null—Exclude companies active in these locations

industries_nace2digitstring[] | null—Include companies in these NACE2 industry codes

exclude_industries_nace2digitstring[] | null—Exclude companies in these NACE2 industry codes

industries_nace4digitstring[] | null—Include companies in these NACE4 industry codes

exclude_industries_nace4digitstring[] | null—Exclude companies in these NACE4 industry codes

industries_sicstring[] | null—Include companies in these SIC industry codes

exclude_industries_sicstring[] | null—Exclude companies in these SIC industry codes

ageAge[] | null—Company age categories to include

sizeSize[] | null—Company size categories to include

turnoverTurnover[] | null—Company revenue categories to include

momentum_scoreinteger[] | null—Top X% of companies by momentum score

Responses

200 Successful Response422 Validation Error