docs / fitness

Fitness & Nutrition

Exercise and nutrition data for foods and workouts.

base /fitness/v18 endpoints

post/fitness/v1/exercises1 credit

Browse or search the full exercise library (800+ exercises from wger.de). Filter by name keyword; returns each exercise's name, body part, target muscle, equipment, step-by-step instructions, and animation URL.

Parameter		Allowed / range	Description
name	optional	—	Free-text search term to filter exercises by name.
limit = 20	optional	1–100	Results per page (1-100, default 20). Larger values are clamped to 100.
offset = 0	optional	0–	Pagination offset (skip N results). Page forward with meta.next_offset.
language = 2	optional	—	wger language id for names/instructions (2 = English, 1 = German, 4 = Russian, 5 = Spanish, …). Defaults to English.

Try in playground →

post/fitness/v1/by_bodypart1 credit

All exercises targeting a specific body part — e.g. 'chest', 'back', 'shoulders', 'upper arms', 'waist'. Returns name, target muscle, equipment, and instructions for each.

Parameter		Allowed / range	Description
bodypart	required	—	Body part / category to filter by (e.g. chest, back, shoulders, upper arms, upper legs, lower legs, waist, cardio). Matched by substring; use bodypart_list for the live options.
limit = 20	optional	1–100	Results per page (1-100, default 20). Larger values are clamped to 100.
offset = 0	optional	0–	Pagination offset (skip N results). Page forward with meta.next_offset.
language = 2	optional	—	wger language id for names/instructions (2 = English, 1 = German, 4 = Russian, 5 = Spanish, …). Defaults to English.

Try in playground →

post/fitness/v1/by_equipment1 credit

All exercises that use a specific piece of equipment — e.g. 'barbell', 'dumbbell', 'kettlebell', 'none' (bodyweight). Returns name, target muscle, body part, and instructions.

Parameter		Allowed / range	Description
equipment	required	—	Equipment name to filter by (e.g. barbell, dumbbell, kettlebell, none). Matched by substring; use equipment_list for the live options.
limit = 20	optional	1–100	Results per page (1-100, default 20). Larger values are clamped to 100.
offset = 0	optional	0–	Pagination offset (skip N results). Page forward with meta.next_offset.
language = 2	optional	—	wger language id for names/instructions (2 = English, 1 = German, 4 = Russian, 5 = Spanish, …). Defaults to English.

Try in playground →

post/fitness/v1/by_target1 credit

All exercises that target a specific muscle — e.g. 'biceps', 'triceps', 'quads', 'glutes', 'lats'. Returns name, equipment, body part, and step-by-step instructions.

Parameter		Allowed / range	Description
target	required	—	Target muscle to filter by (e.g. biceps, triceps, quads, glutes). Matched by substring; use target_list for the live options.
limit = 20	optional	1–100	Results per page (1-100, default 20). Larger values are clamped to 100.
offset = 0	optional	0–	Pagination offset (skip N results). Page forward with meta.next_offset.
language = 2	optional	—	wger language id for names/instructions (2 = English, 1 = German, 4 = Russian, 5 = Spanish, …). Defaults to English.

Try in playground →

post/fitness/v1/exercise_detail1 credit

Full detail for a single exercise by its id — name, body part, primary and secondary muscles, equipment, step-by-step instructions, animation URL, and license.

Parameter		Allowed / range	Description
id	required	—	A single wger exercise id (the `id` of a search/filter result).
language = 2	optional	—	wger language id for names/instructions (2 = English, 1 = German, 4 = Russian, 5 = Spanish, …). Defaults to English.

Try in playground →

post/fitness/v1/bodypart_listfree

List all available body part categories (e.g. chest, back, shoulders, waist, cardio). Use these values with the by_bodypart action.

Try in playground →

post/fitness/v1/equipment_listfree

List all available equipment types (e.g. barbell, dumbbell, kettlebell, none). Use these values with the by_equipment action.

Try in playground →

post/fitness/v1/target_listfree

List all available target muscles (e.g. biceps, triceps, quads, glutes, lats). Use these values with the by_target action.

Try in playground →

Example request · exercises

curl -X POST https://api.reefapi.com/fitness/v1/exercises \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}