exercises

GetExercisesByBodyparts

Filter exercises by bodyparts with cursor-based pagination.

get/api/v1/exercises/bodyparts

Request

  • Base URL: https://oss.exercisedb.dev
  • URL: https://oss.exercisedb.dev/api/v1/exercises/bodyparts
  • Auth: RapidAPIKey (a scheme the document does not define)

Query parameters

bodyPartsstring

Filter exercises by body parts. Use comma-separated values for multiple body parts.

Example:Chest,Shoulders
limitstring

Maximum number of results to return (min: 1, max: 25, default: 10)

Example:10
afterstring

Exercise ID to paginate after (for forward pagination)

beforestring

Exercise ID to paginate before (for backward pagination)

Response

Retrieve exercises by search filters

successboolean required

Indicates whether the request was successful

Example response

{
  "success": true,
  "meta": {
    "total": 1789,
    "hasNextPage": true
  },
  "data": [
    {
      "exerciseId": "EIeI8Vf",
      "name": "barbell bench press",
      "bodyParts": [
        "Chest"
      ],
      "equipments": [
        "Barbell"
      ],
      "targetMuscles": [
        "pectorals"
      ],
      "secondaryMuscles": [
        "deltoids",
        "triceps"
      ],
      "gifUrl": "https://static.exercisedb.dev/media/EIeI8Vf.gif",
      "instructions": [
        "Step:1 Settle onto a bench with your feet planted and your back pressed against the bench.",
        "Step:2 Hold the barbell with palms facing down just beyond shoulder width.",
        "Step:3 Brace the torso and align the wrists with the forearms.",
        "Step:4 Press the weight or handles away while keeping your trunk braced.",
        "Step:5 Keep the wrists stacked and use a shoulder path that feels natural.",
        "Step:6 Lower the weight to its starting height under control before pressing again."
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.