{"uid":"cap_IRAlikaJ3nvlGun_mRDnp","slug":"minifetch-proxied-url-preview-extractor-9130eb48","name":"Minifetch Proxied URL Preview Extractor","description":"For pages blocking native Minifetch that obeys robots.txt: fetch thru external rotating proxy & extract same share-preview fields as /extract/url-preview (title, description, Open Graph, Twitter Card, favicons). No JavaScript rendering; use /proxy/render for that. 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/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.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6suYf2QXaQ6Oaeut4HK5L","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts share-preview metadata (title, description, Open Graph, Twitter Card, favicons) from URLs that block standard crawlers, using an external rotating proxy that bypasses robots.txt restrictions.","exampleAgentPrompt":"Grab the Open Graph title, description, and preview image from https://example.com — it blocks normal crawlers so use the rotating proxy to get through, and fetch from Germany.","exampleUseCases":[{"title":"Social card preview for blocked site","prompt":"Get the share preview metadata — title, og:image, and description — from https://linkedin.com/company/acme-corp; it normally blocks scrapers so you'll need to go through the proxy."},{"title":"Localized metadata audit","prompt":"Fetch the Open Graph tags and page title from https://shop.example.com using a proxy routed through Mexico, so I can see what the localized preview looks like there."},{"title":"Favicon and branding extraction","prompt":"I need the favicon URL and og:site_name from https://competitor.io — their site blocks bots, so use the external rotating proxy to get past it."}],"resultDescription":"Returns a results array where each item contains: resolved URL (after redirects), page title, meta description, Open Graph fields (og:title, og:description, og:image, og:url, og:type, og:site_name), Twitter Card fields (twitter:card, twitter:title, twitter:image), an array of discovered favicons, proxy provenance metadata (provider, country, userAgent, robotsTxt.allowed=null since robots.txt not checked), and cache status (always hit:false since this route is not cached).","failureModes":["Invalid or unreachable target URL returns an error","Invalid country code (not a 2-letter ISO 3166-1 code) returns HTTP 400","Target page may still block the rotating proxy despite bypass attempt, yielding empty or partial fields","No JavaScript rendering — dynamic pages will return pre-JS HTML metadata only; use /proxy/render for JS-rendered pages","Network timeouts from the external proxy if the target is very slow"],"whenToPreferThis":"Use this endpoint when the standard Minifetch proxy (which obeys robots.txt) gets blocked or returns incomplete data from a target URL. Prefer this over the standard /extract/url-preview when the site actively blocks crawlers or returns 403/empty to the native proxy. Use it over /proxy/render when the page does not require JavaScript execution (saving cost and latency). Use the optional country parameter when you need geographically localized metadata. Do not use this when robots.txt compliance is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:38:49.993Z","isFirstParty":false,"canonicalSlug":"minifetch-proxied-url-preview-extractor-9130eb48"}