Our dataPricingContact
Log in

API reference

Milda API

Base URL
https://api.milda.ai
Overview

Credit Usage1

  • GETCredit Usage

Company Search3

  • POSTFind Company
  • POSTText Search
  • POSTText Search Insights

Companies7

  • POSTSubmit Companies for Enrichment
  • POSTCompany Statuses
  • POSTCompany Profiles
  • POSTCompany Events
  • POSTPlaces of Performance
  • POSTGrowth Signals
  • POSTProducts & Clients

People2

  • POSTPeople Search
  • POSTVerified Email

Trade Data5

  • POSTTrade Candidates
  • POSTTrade Analytics
  • POSTShipping Records
  • POSTShipment Suppliers
  • POSTShipment Recipients

Patents7

  • POSTPatent Summary
  • POSTPatent Co-applicants
  • POSTPatent Inventors
  • POSTTechnology Users
  • POSTTechnology Providers
  • POSTPatent Citations
  • POSTPatent List

Publications5

  • POSTPublication Analytics
  • POSTPublication Authors
  • POSTPublication Funders
  • POSTCollaborating Organizations
  • POSTTop Cited Works

Risk Assessment4

  • POSTRisk Candidates
  • POSTCompany Financials
  • POSTCompany Ownership
  • POSTRisk Report

People

1 of 2
POSThttps://api.milda.ai/v1/people/search

People Search

application/json
01

Description

This endpoint returns the employees of up to 50 companies per request (25 IDs plus 25 URLs), or refreshes person records you already have.

Input Parameters

Both company_filters and person_filters must be sent, even if one is empty ({}). Each request needs something to search within: at least one company (company_filters.company_ids or company_filters.urls) or person (person_filters.person_ids). A request without either is rejected with 422.

Company Filters (company_filters)

Choose the companies: - Company IDs (company_ids, up to 25) from Milda's search and company endpoints - Company websites (urls, up to 25), e.g. https://milda.ai/api or milda.ai. Combined with company_ids.

Narrow them down by company country (countries, exclude_countries), locations the company is active in (locations, locations_not), industry (NACE 2-digit, NACE 4-digit, US SIC, each with an exclude_ variant), age, size and turnover.

Person Filters (person_filters)

Narrow down the people by: - Seniority (e.g. Director, C-Suite) and department - Job title: a term it must contain (term_must_match_job_title) or must not contain (term_must_not_match_job_title) - Experience: a term in the current (term_must_match_current_job_experience) or a previous (term_must_match_past_job_experience) role - Country where the person lives (countries), which may differ from the company's - LinkedIn: has_linkedin: true for people with a profile, false for people without one

To refresh people you already have, send up to 1000 person_ids. Use exclude_person_ids to leave out people you already have.

Response

Returns every person matching the criteria. Each record has the person's ID, name, job title, seniority, department, location, LinkedIn and email availability, their professional background, and their company's ID, name, website, country, industry, age, size and turnover.

Example: Submit 25 company URLs, filter by seniority (Directors, C-Suite, Heads, Presidents) and a job title containing revenue, and you get every matching person across those companies.

Credit Usage
  • 1 credit per 25 people returned (0.04 credits per person)
Rate Limit

10 requests per second

02

Headers

nameinreqdescription
tokenheaderone ofYour API token, sent as "token: YOUR_API_TOKEN". Send this or Authorization.
Authorizationheaderone ofThe same token in the standard form, sent as "Authorization: Bearer YOUR_API_TOKEN" (the word Bearer, a space, then your token). Send this or token.
03

Request body

PeopleSearchRequest
PeopleSearchRequesttypereq2 fields
+company_filtersPersonCompanyFiltersyes
Companies
company_idsstring[]—Specific company IDs to include (max 25)
urlsstring[]—Company domains or URLs to include (max 25). Combined with company_ids.
Location
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
Industry
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
Size and age
ageAge[] | null—Company age categories to include
sizeSize[] | null—Company size categories to include
turnoverTurnover[] | null—Company revenue categories to include
+person_filtersPersonFiltersyes
People
person_idsstring[]—Specific person IDs to include (max 1000)
exclude_person_idsstring[]—Person IDs to exclude from results (max 100k)
Role
senioritySeniorityLevel[] | null—Job seniority levels to include
departmentDepartment[] | null—Work departments to include
term_must_match_job_titlestring | null—Required term in job title
term_must_not_match_job_titlestring | null—Excluded term in job title
Experience
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
Location and presence
countriesCountryCode[] | null—Include people from these countries
has_linkedinboolean | null—true: only people with a LinkedIn profile; false: only people without one.
04

Responses

200 Successful Response422 Validation Error

Returns a JSON array. Each item:

Persontype27 fields
Person
person_idstringUnique identifier for the person.
full_namestring | nullPerson's complete full name.
first_namestring | nullPerson's first name.
last_namestring | nullPerson's last name.
positionstring | nullCurrent job title or position.
senioritySeniorityLevel | nullJob seniority level category.
departmentDepartment | nullWork department or functional area.
person_locationstring | nullPerson's current location or city.
person_countryCountryCode | nullPerson's country of residence.
Contact
email_statusstring | nullStatus of email availability or verification.
linkedinstring | nullLinkedIn profile URL.
social_mediaobject | nullDictionary of social media platform URLs.
Background
about_mestring | nullProfessional summary or bio description.
present_experienceobject[] | nullList of current job experiences and roles.
past_experienceobject[] | nullList of previous job experiences and roles.
Company
company_idstring | nullUnique identifier of the associated company.
namestring | nullName of the associated company.
urlstring | nullWebsite URL of the associated company.
countryCountryCode | nullCountry where the company is based.
industry_nace2digitstring[] | nullList of 2-digit NACE industry classification codes for the company.
industry_nace4digitstring[] | nullList of 4-digit NACE industry classification codes for the company.
industry_nace4namestring[] | nullList of 4-digit NACE industry names for the company.
ageAge | nullCompany age category.
sizeSize | nullCompany size category based on employee count.
turnoverTurnover | nullCompany revenue/turnover category.
Scores
relevance_scoreinteger | nullRelevance score based on search query matching.
rank_scorenumber | nullRanking score for result ordering.
PreviousProducts & ClientsNextVerified Email

© 2026 Milda.ai All rights reserved.

  • Privacy policy
  • Terms and Conditions
  • Blog