{"uid":"cap_1HHodXqvgjbqA2EEIN-mh","slug":"minifetch-proxy-render-url-metadata-extractor-c59340d3","name":"Minifetch Proxy Render URL Metadata Extractor","description":"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","url":"https://minifetch.com/api/v1/x402/proxy/render/extract/url-metadata?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":"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":{"type":"string"},"author":{"type":"string"},"jsonld":{"type":"array","description":"Parsed JSON-LD blocks"},"og:url":{"type":"string","description":"Returns all og: tags, not just og:url"},"robots":{"type":"string"},"source":{"type":"string"},"charset":{"type":"string"},"creator":{"type":"string"},"imgTags":{"type":"array"},"favicons":{"type":"array","description":"Discovered icon entries"},"headings":{"type":"array"},"hreflang":{"type":"array","description":"hreflang and href"},"keywords":{"type":"string"},"referrer":{"type":"string"},"viewport":{"type":"string"},"canonical":{"type":"string"},"publisher":{"type":"string"},"requestUrl":{"type":"string","description":"URL as requested, before redirects"},"description":{"type":"string"},"twitter:url":{"type":"string","description":"Returns all twitter: tags, not just twitter:url"},"responseBody":{"type":"string","description":"Raw HTML; only when ?includeResponseBody=true"},"canonicalUrls":{"type":"array","items":{"type":"string"}},"product:brand":{"type":"string","description":"Returns all brand: tags, not just product:brand"},"minifetchCache":{"type":"object","properties":{"hit":{"type":"boolean"}},"description":"External proxy routes not cached: always { hit: false }"},"responseHeaders":{"type":"object","description":"Selected response headers"},"responseStatusCode":{"type":"integer"}},"description":"Default metadata: proxy & minifetchCache objects always returned, outside the ?fields= and ?omitEmpty= query param selections."}}}},"success":{"type":"boolean"},"queryParameters":{"type":"object"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9774BDR9V6bAfaVSfPCax","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.)","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Scrape SPA product page metadata","prompt":"Extract the page title, meta description, OG image, and JSON-LD structured data from https://shop.example.com/products/sneaker-x — it's a React app so you'll need to actually render the JavaScript to get the content."},{"title":"Bypass bot-blocking for SEO audit","prompt":"That site at https://protected-news.com/article/123 keeps blocking our normal fetcher — can you use a rotating proxy with a headless browser to pull all its metadata including canonical URL, Open Graph tags, and HTTP headers? Fetch it as if coming from Germany."},{"title":"Extract share-preview metadata from gated page","prompt":"I need the Open Graph title, description, and image URL from https://members.example.org/report/2024 — the page needs JavaScript to load and seems to block crawlers, so use a proxy and headless rendering to get through."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:42:20.860Z","isFirstParty":false,"canonicalSlug":"minifetch-proxy-render-url-metadata-extractor-c59340d3"}