Tools · Search people

search_people

Describe who you want, or name the companies. Get names, titles and LinkedIn profiles, ranked by fit.

read-only≤ 45 s~$0.07 / 20 people

When to use

Use it for people: from a brief (q, plus titles), the holders of titles at chosen companies (companies + titles), or one named person (full_name).

Don’t use it to list companies (use search_companies or common_investors).

Request

POST /v1/search_people
curl https://lead-search-production.up.railway.app/v1/search_people \
  -H "Authorization: Bearer $MUNCH_KEY" \
  -d '{"q": "Heads of Growth at Series A fintechs in New York",
       "titles": ["Head of Growth"], "limit": 20}'

Over MCP, your agent fills these parameters from your request.

Parameters

All optional. Give at least one search criterion.

qstring

Your brief in one plain sentence: role + kind of company + place, e.g. "CTOs at fintech startups in London".

companiesstring[]up to 100 items

Domains of companies already chosen, e.g. ["stripe.com"]: returns the holders of `titles` there.

company_descriptionstring

The kind of company, e.g. "insurtech startups selling to insurers".

company_domainstring

One company, e.g. "stripe.com"; same as companies.

countrystringISO-2 codes

ISO-2 country: rows located elsewhere are dropped.

cursorstring

`next_cursor` from the previous answer, with exactly the same criteria: continues where it stopped, without fetching the same people again.

full_namestring

Look up one named person (a single routed call).

keywordsstring[]

Skills or topics, e.g. ["developer advocacy"]: each person is matched against them with the brief, so people far from them are left out.

limitintegerdefault 10 · 1–100

People wanted. The search keeps fetching until this many pass the checks.

locationstring

Free text, e.g. "San Francisco Bay Area".

response_formatstringdefault "concise"

"concise" (default): the fields needed to pick and act on rows. "detailed": every field (LinkedIn URLs, descriptions, industries); about 3-5x the tokens.

concise detailed
titlestring

One job title; prefer titles.

titlesstring[]up to 5 items

The role and its usual variants, e.g. ["Head of Data", "Chief Data Officer", "VP Data"], in the order of preference you gave.

Response

budget_left_today_usdnumber

What this key may still spend today (daily cap, resets 00:00 UTC); absent when uncapped

cost_usdnumber
next_cursorstring

Pass back as `cursor` with the same criteria to continue without fetching the same people again

notesstring[]

Plain-language notes for the user: what was found, what could not be confirmed, and what to do next

peoplePersonRow[]

people[] fields

companystring
company_domainstring
emailstring

Only when one was found; an unverified guess

linkedin_urlstring
locationstring
namestring
person_idstring

Pass to find_contacts to get this person's email or phone

rolestring

'ceo', 'cto', 'founder' (another founder) or 'other'; a founder/CEO search lists the CEO first

summarystring

Headline and experience as found, trimmed

titlestring

Errors: Errors. Limits: Limits.