# paid-md Extract

> paid-md Extract is a paid API for AI agents from paid-md.hihat.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-30).

Extracts structured JSON from any web page or raw text using a caller-supplied JSON Schema, returning only the requested fields with no prose.

## Facts

- Endpoint: POST https://paid-md.hihat.workers.dev/extract?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/paid-md-extract-7d43beba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rblZdW7KlIUbhaCIo9e0u

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 paid-md-extract-7d43beba -d '<json body>'
```

Example prompt: Scrape this product page — https://example.com/product/123 — and extract the product name, price, availability, and list of technical specs into structured JSON matching this schema: {name: string, price: number, available: boolean, specs: string[]}.

## When to prefer this

Choose this endpoint when you need to turn a specific web page or block of text into machine-readable JSON matching your own schema — especially for one-off extractions, agent pipelines that consume web data, or when the target site has no API. It handles long pages and returns strict schema-conformant JSON, making it ideal over generic LLM extraction when schema compliance and pay-per-call economics matter.

## Known failure modes

- Page is behind authentication or a bot wall — returns error or empty fields
- Schema does not match available content — fields return null or empty strings
- URL is unreachable or returns a non-200 response — fetch error returned
- Page content is ambiguous for the requested schema — fields may be incorrectly mapped
- Very large or highly dynamic JavaScript-rendered pages may be partially parsed

## How this service works

Extract structured JSON from any web page or raw text using your own JSON Schema. Web scraping to structured data: give a URL (or pasted text, HTML or Markdown) plus a schema and get back only the fields you asked for: prices, names, dates, specs, contact details, tables, product data. Handles pages too long to read in full. Returns strict JSON that matches the schema, no prose. Pay per call in USDC via x402.

## Output

A strict JSON object or array that conforms exactly to the caller-supplied JSON Schema, containing only the requested fields extracted from the source page or text. No prose, no extra keys, no explanation — just the structured data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Page to read. Use this or text."
  },
  "text": {
   "type": "string",
   "description": "Raw text instead of a url."
  },
  "schema": {
   "type": "object",
   "description": "Shape of the JSON you want back."
  },
  "instructions": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/paid-md-extract-7d43beba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from paid-md.hihat.workers.dev](https://www.zero.xyz/host/paid-md.hihat.workers.dev/llms.txt)