Instant Link Metadata & Preview API

Titles, images, AI summaries & safe-link classification for any URL - at edge speed.

Ready for a public HTTP or HTTPS URL.

Preview card

Rendered with the web component.

Run a URL to see the generated link preview.

Response JSON

Returned by /v1/metadata.

The API response appears here after the request completes.

Why LinkMetadata?

LinkMetadata is for apps and websites that need rich link previews, summaries, or safe-link checks.

  • Chat & messaging apps - show a preview when users share a link.
  • Social feeds & timelines - enrich posts with safe, attractive link cards.
  • Publishing tools - auto-fetch metadata for blogs, newsletters, or knowledge bases.

Features

  • Zero-config cache - canonicalises URLs and serves repeat requests from 13 ms global edge.
  • AI fallbacks - generates a clean title/description when sites forget their OG or metadata tags.
  • Free API - use the metadata endpoint and preview component without signup or API keys.
  • Predictable rate limit - 20 requests per 10 seconds per IP, with a 10-second block when reached.

Use the REST API or the Preview Component

Fetch rich metadata for any URL in a single request. Perfect for link previews, chat apps, and more.

GET https://api.linkmetadata.com/v1/metadata?url=https://cat-bounce.com/
HTTP/1.1 200 OK
Content-Type: application/json

{
  "title": "CAT BOUNCE!",
  "description": "It's Cat Bounce, what more do you need to know?",
  "url": "https://www.cat-bounce.com/",
  "image": {
    "url": "https://cat-bounce.com/catbounce.png",
    "type": "image/png",
    "width": 260,
    "height": 260,
    "size": 77369
  },
  "type": "website",
  "favicon": { "url": "...", "type": "image/png" },
  "og": { "...": "..." },
  "twitter": { "...": "..." },
  "safety_tags": []
}

safety_tags returns readable labels such as adult, security_threat, and suspicious_domain; it is empty when no tag applies.

Want to see all available fields and integration tips? Read the Docs

Frequently Asked Questions

Can I use it for free?

Yes. The API is free to use and does not require authentication, signup, or API keys.

What are the rate limits?

Requests are limited to 20 per 10 seconds per IP address. When the limit is reached, that IP is blocked for 10 seconds before it can retry.

How fast is the API?

Most cached requests are served in under 200ms. Uncached links are fetched and parsed in real time, usually within 1 second.

What happens if a site has no Open Graph tags?

We use alternative metadata when available and fall back to generated domain-wide titles and descriptions when possible.

Can I use this for commercial projects?

Yes. The API is free for commercial use. There are no API keys or paid plans today, so design your integration around the public rate limit.

Ready to get started?

Use the Preview Component to embed rich previews, or fetch metadata directly from the API. No signup and no credit card required.

Read the Docs