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
(4.4)

From 4,832 users

1,400+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
268ms290ms339ms507ms948ms

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

  • 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:

  • difficulty  optional

    Difficulty level of the exercise. Possible values are: beginner, intermediate, expert.

  • equipments  optional

    Equipment required for the exercise. Multiple equipments can be specified using comma separation (e.g. dumbbell,flat bench). This value can be partial (e.g. dumbbell will match exercises using dumbbells).

  • offset  optional premium

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

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

Returns an array of exercise objects. Each object contains:

  • name

    Name of the exercise.

  • type

    Exercise type (for example strength, cardio).

  • muscle

    Primary muscle group targeted by the exercise.

  • difficulty

    Difficulty level of the exercise (beginner, intermediate, or expert).

  • instructions

    Text instructions describing how to perform the exercise.

  • equipments

    Array of equipment names required for the exercise.

  • safety_info

    Additional safety guidance and cues for performing the exercise safely.

Sample Request Live Demo!

name
type
muscle
difficulty
equipments
offset premium

Try this API endpoint with all available parameters in our API playground

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

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

  • muscle  required

    Muscle group targeted by the exercise. Possible values are:

  • limit  optional

    Maximum number of results to return. Default is 10, maximum is 100.

  • offset  optional

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

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

Returns an array of exercise names as strings (for example "Incline Hammer Curls").

Sample Request Live Demo!

muscle
limit
offset

Try this API endpoint with all available parameters in our API playground

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

Headers

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

Sample Response

JSON