# AgentReader Structured Data Extraction

> AgentReader Structured Data Extraction is a paid API for AI agents from agentreader.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-11).

Extracts structured JSON from any web page, HTML, or text by applying a caller-supplied JSON Schema, powered by Claude with guaranteed schema conformance.

## Facts

- Endpoint: POST https://agentreader.dev/extract?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentreader-structured-data-extraction-c4639f1f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-XIna2Wo9OCkjAo-20vJf

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 agentreader-structured-data-extraction-c4639f1f -d '<json body>'
```

Example prompt: Fetch the product page at https://example.com/product/123 and extract the product name, price, availability, and list of features into a JSON object matching this schema: {"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"},"available":{"type":"boolean"},"features":{"type":"array","items":{"type":"string"}}}}

## When to prefer this

Choose this endpoint when you need to extract structured, schema-validated JSON from arbitrary web content and you already know the exact shape of the output you want. It is ideal over generic scraping APIs when schema conformance is critical — e.g. feeding data directly into a typed database or a strictly-typed downstream service. Prefer it over general-purpose LLM calls when you want guaranteed JSON structure without writing your own extraction prompt engineering. It is especially useful when the source is unstructured prose, mixed HTML, or a public web page that would otherwise require custom parsing logic.

## Known failure modes

- URL is unreachable or returns non-200 — extraction cannot proceed, error returned
- Caller-provided JSON Schema is malformed or has unsupported constructs — validation error
- Target page requires JavaScript rendering or authentication — content may be incomplete or empty
- Requested schema fields are not present in source content — fields may be null or missing in output
- Input text/HTML is too long for the underlying model context window — truncation or error
- Rate limiting or payment failure via x402 — 402 response with payment details

## How this service works

AI structured-data extraction: turn any web page, text or HTML into JSON matching YOUR schema. Send JSON with one of url/text/html plus 'schema' (a JSON Schema object) and optional 'instructions'. Returns validated JSON. Powered by Claude with guaranteed schema conformance.

## Output

Returns a validated JSON object whose structure exactly matches the JSON Schema provided by the caller. All fields conform to the schema's types, required fields, and constraints. The response is guaranteed to be parseable JSON that passes schema validation, making it safe to use directly in downstream data pipelines without further normalization.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "URL to fetch and extract from (or use text/html)"
  },
  "html": {
   "type": "string",
   "description": "Raw HTML to extract from"
  },
  "text": {
   "type": "string",
   "description": "Raw text to extract from"
  },
  "schema": {
   "type": "object",
   "description": "JSON Schema (root type object) describing the desired output"
  },
  "instructions": {
   "type": "string",
   "description": "Optional extraction guidance"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentreader-structured-data-extraction-c4639f1f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentreader.dev](https://www.zero.xyz/host/agentreader.dev/llms.txt)