Link Preview — Metadata from any URL, instantly

Tools / Link Preview

Preview URL

Extract metadata from a single URL. Returns title, description, image, author, publisher, language, and logo.

Returns: Page metadata including title, description, author, publisher, language, preview image URL, and site logo URL

Parameters

url *stringThe full URL to extract metadata from (e.g. "https://example.com/article")

Example

Extract metadata from a blog post

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "link-preview",
  "skill": "preview_url",
  "input": {
    "url": "https://toolrouter.com"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Quick Start

MCP (Claude Code)

claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp

REST API

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"link-preview","skill":"preview_url","input":{}}' \
  https://api.toolrouter.com/v1/tools/call

Frequently Asked Questions

Do I need to pass a full URL?

Yes. `preview_url` expects a complete URL with protocol, such as `https://...`.

What metadata does the preview return?

It returns the title, description, Open Graph image, author, publisher, language, and logo for the page.

Is this useful for social cards or bookmarks?

Yes. It is a fast way to validate link cards, bookmark previews, and social metadata without doing a full scrape.

Can I get article dates and author details?

When the page exposes them, the preview includes published date and author data for article-style content.