# HARS-Zero Signal API – HTML Extraction Endpoint

> HARS-Zero Signal API – HTML Extraction Endpoint is a paid API for AI agents from hars.cryptotavern.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Fetches a URL and extracts structured HTML fields (title, headings, links, paragraphs, images, metadata) into a machine-readable JSON object

## Facts

- Endpoint: GET https://hars.cryptotavern.xyz/paid/extract
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hars-zero-signal-api-html-extraction-endpoint-ad026708
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pruheSdV9-8aFu8PD4x7r

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 hars-zero-signal-api-html-extraction-endpoint-ad026708
```

Example prompt: Can you fetch https://example.com/article and extract the structured content — title, headings, paragraphs, and all links — into a clean JSON object?

## When to prefer this

Choose this endpoint when you need to turn any arbitrary public URL into a structured JSON representation of its HTML content — especially in high-frequency agent loops where cost matters, since at $0.002 per call there is no subscription overhead. Prefer it over browser automation tools when you need lightweight, fast structured extraction rather than full JavaScript rendering. It is ideal for pipelines that need to parse articles, product pages, or reference documents into fields like headings, paragraphs, and links without building a custom scraper.

## Known failure modes

- URL is unreachable or returns a non-200 HTTP status — extraction fails with an error response
- Page is JavaScript-rendered only — static HTML extraction may return empty or incomplete content
- Paywalled or bot-protected pages may return minimal or misleading HTML
- Invalid or malformed URL input causes a validation error
- Payment failure via x402 protocol (insufficient USDC balance) blocks the request entirely

## How this service works

Utility API for AI agents — fetch URLs, extract structured HTML,
summarize text, get live FX rates, and geocode addresses. Pay per call
in USDC on Base or Solana via x402. No API keys, no subscriptions.
Sub-cent pricing optimized for high-volume agent loops.

## Output

A JSON object containing structured fields extracted from the fetched URL: page title, hierarchical headings (with level), body paragraphs, links (with href and anchor text), images (with src and alt), favicon, canonical URL, language, og_image, word count, estimated read time in minutes, a text description, a model confidence score (0–1), the source URL, a timestamp, and optionally a next_best_action suggestion pointing to a follow-up endpoint.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "as_of",
  "title"
 ],
 "properties": {
  "as_of": {
   "type": "string",
   "format": "date-time",
   "description": "RFC3339 timestamp"
  },
  "links": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "href",
     "text"
    ],
    "properties": {
     "rel": {
      "type": "string"
     },
     "href": {
      "type": "string"
     },
     "text": {
      "type": "string"
     }
    }
   }
  },
  "risks": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "title": {
   "type": "string"
  },
  "images": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "src"
    ],
    "properties": {
     "alt": {
      "type": "string"
     },
     "src": {
      "type": "string"
     }
    }
   }
  },
  "favicon": {
   "type": "string"
  },
  "product": {
   "type": "string"
  },
  "evidence": {
   "type": "array",
   "items": {
    "type": "string",
    "format": "uri"
   },
   "description": "Polymarket order book / event / reference URLs"
  },
  "headings": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "level",
     "text"
    ],
    "properties": {
     "text": {
      "type": "string"
     },
     "level": {
      "type": "integer"
     }
    }
   }
  },
  "language": {
   "type": "string"
  },
  "og_image": {
   "type": "string"
  },
  "canonical": {
   "type": "string"
  },
  "confidence": {
   "type": "number",
   "maximum": 1,
   "minimum": 0,
   "description": "Model confidence 0.0-1.0"
  },
  "market_ids": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Polymarket slugs or ids referenced in this response"
  },
  "paragraphs": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "source_url": {
   "type": "string"
  },
  "word_count": {
   "type": "integer"
  },
  "description": {
   "type": "string"
  },
  "read_minutes": {
   "type": "integer"
  },
  "next_best_action": {
   "type": "object",
   "properties": {
    "why": {
     "type": "string"
    },
    "endpoint": {
     "type": "string"
    },
    "price_usd": {
     "type": "number"
    },
    "product_id": {
     "type": "string"
    }
   }
  }
 },
 "description": "HTML/URL -> structured fields (title/headings/links/paras)."
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "as_of",
  "title"
 ],
 "properties": {
  "as_of": {
   "type": "string",
   "format": "date-time",
   "description": "RFC3339 timestamp"
  },
  "links": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "href",
     "text"
    ],
    "properties": {
     "rel": {
      "type": "string"
     },
     "href": {
      "type": "string"
     },
     "text": {
      "type": "string"
     }
    }
   }
  },
  "risks": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "title": {
   "type": "string"
  },
  "images": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "src"
    ],
    "properties": {
     "alt": {
      "type": "string"
     },
     "src": {
      "type": "string"
     }
    }
   }
  },
  "favicon": {
   "type": "string"
  },
  "product": {
   "type": "string"
  },
  "evidence": {
   "type": "array",
   "items": {
    "type": "string",
    "format": "uri"
   },
   "description": "Polymarket order book / event / reference URLs"
  },
  "headings": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "level",
     "text"
    ],
    "properties": {
     "text": {
      "type": "string"
     },
     "level": {
      "type": "integer"
     }
    }
   }
  },
  "language": {
   "type": "string"
  },
  "og_image": {
   "type": "string"
  },
  "canonical": {
   "type": "string"
  },
  "confidence": {
   "type": "number",
   "maximum": 1,
   "minimum": 0,
   "description": "Model confidence 0.0-1.0"
  },
  "market_ids": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Polymarket slugs or ids referenced in this response"
  },
  "paragraphs": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "source_url": {
   "type": "string"
  },
  "word_count": {
   "type": "integer"
  },
  "description": {
   "type": "string"
  },
  "read_minutes": {
   "type": "integer"
  },
  "next_best_action": {
   "type": "object",
   "properties": {
    "why": {
     "type": "string"
    },
    "endpoint": {
     "type": "string"
    },
    "price_usd": {
     "type": "number"
    },
    "product_id": {
     "type": "string"
    }
   }
  }
 },
 "description": "HTML/URL -> structured fields (title/headings/links/paras)."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hars-zero-signal-api-html-extraction-endpoint-ad026708/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hars.cryptotavern.xyz](https://www.zero.xyz/host/hars.cryptotavern.xyz/llms.txt)
