# Lead: people search

`POST https://api.crawl4ai.com/lead/people/search`

Find the people and the companies you want to reach. Lead holds 68M people at 20M companies, each with insights (seniority, department, decision role, skills, topics, summary). A person read from a company's own page names that page in `source_url`. Filter on the company (industry, country, city, technology) and on what a person is (decision maker, seniority, department, still in the role); put the best first with `about`. Every record names the page it came from.


curl:

```bash
curl https://api.crawl4ai.com/lead/people/search \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "where": { "company": { "industry": "Dentists", "country": "at" },
                  "person":  { "decision_role": "decision_maker", "status": "current" } },
        "about": "online booking", "limit": 25 }'
```

## Body

| Name | Type | Default | Description |
|---|---|---|---|
| where.company | object | - | `industry` (a name from the LinkedIn list, see `GET /lead/industries`; a broad name matches every industry under it) · `country` (two letters: `de`) · `city` · `domain`. Companies search also: `name`, `description`, `tech` (`shopify`), `hiring_system`, `mail_provider`, `has_people`, `has_email`. |
| where.person | object | - | `decision_role` (decision_maker, influencer, user) · `seniority` (owner_founder, c_level, vp, director, manager, senior, individual, intern) · `department` (executive, engineering, product, sales, marketing, finance, hr, operations, legal, it, support, design, research, other) · `hiring_manager` (yes, likely, no) · `status` (current, former, retired) · `title` (the job title as typed: words in any order, with synonyms such as VP = Vice President, Head = Director; a part also matches the person's seniority and department) · `skills`, `topics`, `languages` · `has_email`. |
| where.not | object | - | The same keys, to leave out: `{"person": {"seniority": ["intern"]}}`. |
| about | string | - | Words that put the best matches first: an intent, a topic, a signal. It never removes a match; each person's `why` shows the text that matched. |
| limit · next | int · string | - | Records on the page, 1 to 100 (default 25); `next` from the last answer gives the following page. |

A list means "any of" (`"country": ["de", "at"]`); all keys must match together. A wrong value answers `400` with the fix: `unknown industry "dental care"; closest: Dentists, …`.

## Response

json · shortened:

```json
{ "data": [ {
    "id": "p_135bay", "name": "Dr. Lena Hoffmann", "title": "Owner & Lead Dentist",
    "company": { "name": "Zahnarztpraxis Hoffmann", "domain": "praxis-hoffmann.at", "industry": "Dentists", "city": "Graz", "country": "AT" },
    "email": { "value": "l.hoffmann@praxis-hoffmann.at", "status": "valid", "kind": "personal" },
    "insight": { "seniority": "owner_founder", "decision_role": "decision_maker", "status": "current",
                 "skills": [ … ], "summary": "Owns the practice and introduced online booking.", "evidence": [ … ] },
    "why": [ { "matched": "online", "quote": "Termine jetzt online buchen", "from": "page" } ],
    "score": 7.98, "source_url": "https://praxis-hoffmann.at/team" } ],
  "meta": { "total": 133, "took_ms": 31 }, "next": "o25" }
```

| Route | Does |
|---|---|
| POST /lead/people/search | People, by their company and by what they are (above). |
| POST /lead/companies/search | Companies, with `where.company` and `about` over their description. |
| GET /lead/person | One person: `?email=`, `?linkedin=`, or `?name=&domain=`. |
| GET /lead/company | One company: `?domain=`, `?linkedin=` (its LinkedIn company page) or `?name=` (with an optional `country`). A name answers only when one company clearly has it; else 404 with `candidates`, free. |
| GET /lead/industries | The industry names, or the closest to your words: `?q=dental clinics`. Free. |

Price: 0.3 credit per record returned (a page of 25 is 7.5 credits). An empty answer, a miss and an error are free. A person can remove themselves at [crawl4ai.com/your-data](https://crawl4ai.com/your-data/); removed people never come back.

**Try it with your key**

Run this call in the playground and see the real answer, the time and the units.
[Open the playground](https://crawl4ai.com/#playground)



---
Source: https://crawl4ai.com/docs/lead/