Menu
Docs/Extract Metadata

Extract Metadata

Extract structured metadata from any URL using a real browser. Returns title, description, Open Graph tags, Twitter Card tags, and all favicons.

GET/v1/extract

Parameters

ParameterTypeDefaultDescription
url*stringThe URL to extract metadata from. Must be http:// or https://.

Response

{
  "url": "https://linear.app",
  "title": "Linear – A better way to build products",
  "description": "Linear streamlines issues, sprints, and product roadmaps...",
  "image": "https://linear.app/og-image.png",
  "siteName": "Linear",
  "og:title": "Linear – A better way to build products",
  "og:description": "Linear streamlines issues, sprints, and product roadmaps...",
  "og:image": "https://linear.app/og-image.png",
  "og:url": "https://linear.app",
  "twitter:card": "summary_large_image",
  "favicons": [
    { "url": "https://linear.app/favicon.ico", "type": "image/x-icon" },
    { "url": "https://linear.app/apple-touch-icon.png", "size": "180x180", "type": "image/png" }
  ]
}

Example

curl "https://api.snapsharp.dev/v1/extract?url=https://linear.app" \
  -H "Authorization: Bearer sk_live_..."
import { SnapSharp } from '@snapsharp/sdk';

const snap = new SnapSharp('sk_live_...');
const meta = await snap.extract('https://linear.app');

console.log(meta.title);     // "Linear – A better way to build products"
console.log(meta.favicons);  // [{ url: "...", type: "image/x-icon" }, ...]
from snapsharp import SnapSharp

snap = SnapSharp("sk_live_...")
meta = snap.extract("https://linear.app")
print(meta["og:image"])  # "https://linear.app/og-image.png"

Use cases

  • Link previews — generate rich link previews for chat apps or CMS
  • SEO auditing — verify OG and Twitter Card tags are set correctly
  • Favicon collection — grab all favicon variants from a site
  • Content aggregation — extract metadata for bookmarks, feeds, or dashboards

Errors

CodeErrorDescription
400invalid_urlInvalid or missing URL
401unauthorizedMissing or invalid API key
429rate_limitedRate limit exceeded
502extract_failedCould not load or parse the page
504timeoutPage load timed out