# Minifetch URL Preview Extractor

> Minifetch URL Preview Extractor is a paid API for AI agents from minifetch.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Extracts a lightweight, token-efficient URL preview consisting of title, description, and image only

## Facts

- Endpoint: GET https://minifetch.com/api/v1/x402/extract/url-preview
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/minifetch-com-0c79f878
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ip9Aq9FsGrZHPjxKfnB3v

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 minifetch-com-0c79f878
```

Example prompt: Can you grab a quick preview of https://techcrunch.com/2024/01/15/openai-raises-new-funding — just the title, description, and image?

## When to prefer this

Choose this endpoint when you only need the minimal preview metadata (title, description, image) from a URL and want to minimize token usage and cost. Prefer it over the richer structured metadata endpoint when you don't need og/twitter tags, json-ld, or full link lists. Ideal for generating link previews, enriching shared URLs, or quickly identifying page content without downloading full HTML.

## Known failure modes

- URL is unreachable or returns a non-200 status — results may be empty or partial
- URL has no meta description or og:image tags — corresponding fields will be null or missing
- Payment failure or insufficient USDC balance — 402 response before extraction occurs
- Malformed or missing url query parameter — request rejected with validation error
- URL redirects to paywalled or bot-blocked content — title may be extracted but description/image may be missing

## How this service works

Extracts all fields used for a page's share previews: the lightweight cards that represent the page on social platforms, chat apps, and AI. Supports GET & POST

## Output

Returns a JSON object with a results array containing one preview object per URL, including the original request URL, the final resolved URL (after redirects), the page title, meta description, and a preview image URL. Also includes a success boolean.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "url": "https://www.wikipedia.org/wiki/Artificial_intelligence"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string",
   "description": "The URL from which to extract the preview."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "results": {
   "type": "array",
   "description": "Metadata objects with requestUrl, url (final after redirects), title, description, and image fields (structured JSON)"
  },
  "success": {
   "type": "boolean"
  },
  "queryParameters": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/minifetch-com-0c79f878/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from minifetch.com](https://www.zero.xyz/host/minifetch.com/llms.txt)