# Readr OGPreview

> Readr OGPreview is a paid API for AI agents from failure.zo.space, paid per call via x402, $0.0003/call, status unknown (last checked 2026-10-28).

Fetches a URL and returns its Open Graph metadata, Twitter Card data, title, description, favicon, and canonical URL for rendering a rich link preview card.

## Facts

- Endpoint: GET https://failure.zo.space/api/x402/og?utm_source=zero.xyz
- Price: $0.0003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/readr-ogpreview-919437fd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ebKgGcczkmshWtPWKzX30

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 readr-ogpreview-919437fd
```

Example prompt: Can you fetch the link preview metadata for https://www.theverge.com/2024/1/1/example-article — I need the title, description, OG image, and favicon so I can render a rich preview card.

## When to prefer this

Choose this endpoint when you need to quickly render a rich link preview card (title, description, OG image, favicon) for any arbitrary URL without setting up your own scraping infrastructure. It is ideal for chat applications, bookmark managers, social post schedulers, or any product that needs to unfurl links into visual previews. At $0.0003 per call it is cost-effective for on-demand single-URL lookups.

## Known failure modes

- URL is unreachable or returns a non-200 status — metadata may be empty or partial
- Target page has no Open Graph tags — fields may be null or fall back to basic HTML meta
- URL parameter is missing — request rejected with an error
- Target site blocks bots/scrapers — returns empty or error response
- Malformed URL provided — parsing failure returned
- Very slow target sites may cause timeout errors

## How this service works

Link preview extractor: fetches any URL and returns its title, description, Open Graph and Twitter Card images, favicon, canonical URL and dominant meta tags — the data needed to render a rich preview card. Query params: url (required).

## Output

Returns structured metadata extracted from the target webpage including: page title, meta description, Open Graph title/description/image URL, Twitter Card image, favicon URL, canonical URL, and dominant meta tags — everything needed to render a rich link preview card.

## 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"
      }
     }
    }
   },
   "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/readr-ogpreview-919437fd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from failure.zo.space](https://www.zero.xyz/host/failure.zo.space/llms.txt)