De cero a datos nutricionales en 3 llamadas

Todo es REST + JSON con una sola cabecera. Regístrate, consigue tu clave gratis (20 créditos de IA incluidos, sin tarjeta) y pega esto en una terminal.

Consigue tu clave de API gratis Consigue tu clave Referencia completa de la API

La ruta de texto

Búsqueda → producto → nutrientes. Es la columna vertebral de cualquier selector de alimentos y de cualquier tracker.

Busca un producto

Búsqueda de texto completo en 6,1 M de productos: funciona con cualquier idioma de etiqueta, cirílico incluido. Toma el `id` del primer resultado.

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
}

Obtén el producto completo

Nombres en todos los idiomas que trae la etiqueta, ingredientes, alérgenos, Nutri-Score, grupo NOVA: un solo GET.

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

Obtén los nutrientes

Más de 40 campos de nutrientes por 100 g: los macros siempre, y vitaminas y minerales cuando hay datos de laboratorio o del fabricante. Plan Free: 25 desgloses al día; los planes de pago no tienen límite.

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

La ruta de la foto AI

Las apps centradas en la cámara se saltan la escritura por completo: entra una foto, salen datos estructurados. Lee etiquetas en cualquier idioma, cirílico incluido. Pruébalo todo antes en tu navegador, en la zona de pruebas.

Foto → producto

Envía por POST una foto del frontal del envase; la IA lo identifica y lo busca en el catálogo. 3 créditos (todos los planes incluyen una asignación mensual de créditos; el plan Free tiene 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%", "…": "…" }]
}

…o foto del código de barras → producto, gratis

Decodificar un código de barras es visión por computador pura: cuesta 0 créditos y solo cuenta para tu cuota de datos. Suele ser la llamada con más volumen en una app de seguimiento.

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

Análisis con IA, en el idioma de tu usuario

Convierte cualquier producto en un resumen fácil de leer: puntos fuertes y puntos a vigilar según los umbrales publicados por la UE y la FSA, alérgenos, compatibilidad con dietas (con su fuente), nivel de procesamiento. 4 créditos; respuestas en caché por producto + idioma (en, fr, es, de, it, bg), y los veredictos se calculan con reglas, así que nunca se contradicen entre idiomas.

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"

Conviene saber

Los límites de frecuencia responden con 429 + una cabecera Retry-After: respétala y nunca perderás una petición.
¿Tienes que cargar muchos productos? POST /v1/foods/bulk obtiene hasta 100, por ID o código de barras, en una sola llamada, mejor que un bucle en paralelo en cualquier plan.
Cada respuesta de IA incluye X-Credits-Remaining, así que tu modelo de costes se construye solo mientras pruebas.