exercises

Advanced exercise filtering

Filter exercises by multiple criteria with fuzzy search support and cursor-based pagination.

get/api/v1/exercises

Request

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

Query parameters

namestring

Filter exercises by name. Supports fuzzy matching.

Example:Bench Press
targetMusclesstring

Filter exercises by primary target muscles. Use comma-separated values for multiple muscles.

Example:pectorals,deltoids
secondaryMusclesstring

Filter exercises by secondary muscles. Use comma-separated values for multiple muscles.

Example:abdominals,trapezius
bodyPartsstring

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

Example:Chest,Shoulders
equipmentsstring

Filter exercises by required equipment. Use comma-separated values for multiple equipment types.

Example:Barbell,Dumbbell
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.