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/extractParameters
| Parameter | Type | Default | Description |
|---|---|---|---|
url* | string | — | The 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
| Code | Error | Description |
|---|---|---|
| 400 | invalid_url | Invalid or missing URL |
| 401 | unauthorized | Missing or invalid API key |
| 429 | rate_limited | Rate limit exceeded |
| 502 | extract_failed | Could not load or parse the page |
| 504 | timeout | Page load timed out |