{"uid":"cap_4-6uumE541JBB2X-G7n5r","slug":"link-preview-cache-api-bd093387","name":"Link Preview Cache API","description":"Fetch Open Graph / meta metadata (title, description, image, favicon, canonical URL) for a public URL - served from a shared cache when available, which is what keeps the price below a fresh-fetch-every-time service. Response includes a 'cached' field.","url":"https://link-preview-cache-api.onrender.com/preview","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Public http(s) URL to fetch Open Graph / meta metadata for."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"url":"https://example.com/blog/hello-world","image":"https://example.com/og-image.png","title":"Hello World","cached":true,"favicon":"https://example.com/favicon.ico","final_url":"https://example.com/blog/hello-world","site_name":"Example","description":"A short description of the page, from its meta tags.","content_type":"text/html; charset=utf-8","canonical_url":"https://example.com/blog/hello-world"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_uKT7ap7zymOuuzy_qmwYL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches Open Graph and meta tag metadata (title, description, image, favicon, canonical URL) for any public URL, served from a shared cache for cost efficiency.","exampleAgentPrompt":"Can you grab the Open Graph preview metadata — title, description, image, and favicon — for https://openai.com/blog/chatgpt? I want to build a link card and I need to know if it's served from cache.","exampleUseCases":[{"title":"Link card generation in chat app","prompt":"I'm building a messaging app and want to show a rich link preview when someone pastes a URL. Can you fetch the title, description, og:image, and favicon for https://vercel.com/blog/turborepo-3-0 so I can render a preview card?"},{"title":"Social post enrichment pipeline","prompt":"We're logging shared URLs in our social feed. For each link, I need the site name, canonical URL, and Open Graph image from https://stripe.com/blog/stablecoin-financial-infrastructure — pull it from cache if it's available to keep costs down."},{"title":"Content aggregator metadata lookup","prompt":"I'm building a newsletter aggregator and need to display rich previews. Fetch the Open Graph metadata for https://www.theverge.com/2024/1/1/example-article — I need the title, description, image, and whether it came from cache."}],"resultDescription":"A JSON object containing the page title, description, Open Graph image URL, favicon URL, canonical URL, final redirected URL, site name, content type, and a boolean 'cached' field indicating whether the result was served from the shared cache.","failureModes":["URL is not publicly accessible (private or behind auth) — returns error or empty fields","URL returns non-HTML content type with no meta tags — limited or empty metadata","URL redirects to a login wall — metadata reflects the login page, not the target","Malformed or non-URI input — request validation error","Cache miss on first fetch may result in slightly slower response"],"whenToPreferThis":"Choose this endpoint when you need fast, cheap Open Graph / meta tag extraction for public URLs and can tolerate cached results. It is ideal for link preview cards, content enrichment pipelines, and social sharing previews where fresh-every-time fetching is unnecessary. Prefer alternatives if you need guaranteed real-time freshness on every call or if the target URL requires authentication.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:31:35.068Z","isFirstParty":false}