# MiniFetch URL Preview Extractor

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

Fetches a lightweight, token-efficient preview of a URL, returning its title, description, and image metadata

## Facts

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

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 www-minifetch-com-2e4c5f72
```

Example prompt: Can you grab a quick preview of https://www.nytimes.com — just the title, description, and thumbnail image?

## When to prefer this

Choose this endpoint when you need only lightweight URL metadata (title, description, image) and want to minimize token usage. Ideal for generating link previews, enriching URLs in a feed, or quickly identifying what a page is about without fetching or parsing the full HTML. Prefer over full-scraping endpoints when token efficiency matters and rich structured content is not required.

## Known failure modes

- URL is unreachable or returns a non-200 status — likely returns success: false
- URL has no meta tags or open graph data — returns empty title/description/image fields
- Malformed or invalid URL input — may return an error response
- Page requires JavaScript rendering — static metadata may be missing
- Payment not fulfilled (x402) — returns 402 Payment Required before processing

## How this service works

For checking how your page unfurls when shared: Extracts the title, meta description, and preview image (only) - the lightweight card social platforms and chat apps render for a link

## Output

Returns an array of preview objects containing the request URL, the final resolved URL (after redirects), the page title, meta description, and a preview image URL, along with a boolean success flag — all in a minimal, token-efficient format.

## Example request

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

## 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": "The URL from which to extract the preview."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "results": {
       "type": "array",
       "description": "Array of preview objects with requestUrl, final url, title, description, and image. Lightweight metadata extraction for token efficiency"
      },
      "success": {
       "type": "boolean"
      }
     }
    }
   }
  }
 }
}
```

## More

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