Skip to content

Simple Sugar Intake Calculator API

Estimate recommended simple sugar intake and stricter intake target based on energy demand.

Endpoint

  • GET /api/v1/ss-intake-calculator
  • POST /api/v1/ss-intake-calculator/post

Parameters

Name Type Required In Description
sex string Yes Query/Body male or female.
age number (>0) Yes Query/Body Age in years.
height number (>0) Yes Query/Body Height in cm (metric) or inches (imperial).
weight number (>0) Yes Query/Body Weight in kg (metric) or lb (imperial).
activity_level string Yes Query/Body sedentary,lightly_active,moderately_active,very_active,extra_active.
unit string No Query/Body metric (default) or imperial.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Translate energy needs into daily sugar guidance.
  • Provide strict and practical intake targets in one response.
  • Support nutrition products with quality guardrails.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/ss-intake-calculator?sex=female&age=30&height=167&weight=68&activity_level=moderately_active&unit=metric&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/ss-intake-calculator/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"sex":"male","age":36,"height":71,"weight":186,"activity_level":"very_active","unit":"imperial"}'

Response Example

Info

The response example below is for demonstration purposes only. Make a live request to this endpoint to receive the full, real-time, and potentially richer JSON structure.

{
  "sex": "female",
  "age": 30.0,
  "height_cm": 167.0,
  "weight_kg": 68.0,
  "unit": "metric",
  "activity_level": "moderately_active",
  "tdee_kcal_per_day": 2197.5,
  "simple_sugar_intake_g": 54.94,
  "strict_simple_sugar_target_g": 27.47,
  "sugar_band": "moderate",
  "sugar_band_label": "Moderate",
  "intake_context": "Moderate activity sugar budget.",
  "action_plan": ["Keep added sugars within target window"],
  "quality_guardrails": ["Prefer whole-food carbohydrate sources"],
  "monitoring_plan": "Track weekly average intake against target.",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "c7f9b469076db8a3", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "ss_intake_calculator", "response_language": "en"}
}

Product Positioning

A practical endpoint for sugar-awareness apps, meal planning, and preventive nutrition workflows.

Note

All profile fields (sex,age,height,weight,activity_level) are required.