{"uid":"cap_2-s8oYHEUeFPvImpIkHBH","slug":"minifetch-proxy-render-url-preview-extractor-bb42b775","name":"Minifetch Proxy Render URL Preview 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 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","url":"https://minifetch.com/api/v1/x402/proxy/render/extract/url-preview?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 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":{"type":"string"},"og:url":{"type":"string"},"og:type":{"type":"string"},"favicons":{"type":"array","description":"Discovered icon entries"},"og:image":{"type":"string"},"og:title":{"type":"string"},"requestUrl":{"type":"string","description":"URL as requested, before redirects"},"description":{"type":"string"},"og:site_name":{"type":"string"},"twitter:card":{"type":"string"},"twitter:image":{"type":"string"},"twitter:title":{"type":"string"},"minifetchCache":{"type":"object","properties":{"hit":{"type":"boolean"}},"description":"External proxy routes not cached: always { hit: false }"},"og:description":{"type":"string"}},"description":"Preview object returned."}}}},"success":{"type":"boolean"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-Aek5mTzYOrEha2waNpz4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","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 Open Graph, Twitter Card, title, description, and favicon share-preview fields.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Social preview card for JS-heavy site","prompt":"Pull the og:title, og:description, og:image, and Twitter Card fields from https://vercel.com — it's a React site so you'll need to render JavaScript to get the real metadata."},{"title":"Geo-specific metadata fetch for localization audit","prompt":"Fetch the Open Graph and meta description fields from https://booking.com using a Mexican IP address so I can see what metadata they serve to visitors from Mexico."},{"title":"Share preview from bot-blocking competitor page","prompt":"Extract the page title, description, og:image, and favicon from https://notion.so — they block regular crawlers, so use a rotating proxy and render the JavaScript."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:40:47.750Z","isFirstParty":false,"canonicalSlug":"minifetch-proxy-render-url-preview-extractor-bb42b775"}