Workout Exercise API

Open exercise database with animated stickers for AI agents, bots, and apps

What is this? A REST API serving 101 exercises across 10 muscle groups, each with animated sticker assets in multiple formats. Designed as a tool for AI agents, Telegram/WhatsApp bots, and fitness apps.

Data source: Exercise data is loaded live from a Google Sheets CSV on startup, with a hardcoded fallback if the fetch fails.

Stickers: Every exercise has an animated sticker generated from CSS-calibrated sprite sheets — available as transparent WebP (WhatsApp), WEBM video (Telegram), GIF, APNG (LINE), and 240×240 GIF (WeChat).

101exercises
10muscle groups
55beginner
36intermediate
10advanced
100animated stickers
OpenAPI Spec Sticker Review Telegram Sticker Pack LINE Pack — coming soon WeChat Pack — coming soon

API Endpoints

GET /exercises
List all exercises. Supports field filtering and pagination.
fields - comma-separated fields to return   limit - max results   offset - skip N results
GET /exercise/:id
Get a single exercise by numeric ID (0-100).
fields - comma-separated fields to return
GET /exercises/meta
Discover valid filter values: all muscle groups, equipment types, and difficulty levels.
GET /exercises/search
Search and filter exercises. All params optional, combined with AND.
q - name/use search   muscle - target muscle   equipment - equipment type   difficulty - Beginner|Intermediate|Advanced   fields - fields to return   limit / offset - pagination
GET /exercises/random
Get N random exercises with optional filters.
count - number of exercises (1-20)   muscle / equipment / difficulty - filters   fields - fields to return
GET /exercises/workout
Generate a balanced workout distributed across muscle groups.
muscles - required, comma-separated (e.g. chest,triceps)   count - total exercises (1-30, default 6)   difficulty - filter   fields - fields to return
GET /openapi.json
OpenAPI 3.1 spec for AI agent tool use / MCP integration.
GET /.well-known/ai-plugin.json
AI plugin manifest for auto-discovery by ChatGPT plugins, MCP clients, and agent frameworks.

Sticker Formats

/stickers/{id}.webp
Animated WebP (512x512, transparent). Use directly as WhatsApp Cloud API sticker URL.
/stickers/telegram/{id}.webm
VP9 WEBM video (512x512, 5fps, 3s). Telegram video stickers via Bot API.
/stickers/gifs/{id}.gif
Animated GIF (256x256). General purpose.
LINE (APNG)
270×270 animated APNG, packaged as 5 sets (8–24 stickers). Published via LINE Creators Market — coming soon.
WeChat (GIF)
240×240 animated GIF + 120×120 thumbnails, packaged as 5 sets (16–24 stickers). Published via WeChat Sticker Open Platform — coming soon.

AI Agent Usage

Point your agent at /openapi.json to auto-discover all endpoints, schemas, and sticker assets. Each exercise response includes:
stickerUrl - full URL for WhatsApp sticker (use as link in Cloud API)   telegramSticker.fileId - pass directly to sendSticker Bot API   spriteClasses - CSS classes for web embedding
Recommended keyword trigger — route user messages to this tool when they match:
\b(exercise|exercises|workout|workouts|gym|fitness|muscle|muscles|training|bicep|tricep|chest|back|shoulder|leg|core|squat|deadlift|bench\s*press|pull.?up|push.?up|curl|plank|lunge|burpee|crunch|cardio|strength|lifting|weight\s*training|bodyweight|equipment|dumbbell|barbell|kettlebell)\b
Use this regex (case-insensitive) to detect when a user message is exercise-related and should invoke the Workout Exercise API tool.

All Exercises

Barbell Bench Press

Intermediate #0
Chest, Triceps, Front Delts
Lie on bench, grip bar slightly wider than shoulders, lower to mid-chest, press up.

Dumbbell Bench Press

Intermediate #1
Chest, Triceps, Front Delts
Lie on bench, press dumbbells from chest level to full extension overhead.

Incline Barbell Bench Press

Intermediate #2
Upper Chest, Front Delts
Set bench to 30-45 degrees, lower bar to upper chest, press up.

Incline Dumbbell Bench Press

Intermediate #3
Upper Chest, Front Delts
Lie on incline bench, press dumbbells upward from shoulder level.

Decline Barbell Bench Press

Intermediate #4
Lower Chest, Triceps
Lie on decline bench, lower bar to lower chest, press up.

Dumbbell Chest Fly

Beginner #5
Chest
Lie on bench, arms slightly bent, lower weights out to sides, squeeze back to center.

Cable Crossover

Beginner #6
Chest
Stand between cables, pull handles together in a hugging motion in front of chest.

Push-Up

Beginner #7
Chest, Triceps, Core
Start in plank, lower chest to floor, push back up keeping body straight.

Diamond Push-Up

Intermediate #8
Triceps, Inner Chest
Push-up with hands forming a diamond shape under the chest.

Incline Push-Up

Beginner #9
Lower Chest
Hands on bench, feet on floor, perform push-up.

Decline Push-Up

Intermediate #10
Upper Chest, Shoulders
Feet on bench, hands on floor, perform push-up.

Dips (Chest Version)

Advanced #11
Chest, Triceps
Lean forward, flare elbows slightly, lower body, push back up.

Pec Deck Machine

Beginner #12
Chest
Sit and squeeze machine handles/pads together in front of you.

Conventional Deadlift

Intermediate #13
Glutes, Hamstrings, Lower Back, Traps
Hinge at hips, grip bar, keep back flat, stand up pulling bar up shins.

Sumo Deadlift

Intermediate #14
Glutes, Inner Thighs, Back
Wide stance, hands inside knees, pull bar up while keeping chest high.

Barbell Bent Over Row

Intermediate #15
Lats, Rhomboids, Traps
Hinge 45 degrees, pull bar to lower stomach, squeeze shoulder blades.

One-Arm Dumbbell Row

Beginner #16
Lats, Upper Back
One knee/hand on bench, row dumbbell to hip with other arm.

Pull-Up

Advanced #17
Lats, Biceps
Hang with wide grip, pull chest to bar, elbows down.

Chin-Up

Intermediate #18
Lats, Biceps
Hang with underhand grip, pull chin over bar.

Lat Pull-Down (Wide)

Beginner #19
Lats, Teres Major
Sit and pull bar to upper chest, keep shoulders down.

Lat Pull-Down (Close Grip)

Beginner #20
Lower Lats, Back Thickness
Use V-bar, pull to mid-chest, lean back slightly.

Seated Cable Row

Beginner #21
Mid-Back, Lats
Sit, pull handle to stomach, squeeze shoulder blades together.

T-Bar Row

Intermediate #22
Mid-Back, Traps
Straddle bar, pull handle to chest, keep back flat.

Face Pull

Beginner #23
Rear Delts, Upper Back
Pull rope toward forehead, pull ends apart, squeeze rear delts.

Straight Arm Pull-Down

Beginner #24
Lats
Keep arms straight, pull bar from overhead down to thighs.

Hyper-extensions

Beginner #25
Lower Back, Glutes
Hook heels, lower torso, raise back up to neutral spine.

Superman

Beginner #26
Lower Back
Lie face down, lift arms and legs simultaneously, hold, lower.

Renegade Row

Advanced #27
Back, Core, Shoulders
Plank position on DBs, row one weight to hip at a time without rotating.

Barbell Overhead Press

Intermediate #28
Shoulders, Triceps
Stand tall, press bar from shoulders to full lockout overhead.

Seated Dumbbell Press

Beginner #29
Shoulders, Triceps
Sit on bench, press dumbbells overhead from shoulder height.

Arnold Press

Intermediate #30
Shoulders (Front/Side)
Start palms in at face, rotate palms out as you press up.

Lateral Raise

Beginner #31
Side Delts
Raise dumbbells out to sides to shoulder height, slight elbow bend.

Front Raise

Beginner #32
Front Delts
Raise weights in front of you to shoulder height.

Rear Delt Fly

Beginner #33
Rear Delts
Hinge forward, raise weights out to sides focusing on rear delts.

Upright Row

Intermediate #34
Traps, Side Delts
Pull bar up to chin, elbows high, keep bar close to body.

Dumbbell Shrugs

Beginner #35
Traps
Hold weights at sides, shrug shoulders toward ears, squeeze.

Push Press

Intermediate #36
Shoulders, Legs
Dip legs slightly, explode up to help press bar overhead.

Cable Lateral Raise

Intermediate #37
Side Delts
Stand sideways to cable, pull handle across body and out to side.

Barbell Back Squat

Intermediate #38
Quads, Glutes, Core
Bar on traps, sit back into hips, lower until thighs are parallel.

Front Squat

Advanced #39
Quads, Core
Bar across front of shoulders, elbows high, stay upright as you squat.

Goblet Squat

Beginner #40
Quads, Glutes, Core
Hold weight at chest, squat between knees, keep back flat.

Leg Press

Beginner #41
Quads, Glutes
Sit in machine, push platform with feet, stop before lockout.

Bulgarian Split Squat

Intermediate #42
Quads, Glutes
One foot on bench behind you, squat on front leg.

Walking Lunges

Beginner #43
Quads, Glutes
Step forward, lower back knee to floor, alternate legs.

Romanian Deadlift (RDL)

Intermediate #44
Hamstrings, Glutes
Hinge at hips, lower weight while keeping legs straight but not locked.

Leg Extension

Beginner #45
Quads
Sit and extend legs against resistance.

Lying Leg Curl

Beginner #46
Hamstrings
Lie face down, curl legs toward glutes.

Seated Leg Curl

Beginner #47
Hamstrings
Sit and curl legs down toward seat.

Hip Thrust

Intermediate #48
Glutes
Back on bench, bar across hips, drive hips toward ceiling.

Glute Bridge

Beginner #49
Glutes
Lie on back, feet flat, drive hips up, squeeze glutes.

Step-Ups

Beginner #50
Quads, Glutes
Step up onto box, drive through front heel, stand tall.

Standing Calf Raise

Beginner #51
Calves
Rise onto toes, pause, lower heels below platform.

Seated Calf Raise

Beginner #52
Calves (Soleus)
Sit, raise toes against weight, lower heels.

Hack Squat

Intermediate #53
Quads
Squat on angled machine platform, back supported.

Barbell Curl

Beginner #54
Biceps
Stand, curl bar toward shoulders, keep elbows at sides.

Dumbbell Alternating Curl

Beginner #55
Biceps
Alternate curling dumbbells, rotate palms up at top.

Hammer Curl

Beginner #56
Biceps, Brachialis
Curl dumbbells with neutral grip (palms facing each other).

Preacher Curl

Beginner #57
Biceps
Arms on bench, curl bar up, full range of motion.

Concentration Curl

Beginner #58
Biceps
Sit, elbow against inner thigh, curl dumbbell.

Incline Dumbbell Curl

Intermediate #59
Biceps
Sit on incline bench, curl weights from full stretch.

Cable Bicep Curl

Beginner #60
Biceps
Stand and curl cable bar toward shoulders.

Tricep Push-Down (Rope)

Beginner #61
Triceps
Pull rope down to thighs, flare ends apart at bottom.

Skull Crushers

Intermediate #62
Triceps
Lie on bench, lower bar to forehead, extend arms back up.

Overhead Dumbbell Extension

Beginner #63
Triceps
Hold weight overhead, lower behind head, extend up.

Dips (Tricep Version)

Intermediate #64
Triceps
Keep body upright, elbows tucked, lower and push up.

Close Grip Bench Press

Intermediate #65
Triceps, Inner Chest
Bench press with hands shoulder-width apart.

Dumbbell Kickback

Beginner #66
Triceps
Hinge forward, arm at side, extend weight back.

Tricep Bench Dips

Beginner #67
Triceps
Hands on bench behind you, lower hips, push back up.

Plank

Beginner #68
Core
Hold top of push-up or elbows, keep body perfectly straight.

Side Plank

Beginner #69
Obliques
Balance on one elbow and side of foot, hold hips high.

Crunches

Beginner #70
Abs
Lie on back, knees bent, lift shoulder blades off floor.

Leg Raises

Beginner #71
Lower Abs
Lie on back, lift straight legs to 90 degrees, lower slowly.

Hanging Leg Raise

Intermediate #72
Abs, Hip Flexors
Hang from bar, lift legs to 90 degrees or toes to bar.

Russian Twist

Beginner #73
Obliques
Sit, lean back, rotate torso to touch floor on each side.

Ab Wheel Roll-out

Advanced #74
Core
Kneel, roll wheel out as far as possible, pull back in.

Bicycle Crunch

Beginner #75
Abs, Obliques
Lie on back, alternate elbow to opposite knee in pedaling motion.

Mountain Climbers

Beginner #76
Core, Cardio
In plank, drive knees to chest rapidly.

Bird Dog

Beginner #77
Core, Lower Back
On all fours, extend opposite arm and leg simultaneously.

Woodchoppers

Beginner #78
Obliques, Core
Pull cable diagonally across body from high to low.

V-Ups

Intermediate #79
Abs
Simultaneously lift torso and legs to form a 'V' shape.

Dead Bug

Beginner #80
Core
Lie on back, lower opposite arm and leg while keeping back flat.

Pallof Press

Beginner #81
Core (Anti-Rotation)
Hold cable at chest, press forward, resist being pulled sideways.

Burpees

Intermediate #82
Full Body
Drop to push-up, jump feet in, explosive jump up.

Box Jumps

Intermediate #83
Legs, Explosive Power
Jump onto box, land softly, step down.

Kettlebell Swing

Intermediate #84
Glutes, Hamstrings, Back
Hinge and swing bell between legs to chest height.

Thrusters

Advanced #85
Full Body
Squat and immediately press weights overhead.

Wall Balls

Intermediate #86
Full Body
Squat and throw ball to target on wall, catch and repeat.

Clean and Press

Advanced #87
Full Body
Pull bar from floor to shoulders, then press overhead.

Farmers Walk

Beginner #88
Grip, Core, Traps
Walk while holding heavy weights at sides, keep posture.

Turkish Get-Up

Advanced #89
Full Body, Shoulders, Core
Lie down with weight, stand up without dropping it, reverse.

Jump Squats

Beginner #90
Legs
Perform squat, explode into jump, land softly.

Clap Push-Ups

Advanced #91
Chest, Power
Explosive push-up where hands leave floor and clap.

Battle Ropes

Beginner #92
Shoulders, Arms, Core
Wave ropes up and down or in circles rapidly.

Sled Push

Beginner #93
Legs, Cardio
Push weighted sled across floor.

Medicine Ball Slams

Beginner #94
Core, Shoulders
Lift ball overhead, slam it to floor as hard as possible.

Mountain Climbers

Beginner #95
Full Body, Cardio
Running motion in a plank position.

Bear Crawls

Intermediate #96
Full Body, Core
Crawl on hands and feet, keep hips low and back flat.

Jumping Lunges

Intermediate #97
Legs, Cardio
Lunge and jump to switch legs in mid-air.

Broad Jumps

Intermediate #98
Legs, Power
Jump forward for maximum distance, land softly.

Pistol Squat

Advanced #99
Legs
Squat on one leg, other leg extended forward.

Hollow Body Hold

Intermediate #100
Core
Lie on back, lift arms/legs slightly, press lower back to floor.