Бесплатный Nutrition API для разработчиков: как создавать приложения с данными о продуктах Nutrola

Создание приложения, учитывающего питание, раньше требовало собирать собственную базу данных продуктов с нуля, лицензировать дорогие наборы данных или извлекать информацию из ненадежных источников. Сегодня Nutrition API предоставляют структурированный, программный доступ к обширным базам данных продуктов с данными о макро- и микроэлементах, а также размерах порций в формате JSON. Это руководство проведет разработчиков по миру Nutrition API, сосредоточив внимание на том, как начать работу с бесплатным тарифом Nutrola и как он сравнивается с альтернативами.

Неважно, создаете ли вы приложение для планирования питания, фитнес-трекер, исследовательский инструмент, анализатор рецептов или AI-ассистента, который отвечает на вопросы о питании — это руководство предоставит вам технические детали для выбора API и начала работы с запросами за считанные минуты.

Обзор рынка Nutrition API

Перед тем как погрузиться в реализацию, представляем сравнение основных Nutrition API, доступных разработчикам в 2026 году.

API	Бесплатный тариф	Лимит запросов (бесплатный)	Продукты в базе данных	Сканирование штрих-кодов	Распознавание продуктов (AI)	Цены (платные)
Nutrola API	Да	500 запросов/день	900,000+	Да	Да (дополнительно)	От $29/месяц
USDA FoodData Central	Да (полностью бесплатно)	1,000/час на ключ	370,000+	Нет	Нет	Бесплатно
Nutritionix API	Да (ограниченный)	50 запросов/день	1,000,000+	Да	Нет	От $299/месяц
Edamam API	Да	100 запросов/день	900,000+	Нет	Нет	От $19/месяц
FatSecret Platform API	Да	5,000 запросов/день	500,000+	Да	Нет	Бесплатно (с атрибуцией)
Open Food Facts API	Да (полностью бесплатно)	Разумное использование	3,000,000+	Да	Нет	Бесплатно
Spoonacular	Да	150 запросов/день	500,000+	Нет	Нет	От $29/месяц

Начало работы с Nutrola API

Шаг 1: Создание учетной записи разработчика

Перейдите на Портал разработчиков Nutrola по адресу developers.nutrola.com, чтобы создать бесплатную учетную запись. После подтверждения электронной почты вы получите API-ключ на своей панели управления. Бесплатный тариф включает 500 запросов в день, доступ ко всей базе данных продуктов и текстовый поиск по продуктам. Конечные точки для распознавания продуктов с помощью AI доступны на платных тарифах.

Шаг 2: Аутентификация

Все запросы к API требуют вашего API-ключа в заголовке запроса. Ключ передается через заголовок X-Api-Key.

X-Api-Key: ваш_api_ключ_здесь

API использует только HTTPS. Все запросы к HTTP-эндпоинтам будут перенаправлены на HTTPS. Не встраивайте свой API-ключ в клиентский код; всегда проксируйте запросы через ваш сервер.

Шаг 3: Базовый URL

Все конечные точки обслуживаются по адресу:

https://api.nutrola.com/v1/

Ответы возвращаются в формате JSON с кодировкой UTF-8. API следует RESTful-конвенциям с использованием стандартных кодов состояния HTTP.

Основные конечные точки

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

Ищите в базе данных продуктов по текстовому запросу. Возвращает соответствующие продукты с данными о питательных веществах.

Конечная точка: GET /v1/foods/search

Параметры:

Параметр	Тип	Обязательный	Описание
query	строка	Да	Поисковый запрос (например, "куриная грудка на гриле")
limit	целое число	Нет	Результаты на странице (по умолчанию: 10, максимум: 50)
offset	целое число	Нет	Смещение для постраничного вывода (по умолчанию: 0)
type	строка	Нет	Фильтр по типу: "обычный", "брендированный", "ресторанный"
language	строка	Нет	Код языка (по умолчанию: "en"). Поддерживает: en, es, de, fr, pt, ja, ko, zh

Пример запроса (cURL):

curl -X GET "https://api.nutrola.com/v1/foods/search?query=grilled+chicken+breast&limit=5" \
  -H "X-Api-Key: ваш_api_ключ_здесь"

Пример запроса (Python):

import requests

API_KEY = "ваш_api_ключ_здесь"
BASE_URL = "https://api.nutrola.com/v1"

response = requests.get(
    f"{BASE_URL}/foods/search",
    headers={"X-Api-Key": API_KEY},
    params={
        "query": "куриная грудка на гриле",
        "limit": 5
    }
)

data = response.json()
for food in data["foods"]:
    print(f"{food['name']}: {food['calories']} ккал на {food['serving_size']}{food['serving_unit']}")

Пример запроса (JavaScript / Node.js):

const API_KEY = "ваш_api_ключ_здесь";
const BASE_URL = "https://api.nutrola.com/v1";

async function searchFoods(query) {
  const url = new URL(`${BASE_URL}/foods/search`);
  url.searchParams.append("query", query);
  url.searchParams.append("limit", "5");

  const response = await fetch(url, {
    headers: { "X-Api-Key": API_KEY }
  });

  const data = await response.json();
  return data.foods;
}

searchFoods("куриная грудка на гриле").then(foods => {
  foods.forEach(food => {
    console.log(`${food.name}: ${food.calories} ккал на ${food.serving_size}${food.serving_unit}`);
  });
});

Пример ответа:

{
  "foods": [
    {
      "id": "nf_001234",
      "name": "Куриная грудка, жареная, без кожи",
      "type": "обычный",
      "calories": 165,
      "protein_g": 31.0,
      "carbohydrates_g": 0.0,
      "fat_g": 3.6,
      "fiber_g": 0.0,
      "sugar_g": 0.0,
      "sodium_mg": 74,
      "serving_size": 100,
      "serving_unit": "г",
      "serving_description": "100 грамм",
      "alt_servings": [
        {
          "description": "1 средняя грудка (196г)",
          "multiplier": 1.96
        },
        {
          "description": "1 унция (28г)",
          "multiplier": 0.28
        }
      ],
      "source": "USDA SR Legacy",
      "updated": "2026-01-15"
    }
  ],
  "total_results": 47,
  "offset": 0,
  "limit": 5
}

Получение продукта по ID

Получите подробные данные о питательных веществах для конкретного продукта по его ID Nutrola.

Конечная точка: GET /v1/foods/{food_id}

Пример (cURL):

curl -X GET "https://api.nutrola.com/v1/foods/nf_001234" \
  -H "X-Api-Key: ваш_api_ключ_здесь"

Ответ включает полный профиль макро- и микроэлементов (30+ питательных веществ), все доступные размеры порций, список ингредиентов (для брендированных и ресторанных продуктов), флаги аллергенов, диетические метки (веган, безглютеновый, халяль, кошерный) и атрибуцию источника.

Получение продукта по штрих-коду

Ищите упакованный продукт по его UPC или EAN штрих-коду.

Конечная точка: GET /v1/foods/barcode/{code}

Параметры:

Параметр	Тип	Обязательный	Описание
code	строка	Да	UPC (12-значный) или EAN (13-значный) штрих-код

Пример (Python):

response = requests.get(
    f"{BASE_URL}/foods/barcode/041331092609",
    headers={"X-Api-Key": API_KEY}
)

food = response.json()
print(f"{food['name']}: {food['calories']} ккал на {food['serving_description']}")

Анализ естественного языка

Парсите описание продукта на естественном языке и возвращайте структурированные данные о питательных веществах. Эта конечная точка обрабатывает количества, единицы измерения, методы приготовления и несколько элементов в одной строке.

Конечная точка: POST /v1/foods/analyze

Тело запроса:

{
  "query": "2 яиц всмятку с ломтиком цельнозернового тоста и половиной авокадо",
  "language": "en"
}

Пример (Python):

response = requests.post(
    f"{BASE_URL}/foods/analyze",
    headers={
        "X-Api-Key": API_KEY,
        "Content-Type": "application/json"
    },
    json={
        "query": "2 яиц всмятку с ломтиком цельнозернового тоста и половиной авокадо"
    }
)

result = response.json()
for item in result["items"]:
    print(f"{item['quantity']} {item['unit']} {item['name']}: {item['calories']} ккал")
print(f"Всего: {result['total']['calories']} ккал")

Пример ответа:

{
  "items": [
    {
      "name": "Яйца всмятку",
      "quantity": 2,
      "unit": "большие",
      "calories": 182,
      "protein_g": 12.2,
      "carbohydrates_g": 2.4,
      "fat_g": 13.6,
      "food_id": "nf_002891"
    },
    {
      "name": "Цельнозерновой тост",
      "quantity": 1,
      "unit": "ломтик",
      "calories": 81,
      "protein_g": 3.9,
      "carbohydrates_g": 13.8,
      "fat_g": 1.1,
      "food_id": "nf_003401"
    },
    {
      "name": "Авокадо",
      "quantity": 0.5,
      "unit": "средний",
      "calories": 120,
      "protein_g": 1.5,
      "carbohydrates_g": 6.4,
      "fat_g": 11.0,
      "food_id": "nf_000892"
    }
  ],
  "total": {
    "calories": 383,
    "protein_g": 17.6,
    "carbohydrates_g": 22.6,
    "fat_g": 25.7
  }
}

Распознавание продуктов с помощью AI (платный тариф)

Отправьте фотографию продукта для распознавания с помощью AI и анализа питательных веществ.

Конечная точка: POST /v1/foods/recognize

Запрос: Мультимедийные данные формы с файлом изображения или JSON-тело с изображением в формате base64.

Пример (Python):

with open("meal_photo.jpg", "rb") as f:
    response = requests.post(
        f"{BASE_URL}/foods/recognize",
        headers={"X-Api-Key": API_KEY},
        files={"image": ("meal.jpg", f, "image/jpeg")}
    )

result = response.json()
for item in result["detected_items"]:
    print(f"{item['name']} ({item['confidence']:.1%}): {item['calories']} ккал")

Ответ включает обнаруженные продукты с оценками уверенности, координатами ограничивающего прямоугольника, оценочными размерами порций, разбивкой питательных веществ по элементам и общей питательной сводкой для блюда.

Лимиты запросов и обработка ошибок

Лимиты запросов по тарифам

Тариф	Запросы в день	Запросы/секунда	AI распознавание	Цена
Бесплатный	500	5	Не включено	$0
Стартовый	5,000	10	100/день	$29/месяц
Профессиональный	50,000	25	1,000/день	$99/месяц
Корпоративный	Индивидуально	Индивидуально	Индивидуально	Связаться с отделом продаж

Заголовки лимитов запросов

Каждый ответ включает заголовки лимитов запросов:

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 487
X-RateLimit-Reset: 1710374400

Ответы с ошибками

API использует стандартные коды состояния HTTP с описательными телами ошибок.

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Превышен лимит запросов в день: 500. Сброс в 00:00 UTC.",
    "status": 429
  }
}

Код состояния	Значение
200	Успех
400	Неверный запрос (недопустимые параметры)
401	Неавторизован (недействительный или отсутствующий API-ключ)
404	Продукт не найден
429	Превышен лимит запросов
500	Внутренняя ошибка сервера

Реализуйте экспоненциальное увеличение времени ожидания для ответов 429 и 500. Простая стратегия — ждать 1 секунду после первого сбоя, 2 секунды после второго, 4 после третьего, до максимума в 60 секунд.

Сценарии использования и шаблоны реализации

Приложения для планирования питания

Создайте планировщик питания, который достигает целевых макронутриентов, итерируя продукты, вычисляя общую питательность и подбирая блюда, пока план не соответствует целям пользователя.

def find_foods_for_target(target_protein, target_calories):
    """Найти продукты с высоким содержанием белка в пределах калорийного бюджета."""
    response = requests.get(
        f"{BASE_URL}/foods/search",
        headers={"X-Api-Key": API_KEY},
        params={
            "query": "высокий белок",
            "limit": 20,
            "type": "common"
        }
    )

    foods = response.json()["foods"]
    # Фильтрация по соотношению белка и калорий
    efficient_foods = [
        f for f in foods
        if f["protein_g"] / max(f["calories"], 1) > 0.15
    ]
    return sorted(efficient_foods, key=lambda f: f["protein_g"], reverse=True)

Интеграция с фитнес-приложением

Сопоставьте данные активности, чтобы показать пользователям их калорийный баланс. Используйте конечную точку естественного языка для быстрого логирования.

async function logMealFromText(description) {
  const response = await fetch(`${BASE_URL}/foods/analyze`, {
    method: "POST",
    headers: {
      "X-Api-Key": API_KEY,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ query: description })
  });

  const data = await response.json();

  // Сохраните в вашей базе данных
  await db.meals.insert({
    user_id: currentUser.id,
    items: data.items,
    total_calories: data.total.calories,
    total_protein: data.total.protein_g,
    timestamp: new Date()
  });

  return data;
}

Калькулятор питательных веществ рецептов

Вычислите питательную ценность рецепта, ища каждый ингредиент и суммируя значения.

def analyze_recipe(ingredients):
    """
    ingredients: список строк, например ["200г куриной грудки", "1 стакан коричневого риса", "2 ст. ложки оливкового масла"]
    """
    recipe_nutrition = {"calories": 0, "protein_g": 0, "carbohydrates_g": 0, "fat_g": 0}

    for ingredient in ingredients:
        response = requests.post(
            f"{BASE_URL}/foods/analyze",
            headers={
                "X-Api-Key": API_KEY,
                "Content-Type": "application/json"
            },
            json={"query": ingredient}
        )
        data = response.json()
        for item in data["items"]:
            recipe_nutrition["calories"] += item["calories"]
            recipe_nutrition["protein_g"] += item["protein_g"]
            recipe_nutrition["carbohydrates_g"] += item["carbohydrates_g"]
            recipe_nutrition["fat_g"] += item["fat_g"]

    return recipe_nutrition

# Пример использования
recipe = analyze_recipe([
    "200г куриной грудки",
    "1 стакан коричневого риса, приготовленного",
    "2 столовые ложки оливкового масла",
    "1 стакан приготовленного брокколи"
])
print(f"Общая питательность рецепта: {recipe['calories']} ккал, {recipe['protein_g']}г белка")

Исследования и анализ данных

Для академических исследований используйте API для создания профилей питания для исследуемых групп или проверки инструментов оценки рациона.

import pandas as pd

def build_nutrition_profile(food_log_df):
    """
    food_log_df: DataFrame с колонками ['food_description', 'date']
    Возвращает DataFrame с полным разбором питательных веществ для каждой записи.
    """
    results = []

    for _, row in food_log_df.iterrows():
        response = requests.post(
            f"{BASE_URL}/foods/analyze",
            headers={
                "X-Api-Key": API_KEY,
                "Content-Type": "application/json"
            },
            json={"query": row["food_description"]}
        )
        data = response.json()
        results.append({
            "date": row["date"],
            "description": row["food_description"],
            "calories": data["total"]["calories"],
            "protein_g": data["total"]["protein_g"],
            "carbs_g": data["total"]["carbohydrates_g"],
            "fat_g": data["total"]["fat_g"]
        })

    return pd.DataFrame(results)

Сравнение с альтернативными API

USDA FoodData Central API

API USDA полностью бесплатен без платных тарифов, что делает его стандартным выбором для академических и государственных проектов. Он охватывает примерно 370,000 продуктов из баз данных Foundation, SR Legacy, Survey (FNDDS) и Branded. Сильные стороны включают в себя то, что он является золотым стандартом для данных о составе пищи в США, на которые ссылаются другие базы данных. Ограничения включают отсутствие парсинга естественного языка (необходимо сопоставлять названия продуктов с их конкретными ключами в базе данных), отсутствие поиска по штрих-коду, отсутствие AI-распознавания, а также данные о брендированных продуктах могут быть непоследовательными, поскольку они зависят от заявлений производителей. Документация API функциональна, но не очень удобна для разработчиков по современным стандартам.

Лучше всего подходит для: Академических исследований, государственных проектов, приложений, которым нужны авторитетные справочные данные и есть ресурсы для обработки сложности сопоставления.

Nutritionix API

Nutritionix имеет одну из самых больших баз данных продуктов с хорошим охватом ресторанной и брендированной пищи. Его конечная точка естественного языка хорошо развита и обрабатывает сложные запросы. Однако бесплатный тариф крайне ограничен — 50 запросов в день, а платные планы начинаются с $299 в месяц, что делает его недоступным для многих независимых разработчиков и малых стартапов. API хорошо документирован и поддерживает как текстовый, так и штрих-кодовый поиск.

Лучше всего подходит для: Хорошо финансируемых приложений, которым нужны обширные данные о ресторанах и которые могут позволить себе такую цену.

Edamam API

Edamam предлагает API для анализа питания, анализа рецептов и баз данных продуктов. Бесплатный тариф предоставляет 100 запросов в день, что подходит для прототипирования. Сильная сторона Edamam — это возможность анализа рецептов, которая может обрабатывать полный список ингредиентов рецепта и возвращать данные о питательных веществах на порцию. База данных охватывает примерно 900,000 продуктов. Ограничения включают в себя периодические несоответствия в данных о размерах порций и менее интуитивно понятный опыт для разработчиков по сравнению с более новыми API.

Лучше всего подходит для: Приложений, ориентированных на рецепты, инструментов для планирования питания, которым нужен анализ на уровне рецептов.

FatSecret Platform API

FatSecret предлагает щедрый бесплатный тариф с 5,000 запросов в день, что делает его привлекательным для проектов с ограниченным бюджетом. Недостаток в том, что вы должны отображать брендинг и атрибуцию FatSecret в вашем приложении. База данных охватывает примерно 500,000 продуктов с хорошим международным охватом. API поддерживает аутентификацию OAuth 1.0, которая устарела и сложнее в реализации, чем подходы с API-ключами или OAuth 2.0.

Лучше всего подходит для: Проектов с ограниченным бюджетом, которые могут учесть требования к атрибуции и OAuth 1.0.

Open Food Facts API

Open Food Facts — это управляемая сообществом, открытая база данных продуктов с более чем 3 миллионами товаров, в основном упакованных продуктов с данными о штрих-кодах. Она полностью бесплатна и открыта (Open Database License). API прост в использовании для поиска по штрих-кодам, но менее структурирован для поисковых запросов о питательных веществах. Качество данных варьируется, поскольку взносы осуществляются сообществом, хотя процесс проверки сообщества ловит многие ошибки.

Лучше всего подходит для: Сканирования штрих-кодов упакованных продуктов, проектов, которые соответствуют принципам открытого исходного кода, международного охвата упакованных продуктов.

Сводка сравнения API

Функция	Nutrola	USDA	Nutritionix	Edamam	FatSecret	Open Food Facts
Лимит бесплатного тарифа в день	500	1,000/час	50	100	5,000	Неограниченно
Парсинг естественного языка	Да	Нет	Да	Да	Нет	Нет
AI распознавание продуктов	Да (платно)	Нет	Нет	Нет	Нет	Нет
Поиск по штрих-коду	Да	Нет	Да	Нет	Да	Да
Поддержка нескольких языков	8 языков	Английский	Английский	Английский	16 языков	40+ языков
Анализ рецептов	Через NLP	Нет	Да	Да	Нет	Нет
Глубина микроэлементов	30+ питательных веществ	60+ питательных веществ	20+ питательных веществ	25+ питательных веществ	15+ питательных веществ	Варьируется
Аутентификация	API-ключ	API-ключ	API-ключ	ID приложения + ключ	OAuth 1.0	Нет (по желанию)

Лучшие практики для создания приложений о питании

Агрессивное кэширование

Данные о питательных веществах для обычных продуктов не меняются часто. Кэшируйте результаты поиска продуктов и запросы о питательных веществах на вашем сервере в течение 24-72 часов, чтобы сократить количество запросов к API и улучшить время отклика.

Корректная обработка отсутствующих данных

Не каждый продукт имеет полные данные о микроэлементах. Проектируйте свой интерфейс так, чтобы указывать, когда данные недоступны, а не отображать нули, которые пользователи могут неверно интерпретировать как "этот продукт не содержит железа".

Валидация пользовательского ввода перед запросами к API

Обрезайте пробелы, нормализуйте единицы измерения и проверяйте правильность написания названий продуктов перед отправкой их в API. Хорошо сформулированный запрос дает гораздо лучшие результаты, чем запрос с опечатками.

Используйте конечную точку естественного языка, когда это возможно

Вместо того чтобы создавать собственный парсер названий продуктов, используйте конечную точку /foods/analyze. Она лучше обрабатывает количества ("2 чашки"), методы приготовления ("жареный") и сложные описания ("цельнозерновой тост с маслом"), чем большинство пользовательских реализаций.

Соблюдайте лимиты запросов

Реализуйте правильную логику увеличения времени ожидания. Пакетируйте операции, где это возможно. Используйте вебхуки или очереди для операций с высоким объемом вместо синхронных запросов к API.

Атрибутируйте источники данных

Хорошей практикой (а иногда и юридическим требованием в зависимости от API) является атрибуция источника данных. Отображайте "Данные о питательных веществах предоставлены Nutrola" или эквивалент для любого используемого вами API.

Часто задаваемые вопросы

Действительно ли Nutrola API бесплатен?

Да. Бесплатный тариф предоставляет 500 запросов к API в день без каких-либо затрат и без необходимости указывать данные кредитной карты. Этого достаточно для прототипирования, небольших приложений и личных проектов. Бесплатный тариф включает текстовый поиск, поиск продуктов по ID, сканирование штрих-кодов и анализ на естественном языке. Распознавание продуктов с помощью AI доступно на платных тарифах, начиная с $29 в месяц.

В каком формате возвращает API данные?

Все ответы возвращаются в формате JSON с кодировкой UTF-8. Питательные значения используют стандартные единицы: килокалории для энергии, граммы для макронутриентов и клетчатки, миллиграммы для натрия и большинства минералов, и микрограммы для витаминов, где это применимо.

Могу ли я использовать Nutrola API в коммерческом приложении?

Да. Оба тарифа — бесплатный и платный — разрешают коммерческое использование. Бесплатный тариф требует атрибуции Nutrola в вашем приложении. Платные тарифы включают опции без атрибуции, где она не требуется.

Как часто обновляется база данных продуктов?

База данных продуктов Nutrola обновляется непрерывно для брендированных и ресторанных продуктов, с синхронизацией данных USDA в течение 30 дней после их выпуска. Основные обновления базы данных происходят ежемесячно, в то время как отдельные записи продуктов могут обновляться ежедневно на основе изменений от производителей, исправлений, сообщаемых пользователями, и новых запусков продуктов.

Поддерживает ли API международные продукты?

Да. База данных охватывает продукты из более чем 50 стран, с поиском на 8 языках (английский, испанский, немецкий, французский, португальский, японский, корейский и китайский). Международный охват продуктов является основным приоритетом Nutrola, и база данных включает региональные блюда, местные брендированные продукты и специфические для кухни приготовления, которые часто отсутствуют в базах данных, ориентированных на США.

Могу ли я использовать API для мобильного приложения?

Да, но не встраивайте свой API-ключ непосредственно в клиентский код мобильного приложения, так как его можно извлечь из бинарного файла приложения. Вместо этого настройте легкий сервер на стороне, который будет проксировать запросы к Nutrola API и обрабатывать аутентификацию. Это также даст вам уровень для кэширования и управления запросами.

Есть ли вебхуки или потоковые опции?

В настоящее время API работает по модели запрос-ответ. Поддержка вебхуков для асинхронных результатов распознавания продуктов (для больших пакетных обработок) запланирована на 2026 год. Для пакетных операций сегодня используйте конечную точку /v1/foods/analyze/batch, которая принимает до 20 элементов в одном запросе.

Заключение

Nutrition API сделали возможным для разработчиков создание приложений, учитывающих питание, без огромных затрат на поддержание собственной базы данных продуктов. API Nutrola предлагает щедрый бесплатный тариф, обширное покрытие продуктов из международной кухни, понимание естественного языка и опциональное распознавание продуктов с помощью AI, что делает его отличным выбором для проектов — от прототипов на выходные до производственных приложений.

Лучший API для вашего проекта зависит от ваших конкретных потребностей: USDA для авторитетных справочных данных, Nutritionix для глубокого охвата ресторанов, Open Food Facts для открытых данных о штрих-кодах или Nutrola для баланса функций, точности и опыта разработчиков. Во многих случаях комбинирование нескольких API дает вам лучшее покрытие. Начните с бесплатного тарифа, проверьте его на соответствие вашим требованиям и масштабируйте с этого момента.