Link Preview API Use Cases

Chat Applications — URL Unfurling

When users paste a link in a chat message, automatically show a rich preview with the page title, description, and image — just like Slack, Discord, or Teams.

How it works: detect URLs in messages, call GET /v1/preview, render the metadata as an inline card.

// When a message contains a URL
const preview = await fetch(
  `https://linkpeek-api.linkpeek.workers.dev/v1/preview?url=${url}&key=${KEY}`
).then(r => r.json());

// Render: preview.title, preview.description, preview.image

Social Feeds — Link Cards

Building a social feed or news aggregator? Show rich link cards like Twitter and Facebook do when users share URLs.

Or use SVG cards directly:

<img src="https://linkpeek-api.linkpeek.workers.dev/v1/preview/image?url=https://example.com&key=YOUR_KEY" />

No client-side JavaScript needed. Works everywhere images work.

CMS & Blog Platforms — Rich Embeds

Let content creators paste a URL and automatically generate a rich embed block. Used by platforms like Notion, Medium, and WordPress.

LinkPeek extracts Open Graph tags, Twitter Card data, and standard meta tags to build complete previews.

SEO Tools — Meta Tag Analysis

Build SEO audit tools that check any URL's meta tags, Open Graph data, and Twitter Card configuration. LinkPeek returns all the metadata in a clean JSON format.

// Check if a page has proper OG tags
const meta = await fetch(`/v1/preview?url=${targetUrl}&key=${KEY}`).then(r => r.json());

if (!meta.image) console.warn('Missing og:image!');
if (!meta.description) console.warn('Missing description!');

Email — Link Preview Images

Embedding link previews in emails is tricky because email clients don't run JavaScript. With LinkPeek's SVG card endpoint, you get a static image that works in any email client.

<img src="https://linkpeek-api.linkpeek.workers.dev/v1/preview/image?url=https://example.com&key=YOUR_KEY" width="600" />

Bookmarking & Read-Later Apps

When users save a URL, automatically fetch the title, description, and thumbnail to create a visual bookmark. No manual input needed.

Dashboards & Admin Panels

Show rich link previews in admin dashboards, CRM tools, or project management apps when dealing with external URLs.