API Documentation

MetaFetch Open Graph extraction API v1

Getting started

Sign in at /login with email/password or Google OAuth.
Open the dashboard and generate your free API key (mf_live_...).
Call GET /api/v1/preview with Authorization: Bearer your_key.

Always use the canonical URL with www (e.g. https://www.metafetch.dev). The bare domain redirects and may strip the Authorization header.

Endpoint

GET https://www.metafetch.dev/api/v1/preview?url={encoded_url}

Authentication

Authorization: Bearer mf_live_your_api_key

Example (bash)

curl "https://www.metafetch.dev/api/v1/preview?url=https://github.com" \
  -H "Authorization: Bearer mf_live_your_api_key"

Example (PowerShell)

curl.exe "https://www.metafetch.dev/api/v1/preview?url=https://github.com" `
  -H "Authorization: Bearer mf_live_your_api_key"

Response

{
  "success": true,
  "data": {
    "url": "https://github.com",
    "title": "GitHub",
    "description": "...",
    "image": "https://...",
    "favicon": "https://...",
    "siteName": "GitHub",
    "canonical": "https://github.com",
    "locale": "en_US",
    "type": "website"
  }
}

Demo (no key)

Public demo without a key works for example.com and github.com only.

GET https://www.metafetch.dev/api/v1/preview?url=https://example.com
GET https://www.metafetch.dev/api/v1/preview?url=https://github.com

Errors

401 Unauthorized — missing/invalid API key
429 Too Many Requests — quota or rate limit exceeded
400 Bad Request — invalid URL
502 Bad Gateway — upstream fetch failed