Exercises API
The Exercises API provides access to a comprehensive list of thousands of 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
Checking API status...
/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:
cardioolympic_weightliftingplyometricspowerliftingstrengthstretchingstrongmanmuscleoptionalMuscle group targeted by the exercise. Possible values are:
abdominalsabductorsadductorsbicepscalveschestforearmsgluteshamstringslatslower_backmiddle_backneckquadricepstrapstricepsdifficultyoptionalDifficulty level of the exercise. Possible values are:
beginnerintermediateexpertoffsetoptional premiumNumber of results to offset for pagination. Default is
0.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Sample Request Live Demo!
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
[
{
"name": "Incline Hammer Curls",
"type": "strength",
"muscle": "biceps",
"equipment": "dumbbell",
"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."
},
{
"name": "Wide-grip barbell curl",
"type": "strength",
"muscle": "biceps",
"equipment": "barbell",
"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."
},
...
]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
Annual premium 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:
abdominalsabductorsadductorsbicepscalveschestforearmsgluteshamstringslatslower_backmiddle_backneckquadricepstrapstriceps
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Sample Request
https://api.api-ninjas.com/v1/allexercises?muscle=bicepsSample Response
1
2
3
4
5
6
7
[
"Incline Hammer Curls",
"Wide-grip barbell curl",
"EZ-bar spider curl",
"Hammer Curls",
...
]