thecompaniesapi_companies_search $0.002375 per call

Search companies by industry, size, location or tech. Search companies by industry, size, location, technology or any other attribute filter (The Companies API · Company data)

For AI agents: call thecompaniesapi_companies_search
POST https://toll402.dev/v1/p/thecompaniesapi.companies.search
{
 "query": "[{\"attribute\":\"about.industries\",\"operator\":\"or\",\"sign\":\"equals\",\"values\":[\"software\"]}]",
 "size": 1,
 "simplified": true
}
Answers 402 with x402 payment requirements; pay with any x402 client (@x402/fetch, x402 for Python, toll402-client, toll402-mcp) or send a prepaid-credits key as x-toll402-key (https://toll402.dev/credits). Paid per call via x402 (USDC on Base) or with a prepaid-credits key (x-toll402-key, card at /credits); charged only on success. Start at /llms.txt or connect the MCP server: npx -y toll402-mcp · remote https://toll402.dev/mcp.

Input schema

{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "a stringified, URL-encoded ARRAY of conditions, each {attribute, operator: 'and'|'or', sign: 'equals'|…, values: [...]}",
   "examples": [
    "[{\"attribute\":\"about.industries\",\"operator\":\"or\",\"sign\":\"equals\",\"values\":[\"software\"]}]"
   ]
  },
  "size": {
   "type": "integer",
   "description": "results per page, 1-100, default 10 — THIS IS THE PRICE DIAL: 1 credit per company returned",
   "examples": [
    1
   ]
  },
  "page": {
   "type": "integer",
   "description": "1-based page number, default 1"
  },
  "search": {
   "type": "string",
   "description": "extra free-text match on company name or domain"
  },
  "searchFields": {
   "type": "string",
   "description": "which fields `search` applies to, e.g. domain, name"
  },
  "simplified": {
   "type": "boolean",
   "description": "reduced records for ZERO credits — always preview a new query this way before paying for it",
   "examples": [
    true
   ]
  },
  "domainsToExclude": {
   "type": "string",
   "description": "comma-separated domains to drop from the results"
  },
  "linkedinToExclude": {
   "type": "string",
   "description": "comma-separated LinkedIn URLs to drop"
  },
  "sortKey": {
   "type": "string",
   "description": "field to sort by, e.g. meta.score, about.name"
  },
  "sortOrder": {
   "type": "string",
   "description": "asc | desc"
  },
  "sortFields": {
   "type": "string",
   "description": "multiple sort criteria, stringified and URL-encoded"
  },
  "actionId": {
   "type": "integer",
   "description": "scope the search to a saved action"
  }
 },
 "additionalProperties": true,
 "required": [
  "query"
 ],
 "description": "POST /companies takes the identical fields as a JSON body, which is easier when the condition array is long. `searchFields` accepts about.name and domain.domain. Always set an explicit small `size` — the default of 10 bills for 10 companies. GET /companies/count returns just the match count and is widely treated as free, though that is not published"
}

MCP

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

All tools · OpenAPI