# Ysaere Entity Classify

> Ysaere Entity Classify is a paid API for AI agents from api.ysaere.com, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-13).

Classifies a named entity (company, person, protocol, etc.) into typed labels with confidence scores

## Facts

- Endpoint: POST https://api.ysaere.com/v1/intel/classify
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ysaere-entity-classify-bd14ccce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ym1CbHQZGoWt-VGLCJ4VY

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 ysaere-entity-classify-bd14ccce -d '<json body>'
```

Example prompt: Can you classify 'Stripe' and tell me whether it's a company, person, or protocol — and how confident you are?

## When to prefer this

Choose this endpoint when you need fast, typed classification of a named entity into categories like company, person, or protocol with a confidence score — especially in pipelines where entity type disambiguation is needed before deeper checks like KYB verification. Prefer this over general-purpose NLP APIs when you need structured label output with confidence, and over the sibling KYB endpoint when you only need entity type, not a full compliance screen.

## Known failure modes

- Ambiguous entity name may return low confidence scores or multiple conflicting labels
- Unknown or very obscure entities may return no labels or low-confidence results
- Malformed or empty input string may result in a 400 error
- Payment failure or insufficient USDC balance may result in a 402 error

## How this service works

Ysaere entity classify — typed labels (company/person/protocol/…) for $0.20 USDC

## Output

Returns a JSON object with a labels array, where each label contains the entity name, its type (e.g. company, person, protocol), and a confidence score between 0 and 1, wrapped in a success boolean.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "labels": [
    {
     "name": "Stripe",
     "type": "company",
     "confidence": 0.95
    }
   ]
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ysaere-entity-classify-bd14ccce/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ysaere.com](https://www.zero.xyz/host/api.ysaere.com/llms.txt)