Exercises API
The Exercises API provides access to a comprehensive list of over 3000 exercises targeting every major muscle group.
Available endpoints:
- /v1/exercises - Search for exercises by name, type, muscle group, and difficulty
- /v1/allexercises - Get a comprehensive list of exercises that target a specific muscle group
API Status
API Response Times
Average | P50 | P75 | P90 | P95 |
|---|---|---|---|---|
| 279ms | 306ms | 361ms | 513ms | 1122ms |
Didn't find what you were looking for? Suggest an improvement
/v1/exercises GET
https://api.api-ninjas.com/v1/exercises
Returns up to 5 exercises that satisfy the given parameters.
Parameters
nameoptionalName of exercise. This value can be partial (e.g.
presswill matchDumbbell Bench Press).typeoptionalExercise type. Possible values are:
cardio,olympic_weightlifting,plyometrics,powerlifting,strength,stretching,strongman.muscleoptionalMuscle group targeted by the exercise. Possible values are:
difficultyoptionalDifficulty level of the exercise. Possible values are:
beginner,intermediate,expert.equipmentsoptionalEquipment required for the exercise. Multiple equipments can be specified using comma separation (e.g.
dumbbell,flat bench). This value can be partial (e.g.dumbbellwill match exercises using dumbbells).offsetoptional premiumNumber of results to offset for pagination. Default is
0.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Sample Request Live Demo!
Try this API endpoint with all available parameters in our API playground
https://api.api-ninjas.com/v1/exercises?muscle=bicepsHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
[
{
"name": "Incline Hammer Curls",
"type": "strength",
"muscle": "biceps",
"difficulty": "beginner",
"instructions": "Seat yourself on an incline bench with a dumbbell in each hand. You should pressed firmly against he back with your feet together. Allow the dumbbells to hang straight down at your side, holding them with a neutral grip. This will be your starting position. Initiate the movement by flexing at the elbow, attempting to keep the upper arm stationary. Continue to the top of the movement and pause, then slowly return to the start position.",
"equipments": [
"dumbbells",
"incline bench"
],
"safety_info": "Keep your back firmly against the incline bench with feet together; keep upper arms stationary and move only at the elbows. Lift and lower under control without swinging, use a manageable weight, and avoid locking the elbows or arching your back."
},
{
"name": "Wide-grip barbell curl",
"type": "strength",
"muscle": "biceps",
"difficulty": "beginner",
"instructions": "Stand up with your torso upright while holding a barbell at the wide outer handle. The palm of your hands should be facing forward. The elbows should be close to the torso. This will be your starting position. While holding the upper arms stationary, curl the weights forward while contracting the biceps as you breathe out. Tip: Only the forearms should move. Continue the movement until your biceps are fully contracted and the bar is at shoulder level. Hold the contracted position for a second and squeeze the biceps hard. Slowly begin to bring the bar back to starting position as your breathe in. Repeat for the recommended amount of repetitions. Variations: You can also perform this movement using an E-Z bar or E-Z attachment hooked to a low pulley. This variation seems to really provide a good contraction at the top of the movement. You may also use the closer grip for variety purposes.",
"equipments": [
"barbell"
],
"safety_info": "Stand upright with elbows kept close to the torso and upper arms stationary; only the forearms should move. Control the weight, especially on the descent, and coordinate breathing (exhale while curling, inhale while lowering)."
},
...
]Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v1/exercises?muscle=biceps" \
-H "X-Api-Key: YOUR_API_KEY"If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.
/v1/allexercises GET
Business, Professional, or annual subscriptions only
https://api.api-ninjas.com/v1/allexercises
Returns a comprehensive list of exercises that target a specific muscle group.
Parameters
musclerequiredMuscle group targeted by the exercise. Possible values are:
limitoptionalMaximum number of results to return. Default is
10, maximum is100.offsetoptionalNumber of results to offset for pagination. Default is
0.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Sample Request Live Demo!
Try this API endpoint with all available parameters in our API playground
https://api.api-ninjas.com/v1/allexercises?muscle=biceps&limit=10Headers
X-Api-KeyLog in or sign up to get your API KeySample Response
1
2
3
4
5
6
7
[
"Incline Hammer Curls",
"Wide-grip barbell curl",
"EZ-bar spider curl",
"Hammer Curls",
...
]