Tools · Search companies

search_companies

Describe the companies you sell to, or give examples. Get ranked rows with domain, size and country.

read-only≤ 45 s$0.0004–$0.01 / company

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

POST /v1/search_companies
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.

qstring

Plain-language brief of the kind of company, e.g. "video infrastructure APIs sold to developers".

countriesstring[]ISO-2 codes

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 values1-10 11-50 51-200 201-500 501-1000 1001-5000 5001-10000 10001+
employees_maxinteger≥ 1

Exact headcount, highest, e.g. 10.

employees_mininteger≥ 1

Exact headcount, lowest, e.g. 5.

exclude_descriptionstring

One 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_afterinteger1800–2100

Founded in or after this year.

founded_beforeinteger1800–2100

Founded in or before this year.

funding_typesstring[]

Last funding round.

23 valuesSeries 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 secondary
icp_descriptionstring

1-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"].

limitintegerdefault 25 · 1–100

Number of companies wanted; at most this many are returned. Rows fetched past it come back on the next page.

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
similar_tostring[]up to 5 items

Domains of example companies, to find look-alikes, e.g. ["thekooples.com", "jacquemus.com"].

strict_filtersbooleandefault false

true: 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_usdnumber

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

companiesCompanyRow[]
cost_usdnumber
next_cursorstring

Pass 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

citystring
countrystring
descriptionstring
domainstring

None when the company's website is a recruiting platform's page: `linkedin_url` identifies it

employeesinteger
founded_yearinteger
funding_stagestring
industrystring
linkedin_urlstring
namestring
revenue_rangestring
sizestring

references[] fields

citystring
countrystring
descriptionstring
domainstring

None when the company's website is a recruiting platform's page: `linkedin_url` identifies it

employeesinteger
founded_yearinteger
funding_stagestring
industrystring
linkedin_urlstring
namestring
revenue_rangestring
sizestring

Errors: Errors. Limits: Limits.