# WithZero – Crustdata Company Search

> WithZero – Crustdata Company Search is a paid API for AI agents from agents.withzero.xyz, paid per call via x402 or MPP, $0.3/call, status unknown (last checked 2026-09-15, last successful call 2026-07-23).

Search and filter companies using Crustdata's database via WithZero's pay-per-use proxy, returning structured company profiles with headcount, domain, and industry data.

## Facts

- Endpoint: POST https://agents.withzero.xyz/api/v1/crustdata/company/search
- Price: $0.3/call
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-09-15
- Last successful call: 2026-07-23
- Success rate: 71% of calls made through Zero
- Rating: 5.0 / 5 from 1 review
- Activations on Zero: 8
- Tags: x402
- Canonical page: https://www.zero.xyz/c/withzero-crustdata-company-search-7660184b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lldoIl1V-w1ezCW8RpkPJ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability withzero-crustdata-company-search-7660184b -d '<json body>'
```

Example prompt: Search Crustdata for companies whose primary domain is browserbase.com — return their name, domain, and total headcount, limit to 10 results sorted by headcount descending.

## When to prefer this

Use this endpoint when you need to search or filter companies programmatically using Crustdata's native filter/sort/aggregation syntax, especially when you have a domain name, industry, or headcount criterion. Prefer this over generic web search when you need structured firmographic data. Ideal for B2B research, lead generation filtering, or enriching a list of companies with headcount and industry data without needing your own Crustdata account.

## Known failure modes

- Invalid or malformed filter conditions return a 400 error
- Cursor value expired or invalid returns a pagination error
- Requested fields not available for the queried dataset return partial or empty results
- Exceeding limit of 100 records per call returns a validation error
- Payment failure or insufficient USDC balance blocks the request
- Rate limits on the underlying Crustdata API may cause 429 errors

## How this service works

Create media, research companies and people, publish to the web, remember context, deploy apps, and schedule work—on demand, without vendor accounts or API keys. This server is a pay-per-use, transparent proxy in front of WithZero's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. This document is the source of truth for agents: it lists the complete verified paid surface with each operation's live price in its x-payment-info. Endpoints not listed here are not part of the supported catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge.

## Output

Returns structured company records from Crustdata, including requested field sections such as company name, primary domain, total headcount, and industry taxonomy. May also include aggregation results and a cursor for paginating to the next page of results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "example": 10,
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum records to return. Max 100."
  },
  "sorts": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "field",
     "order"
    ],
    "properties": {
     "field": {
      "type": "string",
      "example": "headcount.total",
      "minLength": 1,
      "description": "Provider-native field path. The live 2025-11-01 API expects field even though some Crustdata examples use column."
     },
     "order": {
      "enum": [
       "asc",
       "desc"
      ],
      "type": "string",
      "example": "desc",
      "description": "Sort direction."
     }
    },
    "additionalProperties": {}
   },
   "example": [
    {
     "field": "headcount.total",
     "order": "desc"
    }
   ],
   "description": "Crustdata sort descriptors using the live API field/order contract."
  },
  "cursor": {
   "type": "string",
   "example": "eyJwYWdlIjoyfQ",
   "minLength": 1,
   "description": "Cursor returned by the previous page."
  },
  "fields": {
   "type": "array",
   "items": {
    "type": "string",
    "minLength": 1
   },
   "example": [
    "basic_info.name",
    "basic_info.primary_domain",
    "headcount.total"
   ],
   "description": "Response field sections or dot-paths to include."
  },
  "filters": {
   "example": {
    "op": "and",
    "conditions": [
     {
      "type": "=",
      "field": "basic_info.primary_domain",
      "value": "browserbase.com"
     }
    ]
   },
   "description": "Crustdata provider-native filter condition or condition group."
  },
  "preview": {
   "type": "boolean",
   "example": false,
   "description": "Return preview metadata when supported by the endpoint."
  },
  "aggregations": {
   "example": {
    "field": "taxonomy.professional_network_industry"
   },
   "description": "Provider-native aggregation request for endpoints that support it."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/withzero-crustdata-company-search-7660184b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.withzero.xyz](https://www.zero.xyz/host/agents.withzero.xyz/llms.txt)
