# HTML Metadata Extractor

> HTML Metadata Extractor is a paid API for AI agents from x402-gateway-production-1f21.up.railway.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-12).

Extracts metadata (title, description, Open Graph tags, structured data, etc.) from a raw HTML string

## Facts

- Endpoint: POST https://x402-gateway-production-1f21.up.railway.app/html/meta?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/html-metadata-extractor-bba2c84f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mqbxRpPQV-EKDc3lXEyER

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-metadata-extractor-bba2c84f -d '<json body>'
```

Example prompt: Extract the metadata from this HTML I just fetched — I need the title, description, Open Graph tags, and any structured data you can find in it.

## When to prefer this

Use this endpoint when you have already fetched raw HTML and need to extract its metadata fields efficiently without re-fetching the URL. Ideal for pipelines that scrape pages first and then process metadata separately, or when working with HTML from sources that require authentication or custom fetch logic. Prefer this over full-page fetch endpoints when you already hold the HTML content.

## Known failure modes

- Missing or malformed HTML input returns an error
- HTML exceeding 500,000 character limit is rejected
- No metadata present in the HTML yields empty fields
- Invalid base_url format causes URL resolution errors
- Malformed HTML that cannot be parsed may return partial or empty results

## How this service works

Machine-payable x402 utilities for hashing, Base64, UUID generation, unit and timezone conversion, realtime crypto market data, webpage/document extraction, URL-to-Markdown, metadata, RAG ingestion and deterministic website change detection.

## Output

A JSON object containing extracted metadata fields from the HTML, such as page title, meta description, Open Graph properties (og:title, og:description, og:image, etc.), Twitter card tags, canonical URL, and any other structured metadata found in the HTML head section.

## 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": 500000
      },
      "base_url": {
       "type": "string",
       "maxLength": 8192
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "ready"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/html-metadata-extractor-bba2c84f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-gateway-production-1f21.up.railway.app](https://www.zero.xyz/host/x402-gateway-production-1f21.up.railway.app/llms.txt)