# HTML Entity Decoder

> HTML Entity Decoder is a paid API for AI agents from html.openverbs.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Decodes HTML entities (named, decimal, and hex numeric references) back into plain text characters

## Facts

- Endpoint: POST https://html.openverbs.com/v1/decode
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/html-entity-decoder-98502347
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IZOBIOUA5lRfflUlr3dZE

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 html-entity-decoder-98502347 -d '<json body>'
```

Example prompt: Decode these HTML entities back into plain readable text: 'Caf&eacute; &amp; Bistro &mdash; &#x00A9; 2024 &lt;All Rights Reserved&gt;'

## When to prefer this

Choose this endpoint when you need to decode HTML entities from scraped web content, API responses, or stored data back into readable Unicode text. Prefer it over manual regex-based decoding for reliability across all entity types (named, decimal, hex). It complements the sibling encode endpoint on the same platform when you need round-trip HTML entity handling.

## Known failure modes

- Input text exceeds 200,000 character limit — request rejected
- Malformed or unclosed entity references may be passed through as-is or partially decoded
- Empty input string returns empty string
- Invalid JSON body returns 400 error
- Payment failure or missing x402 payment header returns 402 error

## How this service works

Decode HTML entities (named, decimal and hex numeric references) back into plain text.

## Output

Returns the input string with all HTML entities (named like &amp;, decimal like &#169;, and hexadecimal like &#xA9;) replaced by their corresponding plain Unicode characters, producing clean, human-readable text.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "html"
     ],
     "properties": {
      "html": {
       "type": "string",
       "maxLength": 200000,
       "description": "Text containing HTML entities."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/html-entity-decoder-98502347/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from html.openverbs.com](https://www.zero.xyz/host/html.openverbs.com/llms.txt)