fitnessrec-fitapi（健身记录 Fitapi）

FitAPI — The Most Detailed Food & Exercise Database API

Ask your AI agent about any food, nutrient, exercise, or barcode — and get precise, science-grade data instead of LLM guesses.

"How much omega-3 is in salmon?" — FitAPI returns the exact value from curated scientific databases, not an approximation from training data.

Setup — API key required

Before making any API calls, you need an API key. If the user hasn't configured one yet, guide them through setup:

1. Sign up at https://fitapi.fitnessrec.com — free account, no credit card needed
2. Get the API key from the dashboard at https://fitapi.fitnessrec.com/dashboard
3. Configure this skill with the API key

All requests are authenticated via the Authorization: Bearer {apiKey} header. If you get a 401 error, the key is missing or invalid — tell the user to check their key in the dashboard.

All plans include every endpoint and all 47 languages.

Full interactive API docs (Swagger UI): https://fitapi.fitnessrec.com/api/docs

How to use this API — pick the right tool

You have 9 tools. Do NOT just use search_foods for everything. Each tool serves a specific purpose:

Recommended workflows (chain these for better answers)

1. Meal planning — "Plan a high-protein lunch under 500 calories"

1. nutrition_needs — get the user's daily targets (if body stats are known)
2. filter_foods — find foods matching criteria: filter='1003 > 25 AND 1008 < 200', sort='1003:desc'
3. Present options with portions and macros

2. Recipe nutrition breakdown — "How many calories in caesar salad?"

1. search_dishes — find the recipe, get normalized_ingredients with matched food IDs and gram amounts
2. Each ingredient includes matched_id — use get_food to retrieve full nutrient detail for any ingredient you need to examine
3. The dish itself already includes aggregated nutrients per 100g

3. Diet comparison — "Which has more omega-3, salmon or mackerel?"

1. search_foods for each food (returns full 180 nutrients including omega-3 as nutrient ID 4444)
2. Compare the nutrients.4444.value fields directly

4. Nutrient gap analysis — "Am I getting enough iron?"

1. nutrition_needs — get daily iron requirement (nutrient 1089)
2. search_foods for the user's logged foods — sum up iron from each
3. Compare total vs. requirement

5. Barcode scanning — "What is this product?"

1. lookup_barcode with the UPC/EAN number for direct match
2. If no match, fall back to search_barcode with the product name

6. Exercise programming — "Chest exercises with dumbbells"

1. search_exercises with body_parts: ["chest"], equipments: ["Dumbbell"]
2. Results include muscle activation percentages (MuscleDistribution) — use these to build balanced routines that cover all muscle groups

Important: search_foods already returns complete data

search_foods returns all 180 nutrients, portions, and metadata per food. You do NOT need to call get_food after search — the data is identical. Use get_food only when you already have a food ID (e.g., from a recipe's normalized_ingredients).

What you get

• 16,000+ foods with 180 nutrients each — every vitamin, mineral, amino acid, fatty acid — curated from 5 international databases (USDA, NUTTAB, CNF2015, MEXT, FRIDA)
• 3 million+ branded products — scan or search any barcode (UPC/EAN) for nutrition facts
• 80,000+ local recipes from 48 languages — with ingredients matched to the nutrition database for accurate macros
• 5,000+ exercises — step-by-step instructions, tips, main/granular/synergist muscles, equipment, and muscle activation percentages
• Smart filtering — "foods highest in iron", "high protein low fat seafood", "most omega-3" — sorted by actual nutrient values, not keyword matching
• Personalized daily needs — calculate exact macro/micronutrient targets based on body stats and goals
• 48 languages — food names, exercise instructions, and recipe data translated natively

Why not just ask the LLM?

LLMs estimate. FitAPI knows. When you ask "how much protein in chicken breast", an LLM guesses ~31g from training data. FitAPI returns 22.5g per 100g from the USDA database — the actual measured value. For serious nutrition tracking, the difference matters.

Tools

search_foods

Search foods by name. Returns nutrient data per 100g and portion sizes.

POST https://fitapi.fitnessrec.com/api/v1/foods/search

Request:

{"q": "chicken breast raw", "locale": "en", "limit": 5}

• q (required): Search query in English
• locale: Language code for translated names (en, tr, de, fr, es, it, pt, nl, ru, ja, ko, zh, ar, hi, pl, sv, da, fi, cs, ro, hu, bg, el, hr, sr, sk, sl, bs, sq, et, lt, lv, is, nn, vi, th, id, ms, fil, uk, fa, he, bn, ka, az, mn, ur, af)
• limit: 1-100, default 20

Response: Array of foods with id, desc (name), nutrients map (ID -> {name, unit, value per 100g}), portions map.

filter_foods

Filter and sort foods by nutrient values. Use for "which food has the most X" or "foods high in X" queries. ALWAYS include sort.

POST https://fitapi.fitnessrec.com/api/v1/foods/filter

Request:

{"filter": "1003 > 20 AND 1004 < 5", "sort": "1003:desc", "limit": 10}

• filter (required): MeiliSearch filter expression. Operators: =, !=, >, >=, <, <=, TO, AND, OR, NOT
• sort (required): nutrientId:desc or nutrientId:asc
• q: Optional text search to narrow results
• locale: Language code
• limit: 1-100, default 20

Example queries:

• Highest protein: filter='1003 > 0', sort='1003:desc'
• Most omega-3: filter='4444 > 0', sort='4444:desc'
• Most omega-6: filter='5555 > 0', sort='5555:desc'
• Low calorie + high fiber: filter='1008 < 100 AND 1079 > 5', sort='1079:desc'
• High iron: filter='1089 > 3', sort='1089:desc'
• High protein seafood: filter='ctg = 15 AND 1003 > 20', sort='1003:desc'

Nutrient IDs:

Food categories (ctg): 1=dairy, 2=spices, 3=baby foods, 4=fats/oils, 5=poultry, 6=soups/sauces, 7=sausages, 8=cereals, 9=fruits, 10=pork, 11=vegetables, 12=nuts/seeds, 13=beef, 14=beverages, 15=seafood, 16=legumes, 17=lamb/game, 18=baked, 19=sweets, 20=grains, 21=fast food, 22=meals, 25=snacks, 26=branded

get_food

Get a single food by ID with full nutrient data (120+ nutrients).

POST https://fitapi.fitnessrec.com/api/v1/foods/{id}

Request (optional body):

{"locale": "en"}

search_exercises

Search 5,000+ exercises with step-by-step instructions, tips, main/granular/synergist muscle targeting, equipment, and muscle activation percentages.

POST https://fitapi.fitnessrec.com/api/v1/exercises/search

Request:

{
  "q": "bench press",
  "locale": "en",
  "limit": 5,
  "exercise_types": ["strength_training"],
  "body_parts": ["chest"],
  "equipments": ["Barbell"]
}

• q (required): Search query
• locale: Language code for translated instructions/tips
• limit: 1-100, default 20
• exercise_types: strength_training, strength_training.functional, stretching
• body_parts: abs, arms, back, calves, cardio, chest, feet, forearms, glutes, legs, neck, plyometrics, shoulders, stretching, weightlifting, yoga
• equipments: Assisted, Band, Barbell, Battling Rope, Body weight, Bosu ball, Cable, Dumbbell, EZ Barbell, Hammer, Kettlebell, Leverage machine, Medicine Ball, Olympic barbell, Power Sled, Resistance Band, Roll, Rollball, Rope, Sled machine, Smith machine, Stability ball, Stick, Suspension, Trap bar, Vibrate Plate, Weighted, Wheel roller
• targets: Pectoralis Major Sternal Head, Deltoid Anterior, Biceps Brachii, Triceps Brachii, Latissimus Dorsi, Quadriceps, Hamstrings, Gluteus Maximus, Rectus Abdominis, Erector Spinae, etc.

Response: Array of exercises with exercise (name), info, instructions[], tips[], Target[], Synergist[], Equipment[], BodyPart[], MuscleDistribution (muscle -> 0.0-1.0).

get_exercise

Get a single exercise by ID.

GET https://fitapi.fitnessrec.com/api/v1/exercises/{id}

search_dishes

Search 80,000+ international dishes/recipes with ingredients automatically matched to the food database for accurate nutrition.

POST https://fitapi.fitnessrec.com/api/v1/dishes/search

Request:

{"q": "caesar salad", "locale": "en", "limit": 5}

Response: Dishes with desc, country, ingredient_count, normalized_ingredients[] (matched to food DB with scores), nutrients per 100g, portions.

search_barcode

Search branded food products by name.

POST https://fitapi.fitnessrec.com/api/v1/barcode/search

Request:

{"q": "coca cola", "limit": 5}

Response: Branded products with desc, brandOwner, gtinUpc, marketCountry, nutrients, portions.

lookup_barcode

Look up a specific product by barcode number.

POST https://fitapi.fitnessrec.com/api/v1/barcode/{barcode}

Example: POST /api/v1/barcode/0041220576920

nutrition_needs

Calculate personalized daily macro and micronutrient needs based on body measurements.

POST https://fitapi.fitnessrec.com/api/v1/nutrition/needs

Request:

{
  "body": {
    "weight": 80,
    "height": 180,
    "age": 30,
    "gender": "m",
    "activity_level": 3,
    "macro_target": {
      "target_type": "deficit",
      "target_amount": 300,
      "protein": 30,
      "carb": 40,
      "fat": 30
    }
  }
}

• weight: kg
• height: cm
• age: years
• gender: m (male), f (female), p (pregnant), l (lactating)
• activity_level: 1=sedentary, 2=light, 3=moderate, 4=very active, 5=extra active
• macro_target.target_type: maintenance, deficit, surplus
• macro_target.target_amount: kcal offset (for deficit/surplus)
• macro_target.protein/carb/fat: percentage split (sum to 100)

Response: Map of nutrient ID -> daily need value, plus bmr, tdee, and macro breakdown.

Error Responses

{"error": "message"}

Notes

• All nutrient values are per 100g unless portions are specified
• Portions include weight in grams and description (e.g. "1 cup", "1 breast")
• Food search queries should be in English; set locale to translate response names
• Food database curated from USDA, NUTTAB (Australia), CNF2015 (Canada), MEXT (Japan), FRIDA (Denmark)
• 3 million+ branded food products with barcode lookup
• 80,000+ local recipes/dishes from 48 languages with ingredient matching
• Nutrient IDs follow USDA numbering with custom extensions (4444=omega-3, 5555=omega-6)