companyenrich_companies_search $0.01225 per call

Search companies by firmographics, tech stack or keywords. Searches companies based on given criteria — name, domain, industry, employees, revenue, founded year, and more (CompanyEnrich · Company data)

POST https://toll402.dev/v1/p/companyenrich.companies.search
{
 "pageSize": 1,
 "page": 1,
 "technologies": [
  "stripe"
 ],
 "countries": [
  "US"
 ]
}

Input schema

{
 "type": "object",
 "properties": {
  "page": {
   "type": "integer",
   "description": "1-based page number; page * pageSize may not exceed 10,000 — past that use the scroll route",
   "examples": [
    1
   ]
  },
  "pageSize": {
   "type": "integer",
   "description": "1-100, default 10. THIS IS THE PRICE — 1 credit per company returned",
   "examples": [
    1
   ]
  },
  "query": {
   "type": "string",
   "description": "free-text match on company name and domain, max 250 chars"
  },
  "semanticQuery": {
   "type": "string",
   "description": "natural-language description of the companies you want; costs 2 credits per company instead of 1",
   "examples": [
    "companies that sell payment infrastructure to developers"
   ]
  },
  "semanticWeight": {
   "type": "number",
   "description": "0-1, default 0.7 — higher favours semantic similarity over the structured filters"
  },
  "technologies": {
   "type": "string",
   "description": "technology-stack names; resolve them first with the free /technologies/autocomplete",
   "examples": [
    [
     "stripe"
    ]
   ]
  },
  "keywords": {
   "type": "string",
   "description": "description keywords; resolve them first with the free /keywords/autocomplete"
  },
  "countries": {
   "type": "string",
   "description": "ISO 3166-1 alpha-2 codes",
   "examples": [
    [
     "US"
    ]
   ]
  },
  "regions": {
   "type": "string",
   "description": "region ids from the free GET /geo/regions"
  },
  "states": {
   "type": "string",
   "description": "state ids from the free POST /geo/states"
  },
  "cities": {
   "type": "string",
   "description": "city ids from the free POST /geo/cities"
  },
  "employees": {
   "type": "string",
   "description": "employee-count buckets, e.g. 1-10, 5K-10K, over-10K"
  },
  "reportedEmployees": {
   "type": "string",
   "description": "same buckets, but the externally reported figure"
  },
  "workforceSize": {
   "type": "string",
   "description": "absolute headcount ranges, finer-grained than the buckets"
  },
  "workforceGrowth": {
   "type": "object",
   "description": "filter by headcount growth rate over a window"
  },
  "revenue": {
   "type": "string",
   "description": "revenue buckets, e.g. over-1b"
  },
  "category": {
   "type": "string",
   "description": "b2b, b2c, b2g, saas, marketplace, service-provider …"
  },
  "type": {
   "type": "string",
   "description": "private, public, nonprofit, educational, government"
  },
  "naicsCode": {
   "type": "string",
   "description": "2-6 digit NAICS; a short code matches all its children"
  },
  "foundedYear": {
   "type": "object",
   "description": "range object, e.g. {min: 2015, max: 2022}"
  },
  "fundingRounds": {
   "type": "string",
   "description": "seed, series-a, …"
  },
  "fundingAmount": {
   "type": "object",
   "description": "range object in USD"
  },
  "fundingYear": {
   "type": "object",
   "description": "range object"
  },
  "require": {
   "type": "string",
   "description": "features that MUST be present on the company record"
  },
  "exclude": {
   "type": "object",
   "description": "domains/companies to drop; the per-search exclude cap is plan-bound (500 Starter → 50,000 Scale)"
  },
  "categoryOperator": {
   "type": "string",
   "description": "and | or — how multiple `category` values combine"
  },
  "keywordsOperator": {
   "type": "string",
   "description": "and | or"
  },
  "technologiesOperator": {
   "type": "string",
   "description": "and | or"
  },
  "lists": {
   "type": "string",
   "description": "restrict to saved list ids (dashboard feature, plan-gated)"
  }
 },
 "additionalProperties": true,
 "description": "ALWAYS call companyenrich.companies.search.count first: it is free and tells you the match total, so you never buy an unexpectedly large page. An empty result set still bills the 1-credit minimum. Deep pagination past 10,000 rows requires the scroll route."
}

MCP

{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}

All tools · OpenAPI