# Ysaere Agent Extract JSON

> Ysaere Agent Extract JSON 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).

Fetches a URL or accepts raw text, extracts structured data conforming to a caller-supplied JSON Schema, and returns validated JSON plus a SHA-512 output hash.

## Facts

- Endpoint: POST https://api.ysaere.com/v1/intel/extract-json?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-json-745fad3b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_suvfBdpVWjy_5GSOkyYnV

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-json-745fad3b -d '<json body>'
```

Example prompt: Fetch this product page https://example.com/product/123 and extract the product name, price, and availability into a JSON object — only return values that match my schema: {"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"},"available":{"type":"boolean"}},"required":["name","price","available"]}.

## When to prefer this

Choose this endpoint when you need schema-validated structured JSON extracted from an arbitrary public URL or raw text, and you want a guarantee that the output conforms to your schema before you pay. It is especially valuable when downstream code depends on a known data shape and you cannot tolerate malformed or missing fields. Prefer it over generic scraping tools when output integrity (via SHA-512 hash) or optional notarization matters.

## Known failure modes

- Schema validation failure — extracted data cannot satisfy the supplied schema; request refused and no charge applied
- SSRF block — URL resolves to a private/internal address and is rejected
- URL fetch failure — target URL is unreachable, times out, or returns a non-200 status
- Schema too large — supplied JSON Schema exceeds 8 KB limit
- Text too long — raw text input exceeds 8,000 character limit
- Malformed schema — supplied schema uses unsupported JSON Schema keywords or types
- Payment failure — x402 USDC payment not completed; request not processed

## How this service works

Ysaere Agent Extract JSON — $0.03 USDC. Input: {"url" or "text", "schema": <JSON Schema ≤8 KB: object/array/string/number/integer/boolean/enum/required>}. Returns data that validates against your schema plus output_sha512. Output that fails your schema is refused before payment.

## Output

Returns a JSON object whose structure is guaranteed to satisfy the caller-supplied JSON Schema, plus an output_sha512 field (hex string) over the returned payload. If the stamp flag is true, a hash_only Notary receipt is also returned. Outputs that cannot be made to validate against the schema are refused before any charge is applied.

## 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)."
  },
  "schema": {
   "type": "object",
   "description": "JSON Schema subset the output must satisfy (≤8 KB)."
  }
 }
}
```

## More

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