# true402 Link Preview

> true402 Link Preview is a paid API for AI agents from true402.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-13).

Fetches a rich link preview (title, description, image, metadata) for a given URL via a pay-per-call HTTP 402 endpoint.

## Facts

- Endpoint: POST https://true402.dev/api/v1/link-preview
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/true402-link-preview-da5dc1b1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_w2gJdagIgpk6UvMYid4MK

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 true402-link-preview-da5dc1b1 -d '<json body>'
```

Example prompt: Can you fetch me a link preview for https://openai.com — I want the title, description, and any preview image so I can display a nice link card for it.

## When to prefer this

Use this endpoint when you need to quickly enrich a URL with human-readable preview metadata (title, description, image) without building your own scraper. Ideal for agents building link cards, summarizing shared URLs, or enriching content feeds. Prefer this over general-purpose web scrapers when only lightweight Open Graph/meta tag data is needed at a low per-call cost ($0.003 USDC).

## Known failure modes

- Invalid or malformed URL returns a validation error
- Target page is unreachable or returns a non-200 status — may return null fields or an error
- Page blocks scrapers via robots.txt or anti-bot measures — preview fields may be empty
- Payment not included or insufficient USDC — HTTP 402 response requiring payment
- Timeout if target page is slow to respond

## How this service works

The machine-native marketplace. Wallet = identity. Pay per call with HTTP 402.

## Output

Returns a JSON object containing extracted page metadata for the given URL, likely including the page title, description, Open Graph image URL, and other meta tags scraped from the HTML of the target page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string",
   "description": "The page URL (http/https)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ok": {
   "type": "boolean"
  },
  "url": {
   "type": "string"
  },
  "type": {
   "type": "string"
  },
  "image": {
   "type": "string"
  },
  "title": {
   "type": "string"
  },
  "favicon": {
   "type": "string"
  },
  "siteName": {
   "type": "string"
  },
  "canonical": {
   "type": "string"
  },
  "description": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/true402-link-preview-da5dc1b1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from true402.dev](https://www.zero.xyz/host/true402.dev/llms.txt)