fitness-api

FREEMIUM

By Vibe | Updated hace 2 meses | Health and Fitness

Popularity

8.8 / 10

Latency

867ms

Service Level

100%

Health Check

N/A

README

Fitness API Documentation

Introduction

This API provides many formulas to compute many things as your Body Mass Index (BMI), your Body Fat Percetage (BFP) or to compute food energy and the list is growing !

Getting started

The first thing is to create an account on RapidAPI to obtain an API key. Then follow the RapidAPI documentation to use the API with your preferred programming language.

/fitness route

This route respond only to POST request. The more you add parameters, the more results you will have. For example, if you provide just height and weight parameters (let’s take 190 cm and 80 Kg for this example), you will only have this:

{
  "height": 190,
  "weight": 88,
  "idealBodyWeight": {
    "peterson": {
      "formulaName": "Peterson et al.",
      "metric": {
        "value": 87.8,
        "unit": [
          "Kg",
          "kilograms"
        ]
      },
      "imperial": {
        "value": 169.9,
        "unit": [
          "lbs",
          "pounds"
        ]
      }
    }
  },
  "bodyMassIndex": {
    "value": 24.4,
    "conclusion": "Normal",
    "unit": "Kg/m²"
  }
}

But, if you provide a gender (“male” for example), you will have many more things:

{
  "height": 190,
  "weight": 88,
  "gender": "male",
  "idealBodyWeight": {
    "peterson": {
      "formulaName": "Peterson et al.",
      "metric": {
        "value": 87.8,
        "unit": [
          "Kg",
          "kilograms"
        ]
      },
      "imperial": {
        "value": 193.7,
        "unit": [
          "lbs",
          "pounds"
        ]
      }
    },
    "lorentz": {
      "formulaName": "Lorentz",
      "metric": {
        "value": 80,
        "unit": [
          "Kg",
          "kilograms"
        ]
      },
      "imperial": {
        "value": 176.4,
        "unit": [
          "lbs",
          "pounds"
        ]
      }
    },
    "hamwi": {
      "formulaName": "Hamwi",
      "metric": {
        "value": 88,
        "unit": [
          "Kg",
          "kilograms"
        ]
      },
      "imperial": {
        "value": 193.9,
        "unit": [
          "lbs",
          "pounds"
        ]
      }
    },
    "devine": {
      "formulaName": "Devine",
      "metric": {
        "value": 84,
        "unit": [
          "Kg",
          "kilograms"
        ]
      },
      "imperial": {
        "value": 185.3,
        "unit": [
          "lbs",
          "pounds"
        ]
      }
    },
    "robinson": {
      "formulaName": "Robinson",
      "metric": {
        "value": 80.1,
        "unit": [
          "Kg",
          "kilograms"
        ]
      },
      "imperial": {
        "value": 176.6,
        "unit": [
          "lbs",
          "pounds"
        ]
      }
    },
    "miller": {
      "formulaName": "Miller",
      "metric": {
        "value": 77.1,
        "unit": [
          "Kg",
          "kilograms"
        ]
      },
      "imperial": {
        "value": 169.9,
        "unit": [
          "lbs",
          "pounds"
        ]
      }
    }
  },
  "bodyMassIndex": {
    "value": 24.4,
    "conclusion": "Normal",
    "unit": "Kg/m²"
  }
}

Simple as that ! Now we will explain what you can compute.

List of parameters

Here is the list of all available parameters.

height in centimeters
weight in kilograms
age in years
gender possible values
- male
- female
exercise level of activity according to Occupational Safety and Health Administration
- little
- light
- moderate
- heavy
- veryheavy
goal the diet goal
- fatloss_moderate
- fatloss_aggressive
- fatloss_reckless
- maintenance
- bulking_slow
- bulking_normal
- bulking_aggressive
goalWeight the target weight in kilograms
deficit the calories deficit per day
waist the waist circumference in centimers
neck the neck circumference in centimeters
hip the hip circumference in centimeters

Note: actually the API essentially uses the metric system for the input data but we do not exclude to also use the imperial system. Metric and imperial system are used to output data.

Body Mass Index (BMI)

The BMI needs two parameters

height in centimeters
weight in kilograms

and as the result, you get an object named bodyMassIndex that contains

the BMI in value
the conclusion in conclusion
the unit of measurement in unit

{
  "bodyMassIndex": {
    "value": 24.4,
    "conclusion": "Normal",
    "unit": "Kg/m²"
  }
}

Body Fat Percentage (BFP)

From BMI

The Body Fat Percentage (BFP) from BMI needs these parameters:

age the age in years
gender possible values “male” or “female”
bodyMassIndex.value the BMI (cf. BMI)

{
  "bodyFatPercentage": {
    "bmi": {
      "formulaName": "From BMI",
      "value": 20,
      "conclusion": "Acceptable",
      "unit": [
        "%",
        "percents"
      ]
    }
  }
}

Lean Body Mass (LBM)

From BMI

The Lean Body Mass (LBM) calculated from the BMI needs two parameters

weight in kilograms
bodyFatPercentage.bmi.value computed with other parameters (see. BFP)

As the result you get an object in leanBodyMass.bmi containing

the formula name in formulaName
the LBM in value
the unit of measurement in unit

{
  "bmi": {
    "formulaName": "From BMI",
    "value": 70.4,
    "unit": [
      "Kg",
      "kilograms"
    ]
  }
}

From Department of Defense BFP formula

The Lean Body Mass (LBM) from the Department of Defense BFP formula needs two
parameters

weight in kilograms
bodyFatPercentage.dod computed with the Department of Defense BFP formula

As the result you get an object in leanBodyMass.dod containing

the formula name in formulaName
the LBM in value
the unit of measurement in unit

{
  "formulaName": "From Department of Defense",
  "value": 75.2,
  "unit": [
    "%",
    "percents"
  ]
}

From YMCA BFP formula

The Lean Body Mass (LBM) from the YMCA BFP formula needs two
parameters

weight in kilograms
bodyFatPercentage.ymca computed with the YMCA BFP formula

As the result you get an object in leanBodyMass.ymca containing

the formula name in formulaName
the LBM in value
the unit of measurement in unit

{
  "formulaName": "From YMCA",
  "value": 74.6,
  "unit": [
    "%",
    "percents"
  ]
}

Resting Daily Energy Expenditure (RDEE)

From BMI

The Resting Daily Energy Expenditure (RDEE) from BMI needs one parameters

leanBodyMass.bmi.value the LBM from BMI

As the result you get an object in restingDailyEnergyExpenditure containing

the formula name in bmi.formulaName
the calories in bmi.calories.value and the unit in bmi.calories.unit
the joules and the unit in ymca.joules.value and ymca.joules.unit

{
  "bmi": {
    "formulaName": "Katch-McArdle",
    "calories": {
      "value": 1890.6,
      "unit": [
        "Kcal",
        "kilocalories"
      ]
    },
    "joules": {
      "value": 7910.3,
      "unit": [
        "Kj",
        "kilojoules"
      ]
    }
  }
}

From Department of Defense

The Resting Daily Energy Expenditure (RDEE) from Department of Defense needs one parameters

leanBodyMass.dod.value the LBM from Department of Defense

As the result you get an object in restingDailyEnergyExpenditure containing

the formula name in dod.formulaName
the calories in dod.calories.value and unit in dod.calories.unit
the joules and the unit in ymca.joules.value and ymca.joules.unit

{
  "dod": {
    "formulaName": "Katch-McArdle",
    "calories": {
      "value": 1890.6,
      "unit": [
        "Kcal",
        "kilocalories"
      ]
    },
    "joules": {
      "value": 7910.3,
      "unit": [
        "Kj",
        "kilojoules"
      ]
    }
  }
}

From YMCA

The Resting Daily Energy Expenditure (RDEE) from YMCA needs one parameters

leanBodyMass.ymca.value the LBM from YMCA

As the result you get an object in restingDailyEnergyExpenditure containing

the formula name in ymca.formulaName
the calories and the unit in ymca.calories.value and ymca.calories.unit
the joules and the unit in ymca.joules.value and ymca.joules.unit

{
  "ymca": {
    "formulaName": "Katch-McArdle",
    "calories": {
      "value": 1890.6,
      "unit": [
        "Kcal",
        "kilocalories"
      ]
    },
    "joules": {
      "value": 7910.3,
      "unit": [
        "Kj",
        "kilojoules"
      ]
    }
  }
}

Basal Metabolic Rate

The Basal Metabolic Rate (BMR) needs four parameters

height in centimers
weight in kilograms
age in years
gender male or female

As the result you get an object in basalMetabolicRate containing the result of
three formulas :

Harris-Benedict in hb
Harris-Benedict revised by Roza-Shizgal in rs
Harris-Benedict revised by Mifflin-St Jeor in msj

Each one contains

the formula name in formulaName
the calories and unit in calories.value and calories.unit
the joules and unit in joules.value and joules.unit

{
  "hb": {
    "formulaName": "Harris-Benedict",
    "calories": {
      "value": 2023.8,
      "unit": [
        "Kcal",
        "kilocalories"
      ]
    },
    "joules": {
      "value": 8467.6,
      "unit": [
        "Kj",
        "kilojoules"
      ]
    }
  },
  "rs": {
    "formulaName": "Harris-Benedict revised by Roza-Shizgal",
    "calories": {
      "value": 2008.8,
      "unit": [
        "Kcal",
        "kilocalories"
      ]
    },
    "joules": {
      "value": 8404.8,
      "unit": [
        "Kcal",
        "kilocalories"
      ]
    }
  },
  "msj": {
    "formulaName": "Harris-Benedict revised by Mifflin-St Jeor",
    "calories": {
      "value": 1923,
      "unit": [
        "Kcal",
        "kilocalories"
      ]
    },
    "joules": {
      "value": 8045.8,
      "unit": [
        "Kj",
        "kilojoules"
      ]
    }
  }
}