Des données nutritionnelles en 3 appels

Tout est en REST + JSON, avec un seul en-tête. Inscrivez-vous, récupérez votre clé gratuite (20 crédits IA inclus, sans carte) et collez ces commandes dans un terminal.

Obtenir ma clé API gratuite Récupérer ma clé Référence complète de l'API

Le parcours texte

Recherche → produit → nutriments. C'est la colonne vertébrale de tout sélecteur d'aliments et de tout tracker.

Rechercher un produit

Recherche plein texte parmi 6,1 M de produits — toutes les langues d'étiquette fonctionnent, cyrillique compris. Récupérez l'`id` du premier résultat.

curl -H "X-API-Key: food_YOUR_KEY" \
  "https://foodbase.dev/v1/foods/search?q=nutella&limit=1"

{
  "data": [{
    "id": "2fc13a3b-1913-5ab6-d2c7-8c09b56f93bb",
    "name_default": "Nutella",
    "brand": "Ferrero",
    "barcode": "3017620422003",
    "category": "Sweet spreads"
  }],
  "total": 611
}

Récupérer le produit complet

Les noms dans toutes les langues de l'étiquette, les ingrédients, les allergènes, le Nutri-Score, le groupe NOVA — en un seul GET.

curl -H "X-API-Key: food_YOUR_KEY" \
  "https://foodbase.dev/v1/foods/2fc13a3b-1913-5ab6-d2c7-8c09b56f93bb"

Obtenir les nutriments

Plus de 40 champs nutritionnels pour 100 g — toujours les macros, les vitamines et minéraux quand des données de laboratoire ou du fabricant existent. Plan Free : 25 détails par jour ; les plans payants sont illimités.

curl -H "X-API-Key: food_YOUR_KEY" \
  "https://foodbase.dev/v1/foods/2fc13a3b-1913-5ab6-d2c7-8c09b56f93bb/nutrients"

{
  "macros": { "energy_kcal": 539, "fat_g": 30.9, "sugars_g": 56.3, "proteins_g": 6.3 },
  "vitamins": { "…": "…" },
  "minerals": { "…": "…" }
}

Le parcours photo AI

Les applis centrées sur l'appareil photo se passent complètement de saisie : une photo en entrée, des données structurées en sortie. Lit les étiquettes dans toutes les langues, cyrillique compris. Essayez tout dans votre navigateur d'abord, sur le bac à sable.

Photo → produit

Envoyez en POST une photo de la face avant ; l'IA identifie le produit et le rapproche du catalogue. 3 crédits (chaque plan inclut une enveloppe mensuelle de crédits — 20 pour le plan Free).

curl -X POST -H "X-API-Key: food_YOUR_KEY" \
  -F "[email protected]" \
  "https://foodbase.dev/v1/vision/product"

{
  "extracted": { "name": "Кисело мляко", "brand": "Верея", "confidence": 0.95 },
  "matches": [{ "id": "…", "name_default": "Кисело мляко Верея 3.6%", "…": "…" }]
}

…ou photo de code-barres → produit, gratuitement

Le décodage du code-barres relève de la pure vision par ordinateur — il coûte 0 crédit et ne compte que dans votre quota de données. C'est généralement l'appel le plus fréquent d'une appli de suivi.

curl -X POST -H "X-API-Key: food_YOUR_KEY" \
  -F "[email protected]" \
  "https://foodbase.dev/v1/vision/barcode"

Analyse IA, dans la langue de votre utilisateur

Transformez n'importe quel produit en un résumé lisible — points forts et points de vigilance d'après les seuils publiés par l'UE et la FSA, allergènes, compatibilité avec les régimes (avec sa source), degré de transformation. 4 crédits ; réponses mises en cache par produit + langue (en, fr, es, de, it, bg), et les verdicts sont calculés par des règles, ils ne se contredisent donc jamais d'une langue à l'autre.

curl -X POST -H "X-API-Key: food_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"barcode":"8000500082379","lang":"bg"}' \
  "https://foodbase.dev/v1/analyze/product"

Bon à savoir

Les limites de débit répondent par 429 + un en-tête Retry-After — respectez-le et vous ne perdrez jamais une requête.
Beaucoup de produits à charger ? POST /v1/foods/bulk en récupère jusqu'à 100, par ID ou code-barres, en un seul appel — mieux qu'une boucle parallèle, quel que soit le plan.
Chaque réponse IA contient X-Credits-Remaining : votre modèle de coûts se construit tout seul pendant vos tests.