{"tool":"unfurl","title":"Link Unfurl","what":"Link preview of any URL in one call: title, description, site name, canonical URL, Open Graph and Twitter card fields, preview image, favicon, theme color, oEmbed endpoint and JSON-LD types. Use it to render rich links or to check how a page will look when shared.","endpoint":"https://yruz.one/api/unfurl","methods":["GET with query parameters","POST with a JSON body (same fields)"],"price":{"model":"fixed","usdc":"0.003"},"params":[{"name":"url","required":true,"description":"page URL","example":"https://yruz.one/"}],"valid_request":{"get":"https://yruz.one/api/unfurl?url=https%3A%2F%2Fyruz.one%2F","post":{"url":"https://yruz.one/api/unfurl","body":{"url":"https://yruz.one/"}}},"how_to_pay":["1. Send the request without payment: the answer is HTTP 402 with the exact price (x402 v2 in the PAYMENT-REQUIRED header, x402 v1 in the JSON body).","2. Sign one offer of \"accepts\" with an x402 client (USDC on Base eip155:8453 or on Solana mainnet; the facilitator pays the network fee).","3. Resend the identical request (same method, parameters and body) with PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1).","4. The answer carries the receipt in PAYMENT-RESPONSE. Any changed parameter needs a new 402."],"response_shape":{"product":"string","result":{"url":"string","final_url":"string","status":"number","title":"string","description":"string","site_name":"string","type":"string","canonical":"string","image":"string","image_alt":"null","favicon":"string","theme_color":"string","twitter_card":"string","twitter_site":"null","oembed":"null","jsonld_types":["string"],"open_graph":{"title":"string","description":"string","site_name":"string","image":"string","locale":"string","type":"string","url":"string"},"twitter":{"card":"string","title":"string","description":"string","image":"string"},"missing":[]},"payment":{"payment_id":"string","transaction":"string"}},"refusals":{"400":"invalid input: the message names the field and the expected format; nothing is charged","402":"payment required, or the payment was refused (reason in \"error\"); nothing is charged","403/404":"not your item, or the asked item does not exist; nothing is charged","409/422":"not allowed right now (state or destination safety); nothing is charged","503":"a source or the payment rail is unavailable; nothing is charged, retry after Retry-After"},"mcp":{"server":"https://yruz.one/mcp/x402","payment":"params._meta[\"x402/payment\"] = PaymentPayload"},"related":{"tools":[{"tool":"extract","url":"https://yruz.one/api/extract","why":"the page as Markdown","usd":"0.005","how":"https://yruz.one/api/instructions?tool=extract"},{"tool":"safety","url":"https://yruz.one/api/safety","why":"is the link safe","usd":"0.005","how":"https://yruz.one/api/instructions?tool=safety"}],"more_x402_apis":{"402index":"https://402index.io","x402scan":"https://www.x402scan.com","agent402":"https://agent402.tools","x402_protocol":"https://www.x402.org"},"all_yruz_tools":"https://yruz.one/api/instructions"}}