Nutrition Tracker API - Python SDK

Simple Python wrapper for the Nutrition Tracker API - Get 25+ nutrients from natural language food queries.

Features

• ✅ 25+ nutrients in every response (including free tier)
• ✅ Natural language input - "100g chicken breast and 1 cup rice"
• ✅ Hierarchical fat breakdown - saturated, mono, poly, trans, other
• ✅ USDA data source - laboratory-analyzed, peer-reviewed
• ✅ <100ms response time - edge-cached for speed

Installation

pip install requests

Then copy nutrition_api.py to your project, or clone this repo:

git clone https://github.com/myProjectsRavi/nutrition-api-python.git

Quick Start

1. Get Your API Key

Get your free API key from RapidAPI

2. Use the SDK

from nutrition_api import NutritionAPI

# Initialize with your RapidAPI key
api = NutritionAPI(api_key="YOUR_RAPIDAPI_KEY")

# Calculate nutrition for any food
result = api.calculate("100g grilled chicken breast")

# Access the data
print(f"Calories: {result['Energy']['value']} {result['Energy']['unit']}")
print(f"Protein: {result['Protein']['value']} {result['Protein']['unit']}")
print(f"Fat: {result['Fat']['value']} {result['Fat']['unit']}")

3. Multi-Item Meals

# Calculate nutrition for entire meals
result = api.calculate("2 eggs, 100g oatmeal, and 1 banana")

# All nutrients are aggregated automatically
for nutrient, data in result.items():
    print(f"{nutrient}: {data['value']} {data['unit']}")

API Response

The API returns 25+ nutrients:

{
    "Energy": {"value": 156, "unit": "kcal"},
    "Protein": {"value": 31.02, "unit": "g"},
    "Fat": {
        "value": 3.57,
        "unit": "g",
        "breakdown": {
            "saturated": {"value": 1.01, "unit": "g"},
            "monounsaturated": {"value": 1.24, "unit": "g"},
            "polyunsaturated": {"value": 0.77, "unit": "g"},
            "other": {"value": 0.55, "unit": "g"}
        }
    },
    "Vitamin B-6": {"value": 0.6, "unit": "mg"},
    "Vitamin B-12": {"value": 0.34, "unit": "µg"},
    "Iron, Fe": {"value": 1.04, "unit": "mg"},
    # ... 20+ more nutrients
}

Error Handling

from nutrition_api import NutritionAPI, NutritionAPIError

api = NutritionAPI(api_key="YOUR_RAPIDAPI_KEY")

try:
    result = api.calculate("100g chicken")
except NutritionAPIError as e:
    print(f"API Error: {e.message}")
    print(f"Status Code: {e.status_code}")

Pricing

Tier	Price	API Calls/Month	Items/Request
Free	$0	1,000	2
Starter	$30	50,000	5
Business	$50	100,000	10

All tiers include the same 25+ nutrients!

Links

• 📖 Full Documentation
• 🚀 Get API Key
• 🐛 Report Issues

License

MIT License - see LICENSE for details.