Docs navigation
Search
Search, filter, and paginate exercises
`GET /v1/exercises` supports search queries, exact filters, random ordering, and standard offset-based pagination.
Supported filters
q
Full-text search query.
string
category
Top-level training category.
enum
muscle
Display muscle group or anatomical muscle name.
string
equipment
Equipment filter.
string
level
Difficulty level.
enum
force
Movement force classification.
enum
mechanic
Movement mechanic.
enum
random
Return random results instead of the default order.
boolean · default false
limit
Requested page size before plan-based clamping.
integer · default 20
offset
Zero-based offset into the result set.
integer · default 0
Search semantics
- `GET /v1/exercises` returns `total: null` when `q` is present. Filter-only requests return a numeric total.
- `limit` is validated up to 100 and then clamped to your plan's per-request result cap.
- Free-tier pagination depth is capped at `offset + limit <= 500`.
- `muscle` accepts either a display group such as `chest` or an anatomical name such as `latissimus dorsi`.
Categories
- Strength · strength
- Yoga · yoga
- Mobility · mobility
- Physical Therapy · physical_therapy
- Stretching · stretching
- Pilates · pilates
- Calisthenics · calisthenics
- Plyometrics · plyometrics
- Conditioning · conditioning
- Olympic Weightlifting · olympic_weightlifting
- Powerlifting · powerlifting
- Strongman · strongman
Search response (`total: null`)
{
"data": [
{
"id": "Barbell_Bench_Press_-_Medium_Grip",
"name": "Barbell Bench Press - Medium Grip",
"keywords": [
"bench press",
"flat bench",
"barbell press",
"chest press",
"BP",
"bench",
"flat barbell press"
],
"primaryMuscles": [
"pectoralis major sternal head",
"pectoralis major clavicular head"
],
"secondaryMuscles": [
"deltoid anterior",
"triceps brachii long head",
"triceps brachii lateral head",
"triceps brachii medial head"
],
"equipment": "barbell",
"force": "push",
"level": "beginner",
"mechanic": "compound",
"category": "strength",
"instructions": [
"Lie back on a flat bench. Using a medium width grip (a grip that creates a 90-degree angle in the middle of the movement between the forearms and the upper arms), lift the bar from the rack and hold it straight over you with your arms locked. This will be your starting position.",
"From the starting position, breathe in and begin coming down slowly until the bar touches your middle chest.",
"After a brief pause, push the bar back to the starting position as you breathe out. Focus on pushing the bar using your chest muscles. Lock your arms and squeeze your chest in the contracted position at the top of the motion, hold for a second and then start coming down slowly again. Tip: Ideally, lowering the weight should take about twice as long as raising it."
],
"exerciseTips": [
"Retract your shoulder blades and maintain arch in your back",
"Drive through your heels and engage your glutes for stability",
"Lower the bar to your chest with control over 2-3 seconds"
],
"commonMistakes": [
"Bouncing the bar off the chest instead of controlled touch-and-go",
"Flaring elbows too wide, creating shoulder impingement risk",
"Lifting feet off the ground, reducing stability and power"
],
"safetyInfo": "Always use a spotter or safety bars when lifting heavy weights. Avoid this exercise if you have shoulder impingement issues.",
"overview": "The barbell bench press is a fundamental compound movement for building chest, shoulder, and tricep strength. It's considered the gold standard for upper body pressing power.",
"variations": [
"Machine Chest Press",
"Single Arm Dumbbell Chest Press",
"Standing Cable Chest Press",
"Multi Grip Press",
"Incline Push-Up Wide"
],
"images": [
"Barbell_Bench_Press_-_Medium_Grip/0.jpg",
"Barbell_Bench_Press_-_Medium_Grip/1.jpg"
]
}
],
"total": null,
"limit": 10,
"offset": 0
}Filter-only response (`total` numeric)
{
"data": [
{
"id": "Barbell_Bench_Press_-_Medium_Grip",
"name": "Barbell Bench Press - Medium Grip",
"keywords": [
"bench press",
"flat bench",
"barbell press",
"chest press",
"BP",
"bench",
"flat barbell press"
],
"primaryMuscles": [
"pectoralis major sternal head",
"pectoralis major clavicular head"
],
"secondaryMuscles": [
"deltoid anterior",
"triceps brachii long head",
"triceps brachii lateral head",
"triceps brachii medial head"
],
"equipment": "barbell",
"force": "push",
"level": "beginner",
"mechanic": "compound",
"category": "strength",
"instructions": [
"Lie back on a flat bench. Using a medium width grip (a grip that creates a 90-degree angle in the middle of the movement between the forearms and the upper arms), lift the bar from the rack and hold it straight over you with your arms locked. This will be your starting position.",
"From the starting position, breathe in and begin coming down slowly until the bar touches your middle chest.",
"After a brief pause, push the bar back to the starting position as you breathe out. Focus on pushing the bar using your chest muscles. Lock your arms and squeeze your chest in the contracted position at the top of the motion, hold for a second and then start coming down slowly again. Tip: Ideally, lowering the weight should take about twice as long as raising it."
],
"exerciseTips": [
"Retract your shoulder blades and maintain arch in your back",
"Drive through your heels and engage your glutes for stability",
"Lower the bar to your chest with control over 2-3 seconds"
],
"commonMistakes": [
"Bouncing the bar off the chest instead of controlled touch-and-go",
"Flaring elbows too wide, creating shoulder impingement risk",
"Lifting feet off the ground, reducing stability and power"
],
"safetyInfo": "Always use a spotter or safety bars when lifting heavy weights. Avoid this exercise if you have shoulder impingement issues.",
"overview": "The barbell bench press is a fundamental compound movement for building chest, shoulder, and tricep strength. It's considered the gold standard for upper body pressing power.",
"variations": [
"Machine Chest Press",
"Single Arm Dumbbell Chest Press",
"Standing Cable Chest Press",
"Multi Grip Press",
"Incline Push-Up Wide"
],
"images": [
"Barbell_Bench_Press_-_Medium_Grip/0.jpg",
"Barbell_Bench_Press_-_Medium_Grip/1.jpg"
]
}
],
"total": 2198,
"limit": 20,
"offset": 0
}