От нула до хранителни данни с 3 заявки

Всичко е обикновен REST + JSON с един хедър. Регистрирай се, вземи безплатния си ключ (20 AI кредита включени, без карта) и постави тези команди в терминал.

Вземи безплатен API ключ Вземи ключа си Пълна API документация

Пътят с текст

Търсене → продукт → хранителни вещества. Това е гръбнакът на всеки избор на храна и всеки тракер.

Потърси продукт

Пълнотекстово търсене сред 6,1 млн. продукта — работи с всеки език на етикета, включително кирилица. Вземи `id` от първия резултат.

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
}

Извлечи целия продукт

Имена на всички езици от етикета, съставки, алергени, Nutri-Score, група NOVA — с една GET заявка.

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

Вземи хранителните вещества

Над 40 полета с хранителни вещества на 100 г — макроси винаги, витамини и минерали там, където има лабораторни данни или данни от производителя. План Free: 25 разбивки на ден; платените планове са без ограничение.

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

Пътят със снимка AI

Приложенията, базирани на камерата, изобщо пропускат писането: снимка на входа, структурирани данни на изхода. Чете етикети на всякакъв език, включително кирилица. Първо изпробвай всичко в браузъра си в площадката.

Снимка → продукт

Изпрати с POST снимка на лицевата страна на опаковката; AI разпознава продукта и го съпоставя с каталога. 3 кредита (всеки план включва месечен лимит от кредити — Free получава 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%", "…": "…" }]
}

…или снимка на баркод → продукт, безплатно

Разчитането на баркод е чисто компютърно зрение — струва 0 кредита и се отчита само в квотата ти за данни. Обикновено това е заявката с най-голям обем в едно приложение за проследяване.

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

AI анализ на езика на твоя потребител

Превърни всеки продукт в разбираемо резюме — плюсове и неща, за които да внимаваш, според публикуваните прагове на ЕС/FSA, алергени, съвместимост с диети и източник, степен на преработка. 4 кредита; отговорите се кешират за всеки продукт + език (en, fr, es, de, it, bg), а оценките се изчисляват по правила, така че никога не си противоречат между езиците.

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"

Добре е да знаеш

При достигнат лимит отговорът е 429 + хедър Retry-After — спазвай го и никога няма да изгубиш заявка.
Трябва да заредиш много продукти? POST /v1/foods/bulk извлича до 100 по ID или баркод с една заявка — по-добре от паралелен цикъл при всеки план.
Всеки AI отговор съдържа X-Credits-Remaining, така че моделът ти на разходите се изгражда сам, докато тестваш.