# FastX402 Link Preview

> FastX402 Link Preview is a paid API for AI agents from fastx402.tools, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-27).

Fetches Open Graph, Twitter Card, and metadata for any public URL and returns a structured link preview object

## Facts

- Endpoint: GET https://fastx402.tools/link-preview?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fastx402-link-preview-40c577c7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UNapPZIG5s81uV_BP-CUw

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 fastx402-link-preview-40c577c7
```

Example prompt: Can you fetch a link preview for https://github.com/ — I want the title, description, og:image, and site name?

## When to prefer this

Use this endpoint when you need structured Open Graph and Twitter Card metadata for a given URL without setting up your own scraping infrastructure or managing API keys. It is ideal for link enrichment pipelines, social sharing previews, reading list apps, or any workflow where you need a page's title, image, description, and canonical metadata on demand. Prefer it over raw HTTP fetching when you want normalized, pre-parsed metadata rather than raw HTML.

## Known failure modes

- URL is not publicly accessible or behind authentication — returns non-200 status
- Invalid or malformed URL provided — request fails validation
- URL times out or is unreachable — upstream fetch error
- Page has no Open Graph or meta tags — fields return null or empty
- Private/localhost URLs rejected — only public http/https accepted

## How this service works

200 pay-per-call tools for AI agents, from $0.001 per request in USDC on Base or Solana with x402. No account, no API key.

## Output

A JSON object containing structured link preview data: the page title, description, og:image URL and alt text, favicon URL, site name, canonical URL, final resolved URL, Open Graph properties (url, type, title, site_name), Twitter Card type and site handle, language code, theme color, HTTP status, content type, and whether the URL redirected.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "Public http(s) URL or bare domain"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "url": {
       "type": "string"
      },
      "lang": {
       "type": "string"
      },
      "type": {
       "type": "string"
      },
      "image": {
       "type": "string"
      },
      "title": {
       "type": "string"
      },
      "author": {
       "type": "null"
      },
      "status": {
       "type": "integer"
      },
      "favicon": {
       "type": "string"
      },
      "finalUrl": {
       "type": "string"
      },
      "imageAlt": {
       "type": "string"
      },
      "siteName": {
       "type": "string"
      },
      "canonical": {
       "type": "string"
      },
      "openGraph": {
       "type": "object",
       "properties": {
        "url": {
         "type": "string"
        },
        "type": {
         "type": "string"
        },
        "title": {
         "type": "string"
        },
        "site_name": {
         "type": "string"
        }
       }
      },
      "redirected": {
       "type": "boolean"
      },
      "themeColor": {
       "type": "string"
      },
      "contentType": {
       "type": "string"
      },
      "description": {
       "type": "string"
      },
      "twitterCard": {
       "type": "string"
      },
      "twitterSite": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://github.com/",
  "lang": "en",
  "type": "object",
  "image": "https://images.ctfassets.net/8aevphvgewt8/4pe4eOtUJ0ARpZRE4fNekf/f52b1f9c52f059a33170229883731ed0/GH-Homepage-Universe-img.png",
  "title": "GitHub · Change is constant. GitHub keeps you ahead. · GitHub",
  "author": null,
  "status": 200,
  "favicon": "https://github.githubassets.com/favicons/favicon.png",
  "finalUrl": "https://github.com/",
  "imageAlt": "Join the world's most widely adopted, AI-powered developer platform ...",
  "siteName": "GitHub",
  "canonical": "https://github.com/",
  "openGraph": {
   "url": "https://github.com/",
   "type": "object",
   "title": "GitHub · Change is constant. GitHub keeps you ahead. · GitHub",
   "site_name": "GitHub"
  },
  "redirected": false,
  "themeColor": "#1e2327",
  "contentType": "text/html",
  "description": "Join the world's most widely adopted, AI-powered developer platform where millions of developers, businesses, and the largest open source community build software that advances humanity.",
  "twitterCard": "summary_large_image",
  "twitterSite": "@github"
 }
}
```

## More

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