# Machine Shop – HTML Metadata Extractor

> Machine Shop – HTML Metadata Extractor is a paid API for AI agents from api.pay-forge.online, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-20).

Extracts structured metadata (title, description, language, canonical URL, meta tags) from a supplied HTML document string.

## Facts

- Endpoint: POST https://api.pay-forge.online/v1/html-metadata?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/machine-shop-html-metadata-extractor-a6548d4b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WheqzkUsHPHvEfN6oMCao

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 machine-shop-html-metadata-extractor-a6548d4b -d '<json body>'
```

Example prompt: I've got the raw HTML source of a webpage — can you pull out the title, meta description, canonical URL, and language from it? Here's the HTML: <html>...</html>

## When to prefer this

Choose this endpoint when you already have raw HTML content in memory and need structured metadata fields extracted without making a live web request. Ideal for offline document pipelines, post-crawl processing, SEO audits, and deduplication workflows where a live fetch is not needed or not possible.

## Known failure modes

- HTML exceeds 50,000 character limit — request rejected
- Malformed or empty HTML produces empty/null metadata fields
- Missing base_url may cause relative canonical URLs to be unresolved
- Non-HTML content (e.g. plain text or JSON) yields empty metadata
- Network or payment errors return a non-200 status with no metadata

## How this service works

Turn Apify product scrape results into safe catalog updates with Catalog Update Gate. Find evidence in supplied documents, compare snapshots, extract typed JSON fields, inspect x402 quotes and assess API migrations. Preview inputs, evidence and cost for free. No live web search, scheduled monitoring or third-party purchasing.

## Output

Returns a JSON object with a 'metadata' key containing parsed fields: title, description, language, canonical URL, and a meta tags object extracted from the supplied HTML document.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "html": {
   "type": "string",
   "title": "Html",
   "maxLength": 50000
  },
  "base_url": {
   "type": "string",
   "title": "Base Url",
   "default": "",
   "maxLength": 2048
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "metadata": {
   "meta": {},
   "title": "Example",
   "language": "en",
   "canonical": "",
   "description": ""
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/machine-shop-html-metadata-extractor-a6548d4b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.pay-forge.online](https://www.zero.xyz/host/api.pay-forge.online/llms.txt)