# Lumen Agent Utilities – URL Unfurl

> Lumen Agent Utilities – URL Unfurl is a paid API for AI agents from lumenworks-x402-decoder.onrender.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-11).

Follows redirects on a URL and returns the final destination's HTTP status, page title, description, OpenGraph/Twitter metadata, favicon, canonical URL, language, and other rich link-preview data.

## Facts

- Endpoint: POST https://lumenworks-x402-decoder.onrender.com/v1/web/unfurl?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lumen-agent-utilities-url-unfurl-a9877433
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AKxaHChKxNQHkpXSJDkK9

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 lumen-agent-utilities-url-unfurl-a9877433 -d '<json body>'
```

Example prompt: Can you unfurl this URL for me — https://t.co/abc123 — and tell me what the final destination is, including the page title, description, and any OpenGraph image?

## When to prefer this

Use this endpoint when you need rich link-preview metadata (title, description, OG image, canonical, favicon) from a single URL, especially when the URL may involve redirects. Prefer this over a generic HTTP HEAD check when you need page content metadata, not just reachability. It is ideal for building link cards, validating URLs before display, resolving short links, or enriching content with page context.

## Known failure modes

- URL is unreachable or times out — HTTP status will reflect the error (e.g. 404, 503)
- Malformed or non-HTTP URL input — likely returns an error response
- Page has no OpenGraph/meta tags — relevant fields will be null or absent
- Paywalled or bot-blocked pages may return redirect loops or login-page metadata instead of target content
- x402 payment not included or invalid — returns 402 Payment Required before processing

## How this service works

Unfurl a URL: final URL after redirects, HTTP status, title, description, OpenGraph/Twitter image, site name, canonical, favicon, language, published time.

## Output

A JSON object containing: the final URL after all redirects, HTTP status code, page title, meta description, OpenGraph image URL, Twitter card type, site name, canonical URL, favicon URL, detected language, content type, and link count found on the page.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://github.com/",
  "lang": "en",
  "type": "object",
  "image": "https://images.ctfassets.net/8aevphvgewt8/4pe4eOtUJ0ARpZRE4fNekf/f52b1f9c52f059a33170229883731ed0/GH-Homepage-Universe-img.png",
  "title": "GitHub · Change is constant. GitHub keeps you ahead. · GitHub",
  "status": 200,
  "favicon": "https://github.githubassets.com/favicons/favicon.png",
  "siteName": "GitHub",
  "canonical": "https://github.com/",
  "linkCount": 140,
  "contentType": "text/html; charset=utf-8",
  "description": "Join the world's most widely adopted, AI-powered developer platform where millions of developers, businesses, and the largest open source community build software that advances humanity.",
  "twitterCard": "summary_large_image"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lumen-agent-utilities-url-unfurl-a9877433/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lumenworks-x402-decoder.onrender.com](https://www.zero.xyz/host/lumenworks-x402-decoder.onrender.com/llms.txt)