# Crustdata Company Search

> Crustdata Company Search is a paid API for AI agents from crustdata.withzero.xyz, paid per call via MPP, $0.003/result, status unknown (last checked 2026-09-15).

Search and filter the cached Crustdata company dataset to build target account lists using native filters, fields, sorts, cursor pagination, aggregations, and limit.

## Facts

- Endpoint: POST https://crustdata.withzero.xyz/api/v1/company/search
- Price: $0.003/result
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Provider: crustdata.withzero.xyz
- Website: https://crustdata.withzero.xyz
- Canonical page: https://www.zero.xyz/c/crustdata-withzero-xyz-crustdata-company-search-cb35ea69
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_H8K9fCwWVkGGg0dadNC1G

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 crustdata-withzero-xyz-crustdata-company-search-cb35ea69 -d '<json body>'
```

Example prompt: Search Crustdata for up to 50 US-headquartered companies, returning their company name, HQ country, and LinkedIn profile URL, filtered where hq_country equals USA and sorted by employee count descending.

## When to prefer this

Use this endpoint when you need to build or filter target account lists from Crustdata's cached company dataset using firmographic filters like country, industry, or employee count. Prefer this over the live LinkedIn search route when freshness is not critical and cost efficiency matters, since cached data is cheaper. Use this before the company enrichment route to identify accounts, then enrich selected ones.

## Known failure modes

- Invalid filter syntax returns upstream Crustdata error with $0 settlement
- Cursor token expired or malformed causes pagination failure
- Requesting fields that don't exist in the schema returns empty or partial results
- Limit exceeding 1000 is rejected with a validation error
- Network or upstream Crustdata outage returns error with $0 settlement
- Malformed JSON body returns 400-level error

## How this service works

Core workflow route: build a target account page from the cached Crustdata company dataset using provider-native filters, fields, sorts, cursor, aggregations, and limit. Default pricing is $0.10 per Crustdata credit with a $0.01 minimum successful-call settlement. Upstream Crustdata errors settle $0. CompanyDB search is priced at 0.03 Crustdata credits per returned company.

## Output

Returns a raw Crustdata JSON response containing matching company records with the requested fields, plus billing metadata including API credits consumed, USDC micro-units settled, price per credit, and minimum call settlement amount.

## Example request

```json
{
 "limit": 10,
 "fields": [
  "basic_info.name",
  "basic_info.primary_domain",
  "headcount.total"
 ],
 "filters": {
  "op": "and",
  "conditions": [
   {
    "type": "=",
    "field": "basic_info.primary_domain",
    "value": "example.com"
   }
  ]
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "example": {
  "limit": 10,
  "fields": [
   "basic_info.name",
   "basic_info.primary_domain",
   "headcount.total"
  ],
  "filters": {
   "op": "and",
   "conditions": [
    {
     "type": "=",
     "field": "basic_info.primary_domain",
     "value": "browserbase.com"
    }
   ]
  }
 },
 "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."
  }
 },
 "additionalProperties": {}
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "description": "Raw JSON response returned by Crustdata."
  },
  "billing": {
   "type": "object",
   "required": [
    "apiCredits",
    "minimumCallUsdcMicro",
    "pricePerCreditUsdcMicro",
    "settledUsdcMicro"
   ],
   "properties": {
    "apiCredits": {
     "type": "number",
     "example": 0.06,
     "description": "Estimated Crustdata API credits charged for this request."
    },
    "settledUsdcMicro": {
     "type": "string",
     "example": "10000",
     "description": "USDC micro-units settled for this request."
    },
    "minimumCallUsdcMicro": {
     "type": "string",
     "example": "10000",
     "description": "Configured minimum successful-call settlement in USDC micro-units."
    },
    "pricePerCreditUsdcMicro": {
     "type": "string",
     "example": "100000",
     "description": "Configured USDC micro-units charged per Crustdata API credit."
    }
   },
   "additionalProperties": false
  }
 },
 "additionalProperties": false
}
```

## More

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