# srch.best Complaints Search

> srch.best Complaints Search is a paid API for AI agents from x402.srch.best, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Search and retrieve structured consumer complaint records filtered by company, product, state, date range, and keyword query

## Facts

- Endpoint: POST https://x402.srch.best/complaints
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/srch-best-complaints-search-1f285a80
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HcQ_Q_eXjIcDxn3mA-rVO

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 srch-best-complaints-search-1f285a80 -d '<json body>'
```

Example prompt: Pull up to 50 consumer complaints filed against Wells Fargo about mortgage products in California between January 1 2023 and December 31 2023, and include the complaint narratives.

## When to prefer this

Choose this endpoint when you need structured, filterable consumer complaint data — especially for financial products and companies — and want server-side filtering by company, product, state, and date without scraping raw regulatory websites. Prefer it over web search when you need clean, paginated records rather than unstructured HTML, and when you want to include full complaint narratives programmatically.

## Known failure modes

- Invalid state code (must be 2-letter US state abbreviation) returns validation error
- Query string shorter than 2 characters is rejected
- Date format not matching YYYY-MM-DD causes parse error
- Limit exceeding 100 is rejected
- Payment failure via x402 prevents access to results
- No matching complaints returns empty result set
- Invalid cursor token causes pagination error

## How this service works

Structured complaints data for agents, paid per request with x402 v2

## Output

A paginated list of structured consumer complaint records matching the query filters. Each record includes complaint metadata such as company name, product type, state, date filed, and optionally the full consumer narrative. A continuation cursor is returned when more results exist beyond the requested limit.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 100,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 200,
   "minLength": 2
  },
  "state": {
   "type": "string",
   "pattern": "^[A-Za-z]{2}$"
  },
  "cursor": {
   "type": "string",
   "maxLength": 128,
   "minLength": 1,
   "description": "Opaque continuation cursor returned by the previous response."
  },
  "toDate": {
   "type": "string",
   "format": "date"
  },
  "company": {
   "type": "string",
   "maxLength": 200,
   "minLength": 2
  },
  "product": {
   "type": "string",
   "maxLength": 120,
   "minLength": 2
  },
  "fromDate": {
   "type": "string",
   "format": "date"
  },
  "includeNarratives": {
   "type": "boolean",
   "default": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/srch-best-complaints-search-1f285a80/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.srch.best](https://www.zero.xyz/host/x402.srch.best/llms.txt)
