# URL Metadata & Link Preview

> URL Metadata & Link Preview is a paid API for AI agents from bess-x402.onrender.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-30).

Fetches link-preview metadata (title, description, Open Graph image, Twitter card, favicon, canonical URL, publish date, RSS feeds, etc.) for any web page URL.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/web/metadata?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/url-metadata-link-preview-0b518630
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RwxVayzd_I_jUxMfek8IN

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-metadata-link-preview-0b518630
```

Example prompt: Can you pull the link preview metadata for https://www.theverge.com/2024/1/1/example-article — I need the title, description, Open Graph image, author, and publish date so I can add it to my bookmark collection.

## When to prefer this

Choose this endpoint when you need fast, structured link-preview metadata (OG tags, title, description, image, favicon, RSS) for a single URL without downloading or parsing the full page content yourself. Ideal for building bookmark enrichment pipelines, social share preview validation, or URL classification workflows. Prefer this over a general web scraper when you specifically need social/meta tag data rather than full page text.

## Known failure modes

- URL is unreachable or returns a non-200 status — metadata may be empty or partial
- Page blocks crawlers (robots.txt or bot detection) — returns limited or no metadata
- Page has no Open Graph or meta tags — title and description may be missing
- Paywalled content may return only preview metadata
- Invalid or malformed URL input causes request failure
- Slow-loading pages may time out before metadata is fully extracted

## How this service works

Link-preview metadata of a web page: title, description, Open Graph and Twitter card image, site name, author, publish date, language, canonical URL, favicon and RSS feeds. Use to build link previews, enrich bookmarks or classify a URL without reading the full page.

## Output

Returns structured metadata for the given URL including: page title, meta description, Open Graph image URL, Twitter card image, site name, author name, publish date, detected language, canonical URL, favicon URL, and any RSS feed URLs found on the page.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "Page URL"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/url-metadata-link-preview-0b518630/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bess-x402.onrender.com](https://www.zero.xyz/host/bess-x402.onrender.com/llms.txt)