Documentation API

API MetaFetch d’extraction Open Graph v1

Démarrer

Connectez-vous sur /login avec email/mot de passe ou Google.
Ouvrez le dashboard et générez votre clé API gratuite (mf_live_...).
Appelez GET /api/v1/preview avec Authorization: Bearer votre_clé.

Utilisez toujours l’URL canonique avec www (ex. https://www.metafetch.dev). Le domaine sans www redirige et peut supprimer le header Authorization.

Point de terminaison

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

Authentification

Authorization: Bearer mf_live_your_api_key

Exemple (bash)

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

Exemple (PowerShell)

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

Réponse

{
  "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"
  }
}

Démo (sans clé)

La démo publique sans clé fonctionne uniquement pour example.com et 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

Erreurs

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