diffbot_companies_search $0.037375 per call

Search companies by DQL filter — industry, revenue. Search the Diffbot Knowledge Graph for companies by DQL filter (industry, revenue) (Diffbot · Company data)

For AI agents: call diffbot_companies_search
POST https://toll402.dev/v1/p/diffbot.companies.search
{
 "query": "type:Organization industries:\"Software Companies\"",
 "size": 1,
 "from": 0
}
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 DQL query string; the type facet picks the entity, e.g. type:Organization industries:\"Software Companies\" nbEmployees>50",
   "examples": [
    "type:Organization industries:\"Software Companies\""
   ]
  },
  "type": {
   "type": "string",
   "description": "'query' (default) returns entities; 'refresh' re-crawls the matches before returning"
  },
  "size": {
   "type": "integer",
   "description": "entities to return, DEFAULT 50, and -1 means ALL — at 25 credits each, an unset size is a 1,250-credit call. Always set this explicitly",
   "examples": [
    1
   ]
  },
  "from": {
   "type": "integer",
   "description": "offset for paging; from + size must stay under 10,000 on facet queries",
   "examples": [
    0
   ]
  },
  "format": {
   "type": "string",
   "description": "json (default) | jsonl | csv | xls | xlsx"
  },
  "jsonmode": {
   "type": "string",
   "description": "'extended' adds provenance, 'id' returns bare DiffbotIds"
  },
  "nonCanonicalFacts": {
   "type": "boolean"
  },
  "filter": {
   "type": "string",
   "description": "JsonPath expression selecting which parts of each record to return"
  }
 },
 "additionalProperties": true,
 "required": [
  "query"
 ],
 "description": "THE QUOTA TRAP ON THIS PROVIDER: `size` defaults to 50, not 1, and -1 returns everything — always pass an explicit small size before you trust a new query. A POST variant of /dql accepts the same fields"
}

MCP

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

All tools · OpenAPI