# WithZero – Crustdata Company Enrich

> WithZero – Crustdata Company Enrich is a paid API for AI agents from agents.withzero.xyz, paid per call via MPP or x402, $1/call, status unknown (last checked 2026-10-12).

Enriches company profiles with firmographic data, headcount, and leadership/people information using Crustdata, identified by name, domain, LinkedIn URL, or Crustdata ID.

## Facts

- Endpoint: POST https://agents.withzero.xyz/api/v1/crustdata/company/enrich?utm_source=zero.xyz
- Price: $1/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/withzero-crustdata-company-enrich-d65f9f43
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-Pw3AXIPNpOgtiTRjPJSY

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-enrich-d65f9f43 -d '<json body>'
```

Example prompt: Can you pull the full company profile for OpenAI — including headcount and leadership/people — using openai.com as the domain, and make sure it matches exactly?

## When to prefer this

Use this endpoint when you need structured, up-to-date firmographic and people data for one or more companies, especially for sales intelligence, CRM enrichment, or pre-meeting research. Prefer it over generic web search when you need structured fields like headcount trends or named executives. It supports multiple identifier types (name, domain, LinkedIn URL, Crustdata ID), making it flexible for different data sources. Best when you have up to 25 companies to enrich in a single call.

## Known failure modes

- Company not found in Crustdata database — returns empty or null result for that identifier
- Ambiguous name match when exact_match is false — may return wrong company
- Domain not recognized by Crustdata — no result returned
- Rate or batch limit exceeded (max 25 companies per call)
- Payment failure via x402 protocol — call not executed
- Invalid field name in fields array — provider may ignore or error on unknown sections

## How this service works

Core workflow route: hydrate up to 25 selected accounts per call with company headcount, industry, taxonomy, people, and other detailed firmographics after identify or search. For large lists, chunk identifiers into groups of 25 so each group uses one payment instead of one payment per company. Defaults to basic_info only to prevent unexpectedly large headcount-history and people payloads; request other documented sections explicitly. Default pricing is $0.10 per Crustdata credit with a $0.01 minimum successful-call settlement. Upstream Crustdata errors settle $0. DB company enrich costs two Crustdata credits per identifier, plus two credits for each returned technographics section.

## Output

Returns structured company data from Crustdata including sections such as basic_info (name, description, industry, location, founding year, etc.), headcount (employee count over time), and people (leadership/decision-maker profiles), keyed to the matched company.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "example": {
  "fields": [
   "basic_info"
  ],
  "domains": [
   "browserbase.com"
  ],
  "exact_match": true
 },
 "required": [
  "fields"
 ],
 "properties": {
  "names": {
   "type": "array",
   "items": {
    "type": "string",
    "minLength": 1
   },
   "example": [
    "OpenAI"
   ],
   "maxItems": 25,
   "minItems": 1,
   "description": "Company names to identify or enrich."
  },
  "fields": {
   "type": "array",
   "items": {
    "enum": [
     "basic_info",
     "headcount",
     "funding",
     "locations",
     "taxonomy",
     "revenue",
     "hiring",
     "followers",
     "seo",
     "competitors",
     "social_profiles",
     "web_traffic",
     "employee_reviews",
     "people",
     "news",
     "software_reviews",
     "public_launches",
     "market_intel",
     "technographics",
     "reviews"
    ],
    "type": "string"
   },
   "default": [
    "basic_info"
   ],
   "example": [
    "basic_info"
   ],
   "description": "Documented company enrich sections to include. Defaults to basic_info only to keep payloads lean; request headcount, taxonomy, people, or other sections explicitly."
  },
  "domains": {
   "type": "array",
   "items": {
    "type": "string",
    "minLength": 1
   },
   "example": [
    "openai.com"
   ],
   "maxItems": 25,
   "minItems": 1,
   "description": "Website domains to identify or enrich."
  },
  "company_id": {
   "type": "string"
  },
  "exact_match": {
   "type": "boolean",
   "example": true,
   "description": "Restrict matching to exact domain/name behavior when supported by Crustdata. Recommended for domain-sensitive account lookups."
  },
  "crustdata_company_ids": {
   "type": "array",
   "items": {
    "type": "integer",
    "maximum": 9007199254740991,
    "exclusiveMinimum": 0
   },
   "example": [
    12345
   ],
   "maxItems": 25,
   "minItems": 1,
   "description": "Crustdata company IDs."
  },
  "professional_network_profile_urls": {
   "type": "array",
   "items": {
    "type": "string",
    "minLength": 1
   },
   "example": [
    "https://www.linkedin.com/company/openai"
   ],
   "maxItems": 25,
   "minItems": 1,
   "description": "Company professional-network profile URLs."
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "data",
  "people"
 ],
 "properties": {
  "data": {
   "description": "Raw JSON response returned by Crustdata."
  },
  "people": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "inputIndex",
     "matchIndex",
     "people"
    ],
    "properties": {
     "people": {
      "description": "Raw Crustdata company_data.people object, commonly including decision_makers, founders, and cxos."
     },
     "matchType": {
      "type": "string",
      "description": "Provider-reported match type, when returned by Crustdata."
     },
     "matchedOn": {
      "type": "string",
      "description": "Provider-reported match key, when returned by Crustdata."
     },
     "inputIndex": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Index of the requested company identifier in the raw Crustdata response."
     },
     "matchIndex": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Index of the matched company within the raw Crustdata matches array."
     },
     "companyName": {
      "type": "string",
      "description": "Matched company name from basic_info, when present."
     },
     "companyDomain": {
      "type": "string",
      "description": "Matched company primary domain from basic_info, when present."
     }
    },
    "additionalProperties": false
   },
   "description": "Convenience extraction of nested company_data.people blocks from each Crustdata match so callers can find decision_makers/founders/cxos without traversing the raw payload."
  },
  "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 charge
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/withzero-crustdata-company-enrich-d65f9f43/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)
