# OpenVerbs Web Unfurl – Link Preview Metadata Extractor

> OpenVerbs Web Unfurl – Link Preview Metadata Extractor is a paid API for AI agents from web.openverbs.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-14).

Fetches a public URL and returns Open Graph, Twitter Card, and standard meta tag preview metadata (title, description, image, etc.)

## Facts

- Endpoint: POST https://web.openverbs.com/v1/unfurl
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/openverbs-web-unfurl-link-preview-metadata-extractor-0d6d1c25
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9-BsKn7-AYB9w9YAs7-ar

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 openverbs-web-unfurl-link-preview-metadata-extractor-0d6d1c25 -d '<json body>'
```

Example prompt: Can you unfurl this URL and give me the Open Graph title, description, and preview image — https://www.nytimes.com/2024/01/15/technology/ai-agents.html?

## When to prefer this

Use this endpoint when you need quick, structured link-preview metadata (title, description, image) from a public URL for display or enrichment purposes — without needing full page content or structured schema.org data. Prefer it over full scraping when only social-sharing metadata is needed. Choose sibling endpoints on web.openverbs.com if you need the full article text or JSON-LD structured data instead.

## Known failure modes

- Private, loopback, or link-local IP addresses are rejected with an error
- URLs that return non-200 HTTP status codes may yield partial or empty metadata
- Pages with no Open Graph or meta tags return minimal metadata
- Paywalled or bot-blocked pages may not return complete metadata
- Malformed or non-URI input triggers a validation error

## How this service works

Fetch a URL and return link-preview metadata from Open Graph, Twitter Card and standard meta tags.

## Output

Returns structured link-preview metadata extracted from Open Graph, Twitter Card, and standard HTML meta tags for the provided URL — including fields like title, description, image URL, site name, and canonical URL where available.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "format": "uri",
       "maxLength": 2048,
       "description": "Public http(s) URL to fetch. Private/loopback/link-local addresses are rejected."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/openverbs-web-unfurl-link-preview-metadata-extractor-0d6d1c25/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from web.openverbs.com](https://www.zero.xyz/host/web.openverbs.com/llms.txt)