Crawl4AI Cloud

Lead: people search

POSThttps://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.

68M people20M companies0.3 credit per record returnedFree an empty answer, a miss and an error
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

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

{ "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; 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

Next

Prices from pricing pagesPOST /price

Give it websites, get their prices.

RecipesPOST /recipes/{name}

Ready-made scrapers.

PreviousPriceNextMCP server

Something unclear or wrong on this page? Tell us.