Tools · Search companies
search_companies
Describe the companies you sell to, or give examples. Get ranked rows with domain, size and country.
When to use
Use it for a list of B2B companies (accounts) matching a description or firmographic criteria: a category, country, headcount, funding stage, founding year, tech stack.
Don’t use it to look up one known company, or to find companies through their investors (use common_investors).
Request
curl https://lead-search-production.up.railway.app/v1/search_companies \
-H "Authorization: Bearer $MUNCH_KEY" \
-d '{"q": "B2B fintechs in the US", "countries": ["US"],
"employees_min": 50, "employees_max": 200}'
Over MCP, your agent fills these parameters from your request.
Parameters
All optional. Give at least one search criterion.
qstringPlain-language brief of the kind of company, e.g. "video infrastructure APIs sold to developers".
countriesstring[]HQ countries, ISO-2, e.g. ["FR", "DE"].
cursorstring`next_cursor` from the previous answer, sent with exactly the same criteria, to get the next page. The next page never repeats a company.
employee_rangesstring[]Headcount buckets; give every bucket your range overlaps, e.g. 30-300 -> ["11-50", "51-200", "201-500"].
8 values
1-10 11-50 51-200 201-500 501-1000 1001-5000 5001-10000 10001+employees_maxintegerExact headcount, highest, e.g. 10.
employees_minintegerExact headcount, lowest, e.g. 5.
exclude_descriptionstringOne line on what must NOT match; a match counts as a non-fit. Needs icp_description.
exclude_domainsstring[]Companies to leave out: existing customers, competitors, companies already listed.
exclude_keywordsstring[]Terms that must NOT appear in the name, industry or description, e.g. ["agency"].
founded_afterintegerFounded in or after this year.
founded_beforeintegerFounded in or before this year.
funding_typesstring[]Last funding round.
23 values
Series unknown Pre seed Seed Series A Series B Series C Series D Series E-J Grant Angel Private equity Debt financing Non equity assistance Post IPO equity Undisclosed Post IPO debt Product crowdfunding Equity crowdfunding Corporate round Convertible note Secondary market Initial coin offering Post IPO secondaryicp_descriptionstring1-3 sentences on who fits, e.g. "B2B SaaS with a public API sold to engineering teams; not agencies".
industriesstring[]LinkedIn industry names, e.g. ["Software Development"]. Strict and unreliable for startups; an unknown name is searched as a keyword.
keywordsstring[]Precise literal terms in the company description, e.g. ["OTT", "PMS"].
limitintegerNumber of companies wanted; at most this many are returned. Rows fetched past it come back on the next page.
response_formatstring"concise" (default): the fields needed to pick and act on rows. "detailed": every field (LinkedIn URLs, descriptions, industries); about 3-5x the tokens.
concise detailedsimilar_tostring[]Domains of example companies, to find look-alikes, e.g. ["thekooples.com", "jacquemus.com"].
strict_filtersbooleantrue: search only sources that apply every filter for real. Fewer, exact rows; can find nothing.
technologiesstring[]Tools the company uses, e.g. ["stripe", "segment"].
Response
budget_left_today_usdnumberWhat this key may still spend today (daily cap, resets 00:00 UTC); absent when uncapped
companiesCompanyRow[]cost_usdnumbernext_cursorstringPass back as `cursor` with the same criteria to get more
notesstring[]Plain-language notes for the user: what was found, what could not be confirmed, and what to do next
referencesCompanyRow[]The similar_to companies as looked up
companies[] fields
citystringcountrystringdescriptionstringdomainstringNone when the company's website is a recruiting platform's page: `linkedin_url` identifies it
employeesintegerfounded_yearintegerfunding_stagestringindustrystringlinkedin_urlstringnamestringrevenue_rangestringsizestringreferences[] fields
citystringcountrystringdescriptionstringdomainstringNone when the company's website is a recruiting platform's page: `linkedin_url` identifies it
employeesintegerfounded_yearintegerfunding_stagestringindustrystringlinkedin_urlstringnamestringrevenue_rangestringsizestring