Da zero ai dati nutrizionali in 3 chiamate

È tutto semplice REST + JSON con un solo header. Registrati, prendi la tua chiave gratuita (20 crediti IA inclusi, nessuna carta) e incolla questi comandi in un terminale.

Ottieni la tua chiave API gratuita Prendi la tua chiave Riferimento API completo

Il percorso testuale

Ricerca → prodotto → nutrienti. È la spina dorsale di ogni selettore di alimenti e di ogni tracker.

Cerca un prodotto

Ricerca full-text su 6,1 M di prodotti: funziona con qualsiasi lingua dell'etichetta, cirillico compreso. Prendi l'`id` dal primo risultato.

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
}

Recupera il prodotto completo

Nomi in tutte le lingue presenti sull'etichetta, ingredienti, allergeni, Nutri-Score, gruppo NOVA: un solo GET.

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

Ottieni i nutrienti

Oltre 40 campi nutrizionali per 100 g: macro sempre, vitamine e minerali dove esistono dati di laboratorio o del produttore. Piano Free: 25 dettagli al giorno; i piani a pagamento non hanno limiti.

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

Il percorso fotografico AI

Le app basate sulla fotocamera saltano del tutto la digitazione: entra una foto, escono dati strutturati. Legge etichette in qualsiasi lingua, cirillico compreso. Prova tutto prima nel browser, nell'area di prova.

Foto → prodotto

Invia in POST una foto del fronte della confezione; l'IA lo identifica e lo abbina al catalogo. 3 crediti (ogni piano include un'assegnazione mensile di crediti: il piano Free ne ha 20).

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%", "…": "…" }]
}

…oppure foto del codice a barre → prodotto, gratis

La decodifica del codice a barre è pura computer vision: costa 0 crediti e conta solo sulla tua quota dati. Di solito è la chiamata con più volume in un'app di tracking.

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

Analisi IA, nella lingua del tuo utente

Trasforma qualsiasi prodotto in un riepilogo leggibile: punti di forza e aspetti da tenere d'occhio secondo le soglie pubblicate da UE e FSA, allergeni, compatibilità con le diete (con la relativa fonte), livello di trasformazione. 4 crediti; risposte in cache per prodotto + lingua (en, fr, es, de, it, bg), e i giudizi sono calcolati da regole, quindi non si contraddicono mai tra una lingua e l'altra.

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"

Buono a sapersi

I limiti di frequenza rispondono con 429 + un header Retry-After: rispettalo e non perderai mai una richiesta.
Devi caricare molti prodotti? POST /v1/foods/bulk ne recupera fino a 100, per ID o codice a barre, in una sola chiamata, meglio di un ciclo in parallelo con qualsiasi piano.
Ogni risposta IA include X-Credits-Remaining, così il tuo modello di costi si costruisce da solo mentre fai i test.