# WithZero via ZeroClick – Crustdata Person Search

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

Search and filter people/professionals using Crustdata's dataset, returning structured profile data based on filters, sorts, and field selections.

## Facts

- Endpoint: POST https://agents.withzero.xyz/api/v1/crustdata/person/search?utm_source=zero.xyz
- Price: $0.3/call
- Payment: x402, MPP
- Status: healthy
- Last checked: 2026-10-22
- Last successful call: 2026-09-23
- Success rate: 67% of calls made through Zero
- Rating: 4.3 / 5 from 3 reviews
- Activations on Zero: 27
- Tags: x402
- Canonical page: https://www.zero.xyz/c/withzero-via-zeroclick-crustdata-person-search-cfaac202
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sqmSsS9hSnk20A-5ovSZy

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-via-zeroclick-crustdata-person-search-cfaac202 -d '<json body>'
```

Example prompt: Search Crustdata for up to 10 people associated with the domain browserbase.com, returning their name, primary domain, and total headcount, sorted by headcount descending.

## When to prefer this

Use this endpoint when you need to search for people or professionals by company domain, filter on structured fields like headcount or industry, or paginate through large result sets from Crustdata's professional dataset. Prefer this over generic web search when you need structured, machine-readable professional profile data without managing a Crustdata API key directly.

## Known failure modes

- Invalid filter syntax returns a 400 error from the upstream Crustdata API
- Cursor from a different query or expired session returns a pagination error
- Requesting fields that don't exist in the schema returns empty or partial results
- Exceeding limit of 100 causes a validation error
- Payment failure (insufficient USDC balance) results in a 402 response before the query is executed
- Crustdata upstream outage returns a 502 or timeout

## How this service works

Core workflow route: find a page of people and prospects from the cached Crustdata person 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. PersonDB search is priced at 0.03 Crustdata credits per returned profile.

## Output

Returns a structured list of person records matching the filter criteria, including requested field sections such as basic_info (name, primary_domain), headcount totals, and industry taxonomy. May include a cursor for pagination and aggregation breakdowns if requested. Up to 100 records per call.

## 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."
  }
 }
}
```

## 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/withzero-via-zeroclick-crustdata-person-search-cfaac202/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)