Documentación de la API

API MetaFetch de extracción Open Graph v1

Primeros pasos

Inicia sesión en /login con email/contraseña o Google.
Abre el panel y genera tu clave API gratuita (mf_live_...).
Llama a GET /api/v1/preview con Authorization: Bearer tu_clave.

Usa siempre la URL canónica con www (p. ej. https://www.metafetch.dev). El dominio sin www redirige y puede eliminar el header Authorization.

Endpoint

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

Autenticación

Authorization: Bearer mf_live_your_api_key

Ejemplo (bash)

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

Ejemplo (PowerShell)

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

Respuesta

{
  "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 (sin clave)

La demo pública sin clave funciona solo para example.com y github.com.

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

Errores

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