About
Upload food images and receive detailed nutritional analysis powered by AI. The Nutrition API uses advanced computer vision and machine learning to identify ingredients, calculate nutritional values, and provide comprehensive food composition data.Getting Started
- Get an access token using the authentication flow (see Authentication)
- Upload base64-encoded food images using the POST endpoint
- Retrieve results either synchronously or via webhook notifications
Key Features
AI-Powered Analysis
- Advanced computer vision for food identification
- LANGUAL standard terminology for precise ingredient classification
- Machine learning models for accurate nutritional calculations
Flexible Processing
- Asynchronous processing (recommended) — returns immediately with background processing
- Synchronous processing — waits for complete analysis before returning results
- Webhook notifications — for real-time status updates
Comprehensive Data
- 29 nutritional fields from basic macros to detailed micronutrients
- Ingredient breakdown with per-item nutritional analysis
- Nutri-Score rating (A-E European scale)
- Localized results with country and language support
Technical Requirements
Image Specifications
- Minimum size — 512×512 pixels
- Maximum size — 10MB when base64-encoded
- Supported formats — JPEG, PNG, WebP
- Input format — base64-encoded string
Processing Workflow
- Image Upload & Validation — system validates format compatibility
- AI Model Processing — multiple AI models are used for analysis
- Ingredient Identification — foods identified using LANGUAL terminology
- Nutritional Analysis — detailed breakdown calculated per 100 g/ml
- Translation (optional) — results translated to specified language
- Storage — results stored with a configurable retention policy
Analysis Report Data
Main Data
- Dish name with optional translation
- Dish description with optional translation
- Nutri-Score level (A-E)
- Serving size with unit (g/ml)
Basic Nutritional Fields
- Energy (kcal)
- Protein (g)
- Total Fat (g)
- Carbohydrates (g)
Extended Nutritional Data
- Fats — saturated, polyunsaturated, monounsaturated, trans fats
- Micronutrients — fiber, sugars, cholesterol
- Minerals — sodium, potassium, calcium, iron, magnesium, phosphorus, zinc
- Vitamins — A, C, D, E, K, B-complex vitamins
Image Guidelines
For optimal analysis results, guide your users to:- Center the food — capture the contents of the plate as the main subject
- Fill the frame — ensure the meal occupies the majority of the image
- Remove distractions — take off packaging or utensils before photographing
- Clean background — keep background clutter-free, include only the plate
- Use proper lighting — natural or bright lighting to capture food details clearly
- Optimal angle — slight angle to minimize items obscuring each other
- Avoid filters — don’t use filters that might alter the food’s appearance
Implementation
For detailed implementation examples, request/response schemas, and code samples, see:- Implementation Guide — complete code examples and integration patterns
- Asynchronous Processing — real-time notifications and webhook implementation
- API Reference — detailed endpoint specifications and data types