Exercise API

You, • API documentation
Back

Endpoint: https://exercise.deta.dev/

Exercise API was built from the ground-up with a JSON API that makes it easy for developers to access extensive set the exercise datasets.

These docs describe how to use the Exercise API. We hope you enjoy these docs, and please don't hesitate to file an issue if you see anything missing.

Use Cases

There are many reasons to use the Exercise API. The most common use case is to gather information of any exercise. The information includes parameters like primary muscle

API Reference

Get a random exercise

  GET /api/v0/exercise
Parameter Type Description
api_key string Required. Your API key

Get an exercise by id

  GET /api/v0/exercise/${id}
Parameter Type Description
id string Required. Id of item to fetch

Query exercise which matches with any parameters

  GET /api/v0/exercise/withAny
Parameter Type Description
primaryMuscles string,string .. Optional. Primary Muscle
secondaryMuscles string,string .. Optional. Secondary Muscle
equipment string,string .. Optional. Equipment
mechanic string,string .. Optional. Mechanic
level string,string .. Optional. Level
force string,string .. Optional. Force
category string,string .. Optional. Category

Query exercise which matches with all parameters

  GET /api/v0/exercise/withAll
Parameter Type Description
primaryMuscles string,string .. Optional. Primary Muscle
secondaryMuscles string,string .. Optional. Secondary Muscle
equipment string,string .. Optional. Equipment
mechanic string,string .. Optional. Mechanic
level string,string .. Optional. Level
force string,string .. Optional. Force
category string,string .. Optional. Category

Parameter options

Muscle

  • abdominals
  • hamstrings
  • calves
  • shoulders
  • adductors
  • glutes
  • quadriceps
  • biceps
  • forearms
  • abductors
  • triceps
  • chest
  • lower_back
  • traps
  • middle back
  • lats
  • neck

Force

  • pull
  • push
  • static

Level

  • beginner
  • intermediate
  • expert

Mechanic

  • compound
  • isolation

Equipment

  • body
  • machine
  • kettlebells
  • dumbbell
  • cable
  • barbell
  • bands
  • medicine_ball
  • exercise_ball
  • e_z_curl_bar
  • foam_roll

Category

  • strength
  • stretching
  • plyometrics
  • strongman
  • powerlifting
  • cardio
  • olympic_weightlifting
  • crossfit
  • weighted_bodyweight
  • assisted_bodyweight

Response

exercise JSON

    {
      "dir": "3_4_Sit-Up",
      "name": "3/4 Sit-Up",
      "force": "pull",
      "level": "beginner",
      "mechanic": "compound",
      "equipment": "body only",
      "primaryMuscles": [
        "abdominals"
      ],
      "secondaryMuscles": [],
      "instructions": [
        "Lie down on the floor and secure your feet. Your legs should be bent at the knees.",
        "Place your hands behind or to the side of your head. You will begin with your back on the ground. This will be your starting position.",
        "Flex your hips and spine to raise your torso toward your knees.",
        "At the top of the contraction your torso should be perpendicular to the ground. Reverse the motion, going only ¾ of the way down.",
        "Repeat for the recommended amount of repetitions."
      ],
      "category": "strength"
    }

Status Codes

Exercise API returns the following status codes in its API:

Status Code Description
200 OK
201 CREATED
400 BAD REQUEST
404 NOT FOUND
500 INTERNAL SERVER ERROR

License

MIT

Author

Anish Roy