API

Health Calculator API

The Health Calculator API is a comprehensive tool for health-related calculations, providing accurate insights into body composition, nutrition, fitness metrics, and more. Ideal for healthcare professionals, fitness enthusiasts, and individuals seeking customized health information, this API enables easy integration of health metrics for personalized, data-driven wellness insights.

The API caters to a wide range of programming languages, including but not limited to: C, Clojure, C#, GO, Java, JavaScript, Kotlin, Node.js, Objective-C, OCaml, PHP, PowerShell, Python, R, RapidQL, Ruby, Shell, and Swift.

Introduction

API Overview

Harness the Health Calculator API to enhance your applications with health-focused metrics, enabling better user engagement, personalized insights, and informed health decisions. For more details, visit Health Calculator API on RapidAPI.

Key Features:

A Body Shape Index (ABSI): Evaluate body shape and associated health risks.

Adjusted Body Weight (AjBW): Calculate a personalized ideal body weight.

Body Adiposity Index (BAI): Estimate body fat percentage for effective health tracking.

Body Frame Size Index (BFSI): Determine body frame size to better tailor fitness plans.

Body Mass Index (BMI): Calculate body fat based on height and weight.

Body Fat Percentage: Accurately measure body fat composition.

Basal Metabolic Rate (BMR): Understand daily energy needs at rest.

Daily Caloric Needs (DCN): Customize calorie intake for weight goals.

Daily Water Intake (DWI): Calculate optimal hydration requirements.

Fat-Free Mass Index (FFMI): Evaluate muscle development for fitness progress.

Target Heart Rate (THR): Set ideal heart rates for effective workouts.

Macronutrient Distribution: Get balanced nutrition insights into carbs, proteins, and fats.

Ideal Body Weight (IBW): Determine optimal weight ranges for better health outcomes.

Additional Highlights:

Comprehensive Health Metrics: Access a range of calculations for personalized insights.

User-Centric Design: Tailored for healthcare, fitness, and personal use applications.

Precision & Accuracy: Developed for precise health measurements and reliable data.

Easy Integration: Smooth integration with extensive documentation for seamless use.

Endpoints

Endpoints Overview

Ideal Body Weight (IBW)

These endpoint allows you to calculate the ideal weight range based on factors like height, body frame size, and gender. The endpoints provides different formulas and approaches for ideal weight estimation, such as the Hamwi method and the Devine formula.

Parameters

Parameter	Type	Required	Description
height	int	Yes	The height in centimeters (cm) of the person for whom you want to calculate the ideal weight.
body_frame	string	Yes	The body frame size of the person. It can be one of the following values: "small", "medium", or "large".
gender	string	Yes	The gender of the person. It can be either "male" or "female".
formula	string	Optional	You can include an optional query parameter to specify the formula or approach for ideal weight estimation. It can be one of the following values: "hamwi" (default): The Hamwi method for ideal weight calculation. "devine": The Devine formula for ideal weight calculation.

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/ibw"
querystring = {"height":"175","body_frame":"medium","gender":"male","formula":"hamwi"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"ideal_weight":"48.64 kg"
}

A Body Shape Index (ABSI)

These ABSI Calculator endpoints allow you to calculate the A Body Shape Index (ABSI) and its corresponding z-score and mortality risk based on the provided parameters.

Note: This calculator uses the ABSI mean and standard deviation data for each age and sex bracket from the data available for the population of [NHANES].

Parameters

Parameter	Type	Required	Description
sex	string	Yes	The gender of the individual. Accepted values are 'male' and 'female'.
age	int	Yes	The age of the individual in years.
height	int	Yes	The height of the individual in centimeters for 'metric' unit, and inches for 'imperial' unit.
weight	int	Yes	The weight of the individual in kilograms. for 'metric' unit, and pounds for 'imperial' unit
waist_circumference	int	Yes	The waist circumference of the individual in centimeters for 'metric' unit, and inches for 'imperial' unit.
unit	string	Optional	The unit of measurement used for height, weight, and waist circumference. Accepted values are 'metric' (default) and 'imperial'. If 'imperial' is used, the height should be in inches, weight in pounds, and waist circumference in inches.

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/absi"
querystring = {"sex":"male","age":"60","height":"180","weight":"78","waist_circumference":"80","unit":"metric"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"ABSI":0.0715,
"ABSI z-score":-3.5473,
"Age":60,
"Mortality risk":"Very low",
"Sex":"male"
}

Body Fat Percentage (BFP)

These endpoints calculate the body fat percentage based on the provided gender, age, height, and weight parameters.

Parameters

Parameter	Type	Required	Description
gender	string	Yes	The gender of the individual. Accepted values are 'male' and 'female'.
age	int	Yes	The age of the individual in years.
height	int	Yes	The height of the individual in centimeters.
weight	int	Yes	The weight of the individual in kilograms.
unit	string	Optional	The desired units of measurement to implement in the JSON Response. Possible values are metric (default) or imperial. (Optional).

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/bodyfat"
querystring = {"gender":"female","age":"27","height":"165","weight":"78","unit":"metric"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"age": 27.0,
" bmi":"28.7 kg/m²"
"bodyfat": "35.19 %",
"bodyfat_status": "Obese",
"gender": "female",
"height": "1.7 m",
"weight": "78.0 kg"
}

Body Fat Percentage (BFP) US Army

The US Army Body Fat Calculator is designed to calculate the body fat percentage of individuals based on the [U.S. Army Standards of Medical Fitness].

Parameters

Parameter	Type	Required	Description
sex	string	Yes	The gender of the individual. Accepted values are 'male' and 'female'.
age	int	Yes	The age of the individual in years.
height	int	Yes	Height of the individual in centimeters.
neck	int	Yes	Neck circumference of the individual in centimeters.
waist	int	Yes	Waist circumference of the individual in centimeters.
hip	string	Optional	Hip circumference of the individual in centimeters. This parameter is only required for females.

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/bodyfat/army"
querystring = {"sex":"male","age":"32","height":"175","waist":"60","neck":"15","hip":"0"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"Army_BFP":"15.38%",
"Compliance":"Compliant"
}

Body Fat Percentage (BFP) US Navy

The US Navy Body Fat Calculator is designed to calculate the body fat percentage of individuals based on the [U.S. Navy body fat standards].

Parameters

Parameter	Type	Required	Description
sex	string	Yes	The gender of the individual. Accepted values are 'male' and 'female'.
age	int	Yes	The age of the individual in years.
height	int	Yes	Height of the individual in centimeters.
neck	int	Yes	Neck circumference of the individual in centimeters.
waist	int	Yes	Waist circumference of the individual in centimeters.
hip	string	Optional	Hip circumference of the individual in centimeters. This parameter is only required for females.

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/bodyfat/navy"
querystring = {"sex":"female","age":"25","height":"170","waist":"75","neck":"35","hip":"90"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"Compliance":"Compliant",
"Navy_BFP":"21.99%"
}

Basal Metabolic Rate (BMR)

These endpoints calculate BMR based on age, weight, height, and gender parameters.
And return the BMR value, which represents the number of calories needed to maintain basic bodily functions at rest.

Parameters

Parameter	Type	Required	Description
gender	string	Yes	The gender of the individual. Accepted values are 'male' and 'female'.
age	int	Yes	The age of the individual in years.
height	int	Yes	The height of the individual in centimeters.
weight	int	Yes	The weight of the individual in kilograms.
equation	string	Optional	The equation to use for the calculation. Valid options are "mifflin" (default) or "harris".

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/bmr"
querystring = {"age":"30","weight":"60","height":"175","gender":"male","equation":"mifflin"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"bmr":"1548.75 kcal/day"
}

Body Mass Index (BMI)

These endpoints calculate the Body Mass Index (BMI) and weight status based on the provided height and weight.

Parameters

Parameter	Type	Required	Description
height	int	Yes	The height of the individual in centimeters.
weight	int	Yes	The weight of the individual in kilograms.
units	string	Optional	The desired units of measurement to implement in the JSON Response. Possible values are metric (default) or imperial. (Optional).

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/bmi"
querystring = {"height":"170","weight":"80","units":"metric"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"bmi":"27.7 kg/m²",
"height":"1.7 m",
"weight":"80.0 kg",
"weight_status":"Overweight"
}

Daily Caloric Needs (DCN)

These endpoints provide a simple and efficient way to calculate daily caloric needs based on various factors such as age, weight, height, activity level, and goal.

The endpoints offer different formulas or approaches for caloric needs estimation, including the popular Harris-Benedict equation and Mifflin-St. Jeor equation.

Parameters

Parameter	Type	Required	Description
gender	string	Yes	The gender of the individual. Accepted values are 'male' and 'female'.
age	int	Yes	The age of the individual in years.
height	int	Yes	The height of the individual in centimeters.
activity_level	string	Yes	The activity level of the person. Valid values are "sedentary", "lightly_active", "moderately_active", "very_active", or "extra_active".
goal	string	Yes	The goal of the person. Valid values are "weight_loss", "maintenance", or "weight_gain".
weight	int	Yes	The weight of the individual in kilograms.
equation	string	Optional	The equation to use for caloric needs estimation. Valid values are "harris" (default) or "mifflin".

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/dcn"
querystring = {"age":"30","weight":"60","height":"170","gender":"male","activity_level":"sedentary","goal":"maintenance","equation":"mifflin"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"caloric_needs": {
"calories": "1821.0 kcal/day",
"equation": "mifflin",
"goal": "maintenance"
}
}

Daily Water Intake (DWI)

These endpoints calculate the daily recommended water intake based on factors such as weight, activity level, and climate. It provides flexibility by allowing you to specify the unit of measurement for the water intake, either in liters or ounces.

Parameters

Parameter	Type	Required	Description
activity_level	string	Yes	The activity level of the person. Valid values are "sedentary", "lightly_active", "moderately_active", "very_active", or "extra_active".
climate	string	Yes	The climate in which the individual is located. The climate parameter accepts the following values: normal - Average climate hot - Hot climate cold - Cold climate
weight	int	Yes	The weight of the individual in kilograms.
unit	string	Optional	The unit of measurement for the water intake. (Default) ounces Specify liters to get the result in liters instead.

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/dwi"
querystring = {"weight":"60","activity_level":"sedentary","climate":"normal","unit":"liters"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"unit":"liters",
"water_intake":0.89
}

Target Heart Rate (THR)

These endpoints calculate the target heart rate range for cardiovascular exercise based on the user's age and fitness level. It uses the Karvonen method to determine the target heart rate zone.

Parameters

Parameter	Type	Required	Description
age	int	Yes	The age of the individual in years.
fitness_level	string	Yes	The fitness level of the individual. The fitness_level parameter accepts the following values: beginner - Beginner fitness level. intermediate - Intermediate fitness level. advanced - Advanced fitness level.

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/thr"
querystring = {"age":"27","fitness_level":"beginner"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"thr_max":"164.05 bpm",
"thr_min":"96.5 bpm"
}

Macronutrients Distribution

These endpoints calculates the optimal distribution of macronutrients (carbohydrates, proteins, and fats) based on factors such as activity level, body composition goals, and dietary preferences.

Parameters

Parameter	Type	Required	Description
activity_level	int	Yes	The activity_level parameter accepts the following values: sedentary - Little to no exercise. moderately_active - Moderate exercise/sports 3-5 days/week. very_active - Hard exercise/sports 6-7 days/week.
body_composition_goal	string	Yes	The body_composition_goal parameter accepts the following values: weight_loss - Goal of losing weight. maintenance - Goal of maintaining current weight. muscle_gain - Goal of gaining muscle.
dietary_preferences	string	Yes	The dietary_preferences parameter allows users to specify their dietary preferences. It can be any string value representing the individual's dietary choices or restrictions, such as "vegetarian," "vegan," "pescatarian," or "gluten-free."

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/mnd"
querystring = {"activity_level":"sedentary","body_composition_goal":"maintenance","dietary_preferences":"vegan"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"carbohydrates":"45.0%",
"fats":"25.0%",
"proteins":"30.0%"
}

Micronutrients Distribution

These endpoints calculates the optimal distribution of macronutrients (carbohydrates, proteins, and fats) based on factors such as activity level, body composition goals, and dietary preferences.

Parameters

Parameter	Type	Required	Description
gender	string	Yes	The gender for which the micronutrient requirement is calculated. Valid values are "male" or "female"
age	int	Yes	The age of the individual for whom the micronutrient requirement is calculated. Note that this endpoint is not meant for children below 9 years.
micronutrient	string	Yes	The specific micronutrient for which the requirement is calculated. Valid values include: "calcium" "chromium" "copper" "fluoride" "iodine" "iron" "magnesium" "manganese" "molybdenum" "phosphorus" "selenium" "zinc" "potassium" "sodium" or "chloride"

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/micronutrient"
querystring = {"gender":"female","age":"30","micronutrient":"calcium"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"Age":"30 yr",
"Gender":"female",
"Micronutrient":"calcium",
"Requirement":"1000 mg/d"
}

Fat-Free Mass Index (FFMI)

These FFMI (Fat-Free Mass Index) Calculator endpoints allow you to calculate the FFMI score, which describes the amount of muscle mass in relation to height and weight.

FFMI is part of the family of body indexes, together with well-known and similar BMI. However, FFMI is more precise than BMI and provides information about somebody's condition and health.

Parameters

Parameter	Type	Required	Description
sex	string	Yes	The gender for which the micronutrient requirement is calculated. Valid values are "male" or "female"
height	int	Yes	The height of the individual. For metric units, use height in centimeters, and for imperial units, use height in inches.
weight	int	Yes	The weight of the individual. For metric units, use weight in kilograms, and for imperial units, use weight in pounds.
body_fat	int	Yes	The body fat percentage of the individual.
unit	string	Yes	The unit of measurement for height and weight. Possible values are "metric" (default) and "imperial".
format	string	Optional	The format of the response. Possible values are "yes" (default) or "no". If "yes," the response values will be formatted as kg/m² or lb/m² based on the unit of calculation. If "no," the response values will be provided without formatting.

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/ffmi"
querystring = {"sex":"male","height":"170","weight":"60","body_fat":"15","unit":"metric","format":"yes"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"FFMI": "17.65 kg/m²",
"Fat-free mass": "51.0 kg",
"Normalized FFMI": "18.26 kg/m²",
"Sex": "male",
"Total body fat": "9.0 kg",
"Unit": "metric"
}

Adjusted Body Weight (AjBW)

These endpoints calculate the Adjusted Body Weight (AjBW) and Ideal Body Weight (IBW) using the Robinson's formula.

Parameters

Parameter	Type	Required	Description
sex	string	Yes	The gender of the person. Allowed values: male, female.
height	int	Yes	The height of the person in centimeters.
weight	int	Yes	The weight of the person in kilograms.

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/ajbw"
querystring = {"sex":"male","height":"170","weight":"70"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"AjBW": "67.1 kg",
"Height": 170,
"IBW (Robinson)": "65.17 kg",
"Sex": "male",
"Weight": 70
}

Body Adiposity Index (BAI)

The Body Adiposity Index (BAI) calculator estimates body fat percentage based on hip circumference and height.

Parameters

Parameter	Type	Required	Description
sex	string	Yes	The gender of the person. Allowed values: male, female.
age	int	Yes	Age of the individual in years.
height	decimal	Yes	The height of the person in meters.
hip	int	Yes	Hip circumference in centimeters.

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/bai"
querystring = {"sex":"male","age":"36","hip":"80","height":"1.7"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"Adiposity Classification": "Healthy",
"Age": "36 Yrs",
"BAI": "18.09 %",
"Height": "1.7 M",
"Hip Circumference": "80.0 CM",
"Sex": "male"
}

Body Frame Size Index (BFSI)

The Body Frame Size Index (BFSI) Calculator calculates the Body Frame Size Index for individuals based on their sex, height, and wrist circumference. The BFSI can then be used to classify the individual's body frame size as small, medium, or large.

Parameters

Parameter	Type	Required	Description
sex	string	Yes	The gender of the person. Allowed values: male, female.
height	int	Yes	Height of the individual in centimeters.
wrist	int	Yes	Wrist circumference of the individual in centimeters.

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/bfsi"
querystring = {"sex":"male","height":"170","wrist":"15"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"BFSI":11.33,
"Frame Size":"Small frame",
"Sex":"male"
}

Estimated Average Glucose (eAG)

The Estimated Average Glucose (eAG) endpoints provide a convenient way to estimate the average blood glucose level over a period based on the HbA1c (glycated hemoglobin) value.

The eAG is expressed in milligrams per deciliter (mg/dL), which is a common unit for measuring blood glucose levels.

Parameters

Parameter	Type	Required	Description
hba1c	float	Yes	The HbA1c value as a percentage.

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/eag"
querystring = {"hba1c":"7.0"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"HbA1c (%)":7.0,
"eAG (mg/dL)":154.2
}

Medimate AI Predict Calories Burned

Our MediMate AI currently allow users to predict the number of calories burned during exercise based on individual characteristics and exercise parameters.

These predictions are made using a machine learning model trained on a dataset of exercise-related features.

Parameters

Parameter	Type	Required	Description
gender	string	Yes	The gender of the person. Allowed values: male, female.
age	float	Yes	Age of the individual in years. Numeric value (float).
height	float	Yes	The height of the individual in centimeters.
weight	float	Yes	The weight of the individual in kilograms.
duration	float	Yes	The duration of exercise in minutes (from 1 to 30 minutes).
body_temp	float	Yes	The body temperature during exercise in degrees Fahrenheit
heart_rate	float	Yes	The heart rate during exercise in beats per minute (bpm).

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/medimate/burnt_calories"
payload = {
"gender": "male",
"age": 30,
"height": 180,
"weight": 75,
"duration": 20,
"heart_rate": 70,
"body_temp": 98.6
}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response Example:

{
"Calories Prediction":"69.7 kcal"
}

Estimated Energy Requirement (EER)

These endpoints calculate the Estimated Energy Requirement (EER) for individuals based on their gender, age, weight, height, and activity level. It supports both GET and POST requests for ease of use.

Parameters

Parameter	Type	Required	Description
gender	string	Yes	The gender of the person. Allowed values: male, female.
age	int	Yes	Age of the individual in years. Numeric value (float).
height	int	Yes	The height of the individual in centimeters.
weight	int	Yes	The weight of the individual in kilograms.
activity_level	string	Yes	The physical activity level, which can be one of the following: 'sedentary' (for a sedentary lifestyle) 'low active' (for a low active lifestyle) 'active' (for an active lifestyle) 'very active' (for a very active lifestyle)

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/eer"
querystring = {"gender":"male","age":"32","height":"170","weight":"60","activity_level":"Active"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"Activity Level": "active",
"Age": "32 yr",
"EER": "2696.94 kcal/day",
"Gender": "male",
"Height": "170.0 cm",
"Weight": "60.0 kg"
}

Total Daily Energy Expenditure (TDEE)

The Total Daily Energy Expenditure (TDEE) Calculator endpoints allow you to estimate the number of calories a person burns in a day based on their gender, age, weight, height, activity level, and the choice of BMR (Basal Metabolic Rate) calculation equation.

Parameters

Parameter	Type	Required	Description
gender	string	Yes	The gender of the person. Allowed values: male, female.
age	int	Yes	Age of the individual in years. Numeric value (float).
height	int	Yes	The height of the individual in centimeters.
equation	string	Optional	The equation used to calculate BMR. Choose from the following options (default is 'mifflin'): 'mifflin' (Mifflin-St Jeor Equation) 'harris' (Harris-Benedict Equation)
weight	int	Yes	The weight of the individual in kilograms.
activity_level	string	Yes	The activity level of the individual. Choose from the following options: 'sedentary' (little to no exercise) 'light exercise' (light exercise or sports 1-3 days a week) 'moderate exercise' (moderate exercise or sports 3-5 days a week) 'hard exercise' (hard exercise or sports 6-7 days a week) 'physical job' (physically active job or training) 'professional athlete' (professional athlete or highly active job)

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/tdee"
querystring = {"gender":"male","age":"30","height":"175","weight":"70","activity_level":"light exercise","equation":"mifflin"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"Activity Level": "light exercise",
"Age": "30 yr",
"BMR": "1648.75 kcal/day",
"Gender": "male",
"Height": "175.0 cm",
"TDEE": "2267.03 kcal/day",
"Weight": "70.0 kg"
}

BEE and TEE

The Basal Energy Expenditure (BEE) and Total Energy Expenditure (TEE) endpoints allow you to estimate the number of calories a person burns in a day based on their gender, age, weight, height, activity level, stress factors, and body temperature.

Parameters

Parameter	Type	Required	Description
gender	string	Yes	The gender of the person. Allowed values: male, female.
age	int	Yes	Age of the individual in years. Numeric value (float).
height	int	Yes	The height of the individual in centimeters.
temperature	string	Optional	The body temperature of the individual. Choose from the following options (default is 'normal'): 'normal' '>= 100.4°F or 38°C' '>= 102.2°F or 39°C' '>= 104°F or 40°C' '>= 105.8°F or 41°C'
stress_factor	string	Optional	The stress factor that may affect energy expenditure. Choose from the following options (default is 'none'): 'none' 'solid tumor' 'leukemia/lymphoma' 'inflammatory bowel disease' 'liver disease' 'burns' 'pancreatic disease' 'general surgery' 'transplantation' 'sepsis' 'abscess' 'other infection'
weight	int	Yes	The weight of the individual in kilograms.
activity_level	string	Yes	The activity level of the individual. Choose from the following options: 'bed-ridden': Lying, sleeping, eating. 'light or sedentary': Sitting (e.g., office work), watching TV, cooking, personal care, driving a car, light walks, typical household duties. 'moderate to active': Standing, carrying light loads (e.g., waiting tables), longer walks, light aerobic exercises, commuting by bus. 'heavily active': Agricultural work, manual labor, heavy-duty cleaning, strenuous exercises performed on a regular basis.

Python Requests Example:

import requests
url = "https://health-calculator-api.p.rapidapi.com/bee"
querystring = {"gender":"male","age":"30","height":"175","weight":"60","activity_level":"light or sedentary","stress_factor":"none","temperature":"normal"}
headers = {
"x-rapidapi-key": "Sign Up for Key",
"x-rapidapi-host": "health-calculator-api.p.rapidapi.com"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

Response Example:

{
"Activity Level": "light or sedentary",
"Age": "30 yr",
"BEE": "1563.78 kcal/day",
"Gender": "male",
"Height": "175.0 cm",
"Stress Factor": "none",
"TEE": "2392.58 kcal/day",
"Temperature": "normal",
"Weight": "60.0 kg"
}

Subscribe to Health Calculator API

Got any questions or issues with our API? Please don’t hesitate to contact us!

API