MetasBooks API
Connexion Inscription
⚡ MĂ©tadonnĂ©es livres ‱ EAN/ISBN ‱ Images ‱ Caching

Une API française pour les métadonnées du livre.

RécupÚre des fiches propres (titre, auteur, éditeur, description, formats, dimensions, image) et pilote ta clé API, tes crédits et tes logs depuis le backoffice.

Tester le playground Voir les endpoints Ouvrir le backoffice
Exemple cURL (v1)
curl -s "/api/v1/lookup?ean=9782070360024" \
  -H "X-API-Key: VOTRE_CLE"
Status : 
 Ouvrir /health


Fonctions

Tester Endpoints
LOOKUP
Interrogation rapide

Endpoint principal pour rĂ©cupĂ©rer une fiche livre Ă  partir d’un EAN / ISBN-13.

đŸ”č RĂ©ponse JSON normalisĂ©e
đŸ”č Logs et contrĂŽle de cohĂ©rence intĂ©grĂ©s


1 crĂ©dit / requĂȘte

CATÉGORIES
Taxonomie BISAC / CLIL

AccĂšs Ă  l’arborescence complĂšte des catĂ©gories (racine ou enfants via parent_id).

đŸ”č IdĂ©al pour sĂ©lecteurs en cascade
đŸ”č DonnĂ©es structurĂ©es et stables


0 crédit

COMPTE
Clé API & crédits

Consultation du statut du compte associé à une clé API.

đŸ”č CrĂ©dits restants
đŸ”č Plan actif / limitations


0 crédit

BACKOFFICE
Gestion & historique

Interface de gestion de la clĂ© API et de suivi d’activitĂ©.

đŸ”č RĂ©gĂ©nĂ©ration de clĂ©
đŸ”č Logs dĂ©taillĂ©s et filtres avancĂ©s

QUALITÉ
Données fiables

DonnĂ©es nettoyĂ©es et contrĂŽlĂ©es avant exposition via l’API.

đŸ”č Anti-HTML / anti-pollution
đŸ”č PrioritĂ© aux sources crĂ©dibles

Communauté
Contributions vérifiées

Les fiches peuvent ĂȘtre enrichies par les utilisateurs connectĂ©s. Chaque contribution est vĂ©rifiĂ©e manuellement avant publication, garantissant des donnĂ©es fiables et traçables.

Endpoints

GET /api/v1/lookup Lookup v1 (header X-API-Key) — 1 crĂ©dit / requĂȘte
â–Ÿ

ParamĂštres : ean (13 chiffres). Auth : X-API-Key. RĂ©ponse JSON. 

curl -i "https://metasbooks.fr/api/v1/lookup?ean=9782070360024" -H "X-API-Key: VOTRE_CLE"
GET /api/v1/categories CatĂ©gories (header X-API-Key) — 0 crĂ©dit
â–Ÿ

ParamĂštres : parent_id (optionnel). Sans parent_id → catĂ©gories racines. Auth : X-API-Key. RĂ©ponse JSON. 

curl -i "https://metasbooks.fr/api/v1/categories" -H "X-API-Key: VOTRE_CLE"
curl -i "https://metasbooks.fr/api/v1/categories?parent_id=1" -H "X-API-Key: VOTRE_CLE"
GET /api/v1/account Statut du compte (header X-API-Key) — 0 crĂ©dit
â–Ÿ

Auth : X-API-Key. Réponse JSON (crédits, plan, statut, etc.). 

curl -i "https://metasbooks.fr/api/v1/account" -H "X-API-Key: VOTRE_CLE"
GET /health Status service
â–Ÿ 
curl -i "https://metasbooks.fr/health"
GET /api/v1/is_ean_available VĂ©rifie si un EAN est disponible — 0 crĂ©dit
â–Ÿ

ParamĂštres : ean (13 chiffres). Auth : X-API-Key. RĂ©ponse JSON. 

curl -i "https://metasbooks.fr/api/v1/is_ean_available?ean=9782070360024" -H "X-API-Key: VOTRE_CLE"
POST /api/v1/books/submit Soumettre une nouvelle fiche livre — 0 crĂ©dit ‱ +50 crĂ©dits si la fiche est crĂ©Ă©e
â–Ÿ

Auth : X-API-Key. MĂ©thode : POST. Body : JSON. RĂ©ponse JSON.

✅ CoĂ»t : 0 crĂ©dit.
🎁 RĂ©compense : +50 crĂ©dits si l’EAN n’existe pas encore et que la fiche est crĂ©Ă©e.
â„č Si l’EAN existe dĂ©jĂ  : created:false, credited:0.

Champs obligatoires :
ean, titre, auteur, editeur, description, image_url

Champs optionnels :
serie, num_serie

⚠ La soumission est refusĂ©e si un champ obligatoire est manquant ou si l’URL d’image n’est pas valide. 

curl -i "https://metasbooks.fr/api/v1/books/submit" \
  -H "X-API-Key: VOTRE_CLE" \
  -H "Content-Type: application/json" \
  --data '{
    "ean":"9782070360024",
    "titre":"Titre du livre",
    "auteur":"Auteur",
    "editeur":"Éditeur",
    "description":"Description complùte du livre
",
    "image_url":"https://exemple.com/couverture.jpg",
    "serie":"Nom de la série",
    "num_serie":"2"
  }'

Codes possibles : 201 (créée), 200 (déjà existante), 400 (champs manquants / image invalide), 403 (compte inactif).

POST /api/v1/suggest/edit SuggĂ©rer une correction (fiche existante) — 0 crĂ©dit ‱ +20 crĂ©dits si modification validĂ©e
â–Ÿ

Auth : X-API-Key. Body : JSON (recommandé) ou x-www-form-urlencoded. Réponse JSON. Le livre doit exister en base.

✅ CoĂ»t : 0 crĂ©dit.
🎁 RĂ©compense : si la correction est jugĂ©e valable et acceptĂ©e, votre compte est crĂ©ditĂ© de +20 crĂ©dits.

Champs acceptés (optionnels) : titre, auteur, editeur, collection, serie, num_serie, format, presentation, date_parrution, nbpages, poids, largeur, hauteur, epaisseur, category_id, image_key, description.
⚠ Il faut au moins 1 champ utile (sinon missing_fields). 

curl -i "https://metasbooks.fr/api/v1/suggest/edit" \
  -H "X-API-Key: VOTRE_CLE" \
  -H "Content-Type: application/json" \
  --data '{
    "ean":"9782070360024",
    "titre":"NOUVEAU TITRE",
    "description":"Description corrigée
"
  }'

Astuce : si tu veux “vider” un champ, envoie la clĂ© avec une valeur vide (ex: "collection": "") — le serveur enregistrera null.

GET /api/v1/stats/books Statistiques livres (total + derniers) — 0 crĂ©dit
â–Ÿ

RĂ©ponse JSON : total et derniers ajouts/updates (utilisĂ© par le bloc “En temps rĂ©el”). 

curl -i "https://metasbooks.fr/api/v1/stats/books"
GET /book Page publique fiche livre (HTML)
â–Ÿ

ParamÚtre : ean. Affiche une page HTML basée sur les données du livre cible. 

curl -i "https://metasbooks.fr/book?ean=9782070360024"

Playground

Tester en direct
Playground API
Astuce : coche “clĂ© de dĂ©mo” si tu n’as pas de clĂ©.
DĂ©mo : les requĂȘtes lookup sont limitĂ©es Ă  5 / jour / IP.
PrĂȘt 

      

    


    

      
RĂ©sultat

      
// Les données apparaissent ici


    

  





En temps réel




    

      

        
Base MetasBooks

        

          
—

          
références en base

        

      


      

        

          API—
        

        

          latence—
        

        

          refreshON
        

        

          maj—
        

      

    


    

      
DerniĂšres mises Ă  jour

      

        
        
      

    


    

      
Chargement


    


    

      

    

  


  
Intégrations




  

    

      
Intégrations CMS & e-commerce

      
Plugins officiels et connecteurs compatibles pour afficher / synchroniser les métadonnées.

    


    

      
      
    

  


  


    
    

      
        
        WordPress
        
          Disponible
          Plugin
        
      
      

        

          

            
Fonctions

            
    
              
  • Lookup EAN → fiche JSON
    • 
              
  • Affichage mĂ©tadonnĂ©es sur page produit
    • 
              
  • RĂ©cupĂ©ration d’image via URL signĂ©e
    • 
            

          

          

            
Liens

            

              GitHub
              Docs API
            

            

              Prérequis : clé API (X-API-Key).
            

          

        

      

    


    
    

      
        
        WooCommerce
        
          Disponible
          Extension WP
        
      
      

        

          

            
Cas d’usage

            
    
              
  • CrĂ©ation/MAJ produits depuis EAN
    • 
              
  • Stock & prix cĂŽtĂ© boutique (optionnel)
    • 
              
  • Images, dimensions, descriptions
    • 
            

          

          

            
Statut

            
Selon ton plugin / roadmap.

            

              Documentation
            

          

        

      

    


    
    

      
        
        PrestaShop
        
          BĂȘta
          Module
        
      
      

        

          

            
Objectif

            
    
              
  • Utiliser ean13 du produit
    • 
              
  • Afficher une “fiche” enrichie sur page produit
    • 
              
  • Cache local + timeouts courts
    • 
            

          

          

            
Aide

            
Tu peux contribuer : tests, retours, PR.

            

              Roadmap
              Issues
            

          

        

      

    


    
    

      
        
        Magento / Adobe Commerce
        
          À venir
          Extension
        
      
      

        

          Connecteur prévu (lookup + cache). Priorité selon la demande.
        

      

    


    
    

      
        
        Shopify
        
          À Ă©tudier
          App
        
      
      

        

          Possible via app privée + appels API MetasBooks.
        

      

    


  


  

    Astuce : si tu veux une intégration sur mesure (CMS maison / ERP), les endpoints clés sont /api/v1/lookup et /api/v1/image.
  






Connecteurs de stock




  

    

      
Connecteurs de stock

      
Extraction & synchronisation des stocks depuis les logiciels de caisse / catalogues.

    


    

      
      
    

  


  


    

      
        
        Librisoft
        
          Compatible
          Export
        
      
      

        

          

            
MĂ©thode

            
    
              
  • Export EAN + quantitĂ©
    • 
              
  • Import dans MetasBooks (API / fichier)
    • 
              
  • RĂ©conciliation par EAN
    • 
            

          

          

            
Formats

            
CSV / XML (selon version & paramétrage).

          

        

      

    


    

      
        
        Bimedia
        
          À documenter
          Caisse
        
      
      

        

          Selon les configurations : export, connecteur, ou passerelle intermédiaire.
        

      

    


    

      
        
        MĂ©dialog
        
          À documenter
          Catalogue/gestion
        
      
      

        

          Connecteur prévu : import CSV, mapping champs, logs des EAN inconnus.
        

      

    


    

      
        
        TiteLive (noTice)
        
          À Ă©tudier
          Librairie
        
      
      

        

          Plusieurs flux possibles (selon accùs/contrats). L’objectif : synchroniser EAN + stock + prix (optionnel).
        

      

    


  


  

    Objectif : une synchronisation fiable EAN → stock (et Ă©ventuellement prix), avec historiques et logs.