Exercises API

The Exercises API provides access to a comprehensive list of thousands of exercises targeting every major muscle group.

/v1/exercises GET

https://api.api-ninjas.com/v1/exercises

Returns up to 5 exercises that satisfy the given parameters.


Parameters

  • name  optional

    Name of exercise. This value can be partial (e.g. press will match Dumbbell Bench Press).

  • type  optional

    Exercise type. Possible values are:

    cardio
    olympic_weightlifting
    plyometrics
    powerlifting
    strength
    stretching
    strongman
  • muscle  optional

    Muscle group targeted by the exercise. Possible values are:

    abdominals
    abductors
    adductors
    biceps
    calves
    chest
    forearms
    glutes
    hamstrings
    lats
    lower_back
    middle_back
    neck
    quadriceps
    traps
    triceps
  • difficulty  optional

    Difficulty level of the exercise. Possible values are:

    beginner
    intermediate
    expert
  • offset  optional premium

    Number of results to offset for pagination. Default is 0.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request Live Demo!

muscle
https://api.api-ninjas.com/v1/exercises?muscle=biceps

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
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 3 4 5 6 7 8 9 import requests muscle = 'biceps' api_url = 'https://api.api-ninjas.com/v1/exercises?muscle={}'.format(muscle) response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'}) if response.status_code == requests.codes.ok: print(response.text) else: print("Error:", response.status_code, response.text)

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.

Annual premium subscriptions only

/v1/allexercises GET

https://api.api-ninjas.com/v1/allexercises

Returns a comprehensive list of exercises that target a specific muscle group.


Parameters

  • muscle  required

    Muscle group targeted by the exercise. Possible values are:

    abdominals
    abductors
    adductors
    biceps
    calves
    chest
    forearms
    glutes
    hamstrings
    lats
    lower_back
    middle_back
    neck
    quadriceps
    traps
    triceps

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request

https://api.api-ninjas.com/v1/allexercises?muscle=biceps

Sample Response

JSON
1 2 3 4 5 6 7 [ "Incline Hammer Curls", "Wide-grip barbell curl", "EZ-bar spider curl", "Hammer Curls", ... ]