# URL Unfurl / Link Preview Metadata API

> URL Unfurl / Link Preview Metadata API is a paid API for AI agents from api-production-17e1.up.railway.app, paid per call via x402, $0.001/call, status down (last checked 2026-08-24).

Fetches structured link preview metadata (title, description, hero image, site name, canonical URL, favicon, type) from any URL via OpenGraph, Twitter Card, or standard meta tags

## Facts

- Endpoint: GET https://api-production-17e1.up.railway.app/unfurl
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-08-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/url-unfurl-link-preview-metadata-api-708eae1f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_miqu6fXld3Fsu8-SFJQWv

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-unfurl-link-preview-metadata-api-708eae1f
```

Example prompt: Can you unfurl this link for me and show me the preview card — title, description, hero image, and site name — for https://www.theverge.com/2024/1/10/24032830/ces-2024-best-tech?

## When to prefer this

Use this endpoint when you need to enrich a URL with structured preview metadata (title, image, description) without fully downloading and parsing a web page yourself — ideal for rendering link previews, building content cards, or populating link fields in databases. Prefer this over a full web scraper when you only need OG/meta metadata, not full page text.

## Known failure modes

- URL is unreachable or returns non-200 status — metadata may be empty or partial
- Page has no OpenGraph/Twitter Card/meta tags — minimal or no structured data returned
- URL points to a non-HTML resource (PDF, image) — metadata extraction may fail
- Paywalled or bot-protected pages may block the fetch
- Rate limiting or network timeout if target site is slow

## How this service works

Link preview / URL metadata for AI agents — give a URL, get back the structured card: title, description, hero image, site name, canonical URL, favicon, and type (OpenGraph → Twitter Card → standard meta). Pay-per-call in USDC via x402 — no signup, no API key. Use to unfurl links, render previews, and enrich URLs without downloading the whole page.

## Output

Returns a structured metadata card containing: page title, description, hero/OG image URL, site name, canonical URL, favicon URL, and content type — sourced from OpenGraph tags first, then Twitter Card tags, then standard HTML meta tags as fallback

## Example request

```json
{
 "url": "https://www.wikipedia.org"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string",
   "description": "The page URL to unfurl."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url",
  "type",
  "image",
  "title",
  "favicon",
  "canonical",
  "site_name",
  "description"
 ],
 "properties": {
  "url": {
   "type": "string"
  },
  "type": {
   "type": "string"
  },
  "image": {
   "type": "string"
  },
  "title": {
   "type": "string"
  },
  "favicon": {
   "type": "string"
  },
  "canonical": {
   "type": "string"
  },
  "site_name": {
   "type": "string"
  },
  "description": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/url-unfurl-link-preview-metadata-api-708eae1f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api-production-17e1.up.railway.app](https://www.zero.xyz/host/api-production-17e1.up.railway.app/llms.txt)