# Ysaere Agent Extract Entities

> Ysaere Agent Extract Entities is a paid API for AI agents from api.ysaere.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-20).

Extracts people, organizations, places, and products from a URL or text, with optional SEC/GLEIF/SAM.gov/SunBiz resolution for up to 3 organizations

## Facts

- Endpoint: POST https://api.ysaere.com/v1/intel/extract-entities?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ysaere-agent-extract-entities-3adbfd89
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cSN3fn4NtHBJd2vncnyp9

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-agent-extract-entities-3adbfd89 -d '<json body>'
```

Example prompt: Pull all the people, organizations, places, and products mentioned in this article — https://www.reuters.com/business/aerospace-defense/anduril-wins-pentagon-contract-2024/ — and cross-check the companies against SEC and SAM.gov so I know which ones are registered federal contractors.

## When to prefer this

Choose this endpoint when you need structured entity extraction from unstructured text or a web URL, especially when you also need downstream corporate identity verification against official registries like SEC, GLEIF, SAM.gov, or Florida SunBiz. It is better than generic NLP APIs when regulatory or compliance-grade entity resolution is required. Prefer it over manual lookup when screening documents for known organizations in a single call.

## Known failure modes

- URL is not publicly accessible or blocked by SSRF checks — returns error without charge
- Text exceeds 8,000 character limit — rejected before payment
- No entities found in document — may return empty arrays; payment still processed
- Organization resolution services (SEC/GLEIF/SAM.gov) temporarily unavailable — entities still returned without enrichment
- Invalid JSON input or missing both url and text fields — validation error

## How this service works

Ysaere Agent Extract Entities — $0.03 USDC. Input: {"url" or "text"}. Returns people, organizations, places and products; up to 3 organizations are resolved against SEC, GLEIF, SAM.gov and Florida SunBiz with a match confidence. Nothing found is refused before payment.

## Output

A structured list of extracted entities grouped by type (people, organizations, places, products), with up to 3 organizations enriched with match results and confidence scores from SEC EDGAR, GLEIF, SAM.gov, and Florida SunBiz. Optionally includes a Notary receipt with a SHA-512 hash of the output for integrity verification.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Public https URL to read (fetched with SSRF checks)."
  },
  "text": {
   "type": "string",
   "maxLength": 8000,
   "description": "Text to use instead of a URL (max 8,000 characters)."
  },
  "stamp": {
   "type": "boolean",
   "description": "Optional. When true, mint a hash_only Notary receipt over output_sha512 (integrity, not factual truth)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ysaere-agent-extract-entities-3adbfd89/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)
