# Minifetch Proxy Render URL Metadata Extractor

> Minifetch Proxy Render URL Metadata Extractor is a paid API for AI agents from minifetch.com, paid per call via x402, $0.004/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 rich structured metadata (title, description, OG, JSON-LD, canonical, meta tags, favicons, headers, etc.)

## Facts

- Endpoint: GET https://minifetch.com/api/v1/x402/proxy/render/extract/url-metadata?utm_source=zero.xyz
- Price: $0.004/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-metadata-extractor-c59340d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1HHodXqvgjbqA2EEIN-mh

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-metadata-extractor-c59340d3
```

Example prompt: Can you pull the full structured metadata — title, description, OG tags, JSON-LD, and canonical URL — from https://example.com using a headless browser and rotating proxy in case the page blocks regular crawlers or needs JavaScript to render?

## When to prefer this

Use this endpoint when the target page requires JavaScript execution to render content (SPAs, React/Vue/Angular apps), when the standard Minifetch proxy is being blocked by the site's anti-bot measures, or when you need to fetch from a specific geographic location via country code. Prefer over the standard /extract/url-metadata endpoint specifically for JS-rendered pages and bot-protected sites. Not cached, so best for fresh real-time data needs.

## Known failure modes

- Invalid or unreachable target URL returns an error
- Unknown field name in ?fields= parameter returns 400
- Invalid 2-letter country code in ?country= returns 400
- Page may still block rendering despite proxy/headless browser (returns partial or empty metadata)
- JavaScript-heavy page may timeout during headless rendering
- Rate limits or payment failures (x402 micropayment) result in no response

## 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 rich structured metadata as /extract/url-metadata (headers, favicons, title, description, canonical, meta tags, OG, JSON-LD, etc). Optional ?country= (2-letter code). Same ?fields= and ?omitEmpty= params. Not cached. Supports GET & POST

## Output

A structured metadata object containing: final URL after redirects, page title, language, canonical URL, meta tags (including OG, Twitter Card, JSON-LD), favicons, HTTP response headers, proxy provenance details (render status, country, provider, robots.txt check, user agent), and optionally the full HTML response body. Response can be filtered to specific fields and empty values can be omitted.

## 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 metadata."
      },
      "fields": {
       "type": "string",
       "description": "Optional. Selection narrows response to only fields you need: comma-separated atomic field names (e.g. title, description), named groups (network, meta, og, twitter), and/or meta:tag-name for specific meta tag. Returns all fields when omitted; an unknown field returns 400."
      },
      "country": {
       "type": "string",
       "description": "Optional. 2-letter ISO 3166-1 country code (ex: de, mx) to fetch from. Invalid code returns 400."
      },
      "omitEmpty": {
       "type": "boolean",
       "description": "Optional. If true, drops empty fields (empty string, [], {}) from response."
      },
      "includeResponseBody": {
       "type": "boolean",
       "description": "Optional. If true, includes full HTML response body as string in result."
      }
     }
    }
   },
   "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"
           },
           "lang": {
            "type": "string"
           },
           "image": {
            "type": "string"
           },
           "proxy": {
            "type": "object",
            "properties": {
             "render": {
              "type": "boolean",
              "description": "true if JS executed"
             },
             "country": {
              "type": [
               "string",
               "null"
              ]
             },
             "provider": {
              "type
… (truncated)
```

## More

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