Skip to content

BEE API

Estimate BEE and TEE for nutrition planning with contextual multipliers for activity, stress state, and body temperature conditions.

Endpoint

  • GET /api/v1/bee
  • POST /api/v1/bee/post

Parameters

Name Type Required In Description
gender string (male,female) Yes Query/Body Biological sex.
age integer Yes Query/Body Age in years.
weight number Yes Query/Body Weight in kilograms.
height number Yes Query/Body Height in centimeters.
activity_level string Yes Query/Body One of endpoint-supported activity levels.
stress_factor string No Query/Body Stress multiplier; defaults to none.
temperature string No Query/Body Temperature factor; defaults to normal.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Personalize calorie targets with medical context.
  • Layer stress/temperature for inpatient and special-case workflows.
  • Improve nutrition planning precision for enterprise care apps.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/bee?gender=male&age=38&weight=82&height=178&activity_level=moderate%20to%20active&stress_factor=none&temperature=normal&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/bee/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "gender": "male",
    "age": 38,
    "weight": 82,
    "height": 178,
    "activity_level": "moderate to active",
    "stress_factor": "none",
    "temperature": "normal"
  }'

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.

{
  "BEE": "1786.48 kcal/day",
  "TEE": "3144.20 kcal/day",
  "bee_kcal_per_day": 1786.48,
  "tee_kcal_per_day": 3144.2,
  "Gender": "male",
  "Age": "38 yr",
  "Weight": "82.0 kg",
  "Height": "178.0 cm",
  "Activity Level": "moderate to active",
  "Stress Factor": "none",
  "Temperature": "normal",
  "energy_band": "high",
  "energy_band_label": "High",
  "risk_signal": "Higher intake precision required.",
  "action_plan": ["Periodize calories by training load"],
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "3980fbeb6dbf3e73",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "Health Fitness API by Dakidarts®",
    "endpoint_name": "bee",
    "response_language": "en"
  }
}

Commercial Use

Great for nutrition engines, clinical dietetics software, and high-touch coaching programs requiring contextual energy expenditure.

Note

activity_level, stress_factor, and temperature must match the endpoint's supported option sets.