Développeurs · REST API

Documentation API ScanAbook V2.

Authentifiez vos requêtes avec l'en-tête x-api-key: sab_... ou Authorization: Bearer sab_... généré depuis vos Réglages.

Exemple cURL
curl -H "x-api-key: sab_votre_cle" \
  "https://votre-domaine.fr/api/lookup?isbn=9780262033848&market=FR"
GET/api/lookup?isbn=9780262033848&market=FR&mode=fba&buyCost=1
Recherche un ISBN et retourne les métadonnées BnF/Google Books, l'offre Momox.fr, la valorisation IA, les frais et le ScanAbook Score.
GET/api/scans
Liste les 50 derniers scans de l'utilisateur authentifié (avec filtres q et favorite).
POST/api/scans
Envoie 1 à 10 photos d'étagères (multipart/form-data, champ files), consomme 1 crédit par photo et crée un scan.
GET/api/scans/:id
Récupère le détail complet d'un scan et tous ses livres triés par ScanAbook Score.
POST/api/barcode
Ajoute un ISBN scanné (JSON { isbn, scanId? }) à la session code-barres du jour (gratuit).
GET/api/stock
Retourne l'inventaire et les statistiques de marge de l'utilisateur.
GET/api/lists
Liste toutes vos listes d'achat (Buy Lists) et leurs livres.
ScanAbook — Photographiez l'étagère, repérez les pépites