people-searchlisted

# LeadMagic — People Search (v3) Canonical discovery endpoint: **`POST /v3/people/search`**. Same body shape on the variants: `/v3/people/company-search`, `/full-search`, `/mixed-search`, `/icp-search`, `/employees`, `/by-title`, `/contacts-by-title`, `/lookalike`. Docs: [People Search](https://leadmagic.io/docs/api-reference/people-search?utm_source=github&utm_medium=skill&utm_campaign=leadmagic-skills) ## Billing & plan awareness - 1 credit per returned result row. **Free** on Professional (≤5 req/s) and Ultimate (≤10 req/s) — their plans include credit-free Search API throughput. - Size before revealing (free on every plan): `POST /v3/search/stats` with the same filters returns match counts. On Basic–Growth, always size first and keep `per_page` small. ## Request ```bash curl -sS -X POST "https://api.leadmagic.io/v3/people/search" \ -H "X-API-Key: $LEADMAGIC_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "company_filters": { "company_domain": ["acme.com"] }, "people_filters": { "contact_job_function": ["Sales"], "contact_job_level": ["Director", "VP"] }, "page": 1, "per_page": 25 }' ``` ## Filter families | Family | Examples | |--------|----------| | Company | `company_domain`, `company_name`, `company_industry`, `company_size`/`company_sizes`, `company_country`/`company_countries`, funding | | Role | `contact_job_title`, `contact_job_function`, `contact_job_level`, `contact_persona`, `min_seniority` | | Person | name