{"uid":"cap_miqu6fXld3Fsu8-SFJQWv","slug":"url-unfurl-link-preview-metadata-api-708eae1f","name":"URL Unfurl / Link Preview Metadata API","description":"Link preview / URL metadata for AI agents — give a URL, get back the structured card: title, description, hero image, site name, canonical URL, favicon, and type (OpenGraph → Twitter Card → standard meta). Pay-per-call in USDC via x402 — no signup, no API key. Use to unfurl links, render previews, and enrich URLs without downloading the whole page.","url":"https://api-production-17e1.up.railway.app/unfurl","method":"GET","headers":{},"bodySchema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"The page URL to unfurl."}}},"responseSchema":{"type":"object","required":["url","type","image","title","favicon","canonical","site_name","description"],"properties":{"url":{"type":"string"},"type":{"type":"string"},"image":{"type":"string"},"title":{"type":"string"},"favicon":{"type":"string"},"canonical":{"type":"string"},"site_name":{"type":"string"},"description":{"type":"string"}}},"example":{"request":{"url":"https://www.wikipedia.org"},"response":{"url":"https://www.wikipedia.org/","type":"website","image":"https://upload.wikimedia.org/wikipedia/en/thumb/8/80/Wikipedia-logo-v2.svg/250px-Wikipedia-logo-v2.svg.png","title":"Wikipedia, the free encyclopedia","favicon":"https://www.wikipedia.org/static/favicon/wikipedia.ico","canonical":"https://www.wikipedia.org/","site_name":"www.wikipedia.org","description":"Wikipedia is a free online encyclopedia, created and edited by volunteers around the world and hosted by the Wikimedia Foundation."}},"exampleRequest":{"url":"https://www.wikipedia.org"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kGh_XcAd5taCHe56yZl2e","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches structured link preview metadata (title, description, hero image, site name, canonical URL, favicon, type) from any URL via OpenGraph, Twitter Card, or standard meta tags","exampleAgentPrompt":"Can you unfurl this link for me and show me the preview card — title, description, hero image, and site name — for https://www.theverge.com/2024/1/10/24032830/ces-2024-best-tech?","exampleUseCases":[{"title":"Enrich newsletter links with previews","prompt":"I'm putting together a newsletter and have a list of article URLs I want to include — can you fetch the title, description, and hero image for each one so I can build nice preview cards without having to visit every page manually?"},{"title":"Populate database with link metadata","prompt":"I have a bunch of bookmarked URLs I've been saving and I want to enrich them in my database — can you pull the structured metadata for https://www.wired.com/story/chatgpt-plugins-openai/ so I get the title, site name, description, and favicon to store alongside the link?"},{"title":"Slack-style link unfurling in chat","prompt":"Someone just shared https://techcrunch.com/2024/05/10/openai-gpt-4o-announced/ in our team chat and I want to show a rich preview like Slack does — can you unfurl that URL and give me the title, description, hero image, and site name?"}],"resultDescription":"Returns a structured metadata card containing: page title, description, hero/OG image URL, site name, canonical URL, favicon URL, and content type — sourced from OpenGraph tags first, then Twitter Card tags, then standard HTML meta tags as fallback","failureModes":["URL is unreachable or returns non-200 status — metadata may be empty or partial","Page has no OpenGraph/Twitter Card/meta tags — minimal or no structured data returned","URL points to a non-HTML resource (PDF, image) — metadata extraction may fail","Paywalled or bot-protected pages may block the fetch","Rate limiting or network timeout if target site is slow"],"whenToPreferThis":"Use this endpoint when you need to enrich a URL with structured preview metadata (title, image, description) without fully downloading and parsing a web page yourself — ideal for rendering link previews, building content cards, or populating link fields in databases. Prefer this over a full web scraper when you only need OG/meta metadata, not full page text.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-08-24T04:31:46.391Z","isFirstParty":false}