API Documentation

Overview

The Food Nutrition Analyzer API provides endpoints for analyzing food images and retrieving nutritional information. Our API is RESTful and returns JSON responses.

Base URL: https://api.foodnutritionanalyzer.com

Authentication

API requests require authentication using an API key. Include your API key in the request headers:

Authorization: Bearer YOUR_API_KEY

POST /api/analyze

Analyzes a food image and returns detailed nutritional information.

Request

Content-Type: multipart/form-data
Body: FormData with 'image' field

Parameters

  • image (required): Image file (JPEG, PNG, max 16MB)

Response

{
  "nutritional_info": [
    {
      "item": "Chicken Breast",
      "confidence": 0.95,
      "portion_ratio": 1.0,
      "standard_portion": 100,
      "nutrition": {
        "calories": 165,
        "protein": 31,
        "carbs": 0,
        "fat": 3.6,
        "fiber": 0,
        "sugar": 0,
        "sodium": 74,
        "potassium": 256,
        "source": "USDA",
        "category": "Protein"
      }
    }
  ],
  "image_url": "https://images.unsplash.com/photo-1546069901-ba9599a7e63c"
}

Error Responses

400 Bad Request
Invalid file type or missing image
401 Unauthorized
Invalid or missing API key
500 Internal Server Error
Server error during processing

GET /api/search

Search for nutritional information by food name.

Parameters

  • q (required): Food name to search
  • limit (optional): Maximum results (default: 10)

Example Request

GET /api/search?q=chicken&limit=5

Response

{
  "results": [
    {
      "name": "Chicken Breast",
      "nutrition": {
        "calories": 165,
        "protein": 31,
        "carbs": 0,
        "fat": 3.6
      },
      "source": "USDA"
    }
  ],
  "total": 1
}

Rate Limits

100
Requests per hour
1000
Requests per day
16MB
Max file size

SDK & Libraries

JavaScript/Node.js

npm install nutri-wise

Python

pip install nutri-wise