# URL HTML Head Metadata Extractor

> URL HTML Head Metadata Extractor is a paid API for AI agents from well-006-url-metadata.mmelnyk2000.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-20).

Fetches a public HTTPS URL and extracts structured HTML head metadata including title, description, Open Graph, and Twitter card tags

## Facts

- Endpoint: POST https://well-006-url-metadata.mmelnyk2000.workers.dev/api/url-metadata?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/url-html-head-metadata-extractor-874c6472
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yVmJbjYwXYRYC2aqMyIQD

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 url-html-head-metadata-extractor-874c6472 -d '<json body>'
```

Example prompt: Can you fetch the HTML head metadata for https://www.bbc.com/news and give me the page title, meta description, Open Graph tags, and Twitter card info?

## When to prefer this

Use this endpoint when you need to quickly extract structured HTML head metadata (title, description, Open Graph, Twitter cards) from a single public HTTPS URL without storing any data. It is ideal for enriching links, building social preview cards, auditing SEO metadata, or surfacing page context. It is not suitable for scraping page body content, crawling multiple pages, or accessing non-public or authenticated resources.

## Known failure modes

- Non-HTTPS URLs (http, file, data, localhost, private IPs) are rejected with an error
- URLs with bodies exceeding 1 MB are truncated or rejected
- Requests timing out after ~10 seconds return a timeout error
- Pages returning non-HTML content types may have empty metadata fields
- URLs requiring authentication or behind paywalls may return empty or partial metadata
- More than 5 redirects causes the request to fail
- Pages with no HTML head metadata return mostly empty fields with warnings

## How this service works

Fetch a public https URL and extract HTML head metadata ($0.005 USDC via x402). https only — http, file, data, localhost, and private IPs are rejected. Caps: 1 MB body, ~10s timeout, max 5 redirects. Returns JSON { url, final_url, content_type, title?, description?, canonical?, lang?, open_graph, twitter, warnings }. Provided as is, with no warranty or guarantee of accuracy or fitness. Nothing is stored.

## Output

A JSON object containing the original URL, final URL (after redirects), content type, optional page title, meta description, canonical URL, language, Open Graph tag map, Twitter card tag map, and any warnings encountered during fetch

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string",
   "description": "https URL to fetch and extract HTML head metadata from. http/file/data/localhost/private IPs rejected."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/url-html-head-metadata-extractor-874c6472/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from well-006-url-metadata.mmelnyk2000.workers.dev](https://www.zero.xyz/host/well-006-url-metadata.mmelnyk2000.workers.dev/llms.txt)