API para desarrolladores

Cada petición debe incluir tu clave de API en la cabecera x-api-key (también se acepta Authorization: Bearer <clave>).

curl "https://www.nutriinfo.es/api/public/v1/products?ean=8410000000000" \
  -H "x-api-key: nk_live_..."

La URL incluye la versión de la API (/api/public/v1/...). Cualquier cambio incompatible se publicará bajo una nueva versión (/v2); la actual seguirá funcionando igual.

Cada clave tiene un límite de 20 peticiones por hora. Al superarlo, la API responde 429 rate_limit_exceeded con una cabecera Retry-After indicando cuántos segundos esperar.

Busca productos por texto y devuelve un listado con id, EAN, nombre y precio.

La búsqueda ignora mayúsculas y acentos, y exige que todas las palabras de q aparezcan en algún sitio (nombre, descripción o ingredientes) para que un producto entre en los resultados. Los resultados se ordenan por relevancia: un acierto en el nombre del producto pesa mucho más que uno en la descripción o los ingredientes, y en caso de empate gana el nombre más corto (p. ej. buscando “maiz”, “Maíz seco” queda por delante de “Galletas de arroz y maíz”).

curl "https://www.nutriinfo.es/api/public/v1/products/search?q=maiz&limit=5" \
  -H "x-api-key: nk_live_..."

{
  "ok": true,
  "data": [
    { "id": "12345", "ean": "8410000000000", "name": "Copos de maíz", "price": 1.95 },
    { "id": "12346", "ean": "8410000000001", "name": "Harina de maíz", "price": 0.89 }
  ]
}

Devuelve el nombre y la información nutricional de un producto por su EAN o su id de Nutriinfo/Mercadona.

curl "https://www.nutriinfo.es/api/public/v1/products?ean=8410000000000" \
  -H "x-api-key: nk_live_..."

{
  "ok": true,
  "data": {
    "id": "12345",
    "ean": "8410000000000",
    "name": "Leche entera 1L",
    "nutrition": {
      "per100g": {
        "energy_kcal": 64,
        "energy_kj": 268,
        "fats_g": 3.6,
        "saturated_fats_g": 2.3,
        "carbs_g": 4.8,
        "sugars_g": 4.8,
        "fiber_g": 0,
        "proteins_g": 3.1,
        "salt_g": 0.1
      }
    }
  }
}

nutrition es null cuando todavía no tenemos la tabla nutricional de ese producto.

Los errores siempre devuelven { "ok": false, "error": { "code", "message" } } junto con el código HTTP correspondiente.