# Minifetch Proxy Render URL Preview Extractor

> Minifetch Proxy Render URL Preview Extractor is a paid API for AI agents from minifetch.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-14).

Fetches JavaScript-rendered or bot-blocking pages via an external rotating proxy with headless browser rendering, then extracts Open Graph, Twitter Card, title, description, and favicon share-preview fields.

## Facts

- Endpoint: GET https://minifetch.com/api/v1/x402/proxy/render/extract/url-preview?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/minifetch-proxy-render-url-preview-extractor-bb42b775
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2-s8oYHEUeFPvImpIkHBH

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-proxy-render-url-preview-extractor-bb42b775
```

Example prompt: Can you grab the Open Graph title, description, og:image, and favicon from https://example.com even if it blocks bots or requires JavaScript to render — fetch it from a German IP if possible.

## When to prefer this

Use this endpoint when the target page uses JavaScript rendering (React, Vue, Next.js, etc.) so metadata isn't in the raw HTML, or when the page actively blocks standard crawlers and robots.txt-respecting proxies. Prefer this over the standard /extract/url-preview when you need metadata from SPAs, bot-protected pages, or when geo-specific fetching is required. Choose this over simpler extraction endpoints when you know the page requires JS execution to populate meta tags.

## Known failure modes

- Invalid or unreachable URL returns an error response
- Invalid 2-letter country code returns HTTP 400
- Page may still block even with proxy if anti-bot measures are sophisticated
- JS rendering may time out on very slow or complex single-page applications
- Some paywalled or login-gated pages return incomplete metadata
- Payment failure or insufficient USDC balance blocks the request

## How this service works

For JavaScript-rendered pages & pages blocking native Minifetch that obeys robots.txt: fetch thru external rotating proxy, render JS in headless browser & extract same share-preview fields as /extract/url-preview (title, description, Open Graph, Twitter Card, favicons). Optional ?country= (2-letter code) to fetch from a specific country. Not cached. Does not obey robots.txt. Supports GET & POST

## Output

Returns a results array containing extracted share-preview fields: final URL after redirects, page title, meta description, og:url, og:type, og:title, og:description, og:image, og:site_name, twitter:card, twitter:title, twitter:image, an array of favicon entries, plus proxy provenance metadata (whether JS was rendered, which country was used, provider, whether robots.txt was checked). Cache is always a miss on this route.

## 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 target URL from which to extract the preview."
      },
      "country": {
       "type": "string",
       "description": "Optional. 2-letter ISO 3166-1 country code (ex: de, mx) to fetch from. Invalid code returns 400."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "results": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "data": {
          "type": "object",
          "properties": {
           "url": {
            "type": "string",
            "description": "Final URL after redirects"
           },
           "proxy": {
            "type": "object",
            "properties": {
             "render": {
              "type": "boolean",
              "description": "true if JS executed"
             },
             "country": {
              "type": [
               "string",
               "null"
              ]
             },
             "provider": {
              "type": "string"
             },
             "proxyUrl": {
              "type": [
               "string",
               "null"
              ]
             },
             "proxyType": {
              "type": "string",
              "description": "Always \"managed\" on proxy routes"
             },
             "robotsTxt": {
              "type": "object",
              "properties": {
               "allowed": {
                "type": [
                 "boolean",
                 "null"
                ]
               }
              }
             },
             "userAgent": {
              "type": "string"
             }
            },
            "description": "Fetch provenance. External proxy routes do not check robots.txt"
           },
           "title": {
            "t
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/minifetch-proxy-render-url-preview-extractor-bb42b775/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)