API Reference

Introduction

The Food Nutrients API allows you to analyze food images and get detailed nutritional information. This reference provides all the details you need to integrate with our API.

Base URL: https://tastyapi.com

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header as a Bearer token.

Authorization: Bearer YOUR_API_KEY

You can get an API key by subscribing to one of our plans.

Endpoints

The TastyAPI provides the following endpoints:

• POST /analyze-image - Analyze food images and get nutritional information
• GET /api/usage - Check your subscription usage and limits
• POST /api/subscription/cancel - Cancel your active subscription

{
  "analysis": {
    "foodName": "Grilled Chicken Salad with Balsamic Vinaigrette",
    "servingSize": {
      "amount": 250,
      "unit": "g"
    },
    "nutrients": {
      "calories": {
        "amount": 350,
        "unit": "kcal"
      },
      "protein": {
        "amount": 30,
        "unit": "g"
      },
      "carbohydrates": {
        "amount": 15,
        "unit": "g"
      },
      "fat": {
        "amount": 20,
        "unit": "g"
      },
      // Additional nutrients...
    },
    "dietaryInfo": {
      "isVegetarian": false,
      "isVegan": false,
      "isGlutenFree": true,
      // Additional dietary information...
    }
  }
}

{
  "error": "No image file provided"
}

{
  "error": "Invalid or expired token",
  "paymentUrl": "https://example.com/checkout"
}

{
  "status": "active",
  "plan": "Professional",
  "usage": {
    "total": 15000,
    "used": 1247,
    "remaining": 13753,
    "percentUsed": 8.31
  },
  "subscription": {
    "created": "2024-01-15T10:30:00Z",
    "expires": "2024-02-15T10:30:00Z",
    "daysRemaining": 18
  }
}

{
  "error": "Invalid or expired token"
}

{
  "success": true,
  "message": "Subscription cancelled successfully. Access will continue until the end of your current billing period.",
  "cancellationEffective": "2024-02-15T10:30:00Z"
}

{
  "error": "Subscription is already cancelled or does not exist"
}

{
  "error": "Invalid or expired token"
}

Response Format

POST /analyze-image

The API returns nutritional information in JSON format. Here's a description of the main fields:

GET /api/usage

This endpoint returns subscription usage information. Here's a description of the fields:

POST /api/subscription/cancel

This endpoint cancels your subscription. Here's a description of the response fields:

Code Examples

Analyze Image

curl -X POST https://tastyapi.com/analyze-image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@./path/to/food-image.jpg"

Check Usage

curl -X GET https://tastyapi.com/api/usage \
  -H "Authorization: Bearer YOUR_API_KEY"

Cancel Subscription

curl -X POST https://tastyapi.com/api/subscription/cancel \
  -H "Authorization: Bearer YOUR_API_KEY"

JavaScript/Node.js Example

// Browser/Frontend Example
async function analyzeImage(file) {
  const formData = new FormData();
  formData.append('image', file);

  try {
    const response = await fetch('https://tastyapi.com/analyze-image', {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      },
      body: formData
    });

    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }

    const data = await response.json();
    console.log('Analysis result:', data);
    return data;
  } catch (error) {
    console.error('Error analyzing image:', error);
    return { error: error.message };
  }
}

// Node.js Example with FormData
const FormData = require('form-data');
const fs = require('fs');

async function analyzeImageNode(imagePath) {
  const formData = new FormData();
  formData.append('image', fs.createReadStream(imagePath));

  try {
    const response = await fetch('https://tastyapi.com/analyze-image', {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        ...formData.getHeaders()
      },
      body: formData
    });

    const data = await response.json();
    console.log('Analysis result:', data);
    return data;
  } catch (error) {
    console.error('Error:', error);
    return { error: error.message };
  }
}

// Check Usage
async function checkUsage() {
  try {
    const response = await fetch('https://tastyapi.com/api/usage', {
      headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
    });
    const data = await response.json();
    console.log('Usage data:', data);
    return data;
  } catch (error) {
    console.error('Error checking usage:', error);
  }
}

// Cancel Subscription
async function cancelSubscription() {
  try {
    const response = await fetch('https://tastyapi.com/api/subscription/cancel', {
      method: 'POST',
      headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
    });
    const data = await response.json();
    console.log('Cancellation result:', data);
    return data;
  } catch (error) {
    console.error('Error cancelling subscription:', error);
  }
}

Python Example

import requests

def analyze_image():
    url = "https://tastyapi.com/analyze-image"
    headers = {
        "Authorization": "Bearer YOUR_API_KEY"
    }
    
    try:
        with open("path/to/food-image.jpg", "rb") as image_file:
            files = {
                "image": image_file
            }
            response = requests.post(url, headers=headers, files=files)
        
        try:
            data = response.json()
            print("Analysis result:", data)
            return data
        except Exception as e:
            return {
                "status_code": response.status_code,
                "raw_response": response.text,
                "json_error": str(e)
            }
        
    except FileNotFoundError:
        return {"error": "Image file not found", "status_code": 404}
    except Exception as e:
        return {"error": str(e), "status_code": 500}

# Usage example
result = analyze_image()

# Check Usage
usage_response = requests.get("https://tastyapi.com/api/usage", 
                            headers={"Authorization": "Bearer YOUR_API_KEY"})
usage_data = usage_response.json()
print("Usage data:", usage_data)

# Cancel Subscription
cancel_response = requests.post("https://tastyapi.com/api/subscription/cancel", 
                               headers={"Authorization": "Bearer YOUR_API_KEY"})
cancel_data = cancel_response.json()
print("Cancel result:", cancel_data)

Rate Limits

API calls are limited based on your subscription plan: