v1

latestOpenAPI 3.1.02026-07-2614977.9 KB

exercises

Advanced exercise filtering

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

get/api/v1/exercises

Query parameters

namestring

Filter exercises by name. Supports fuzzy matching.

Example:Bench Press

keywordsstring

Filter exercises by keywords. Use comma-separated values for multiple keywords.

Example:chest workout,barbell

targetMusclesstring

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

Example:Pectoralis Major Clavicular Head,Deltoid Anterior

secondaryMusclesstring

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

Example:Triceps Brachii,Deltoid Anterior

exerciseTypestring

Filter exercises by type (e.g., strength, cardio).

Example:strength

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": 12778,
    "hasNextPage": true
  },
  "data": [
    {
      "exerciseId": "exr_41n2hxnFMotsXTj3",
      "name": "Bench Press",
      "equipments": [
        "Barbell"
      ],
      "bodyParts": [
        "Chest"
      ],
      "exerciseType": "strength",
      "targetMuscles": [
        "Pectoralis Major Clavicular Head"
      ],
      "secondaryMuscles": [
        "Deltoid Anterior",
        "Pectoralis Major Clavicular Head",
        "Triceps Brachii"
      ],
      "keywords": [
        "Chest workout with barbell",
        "Barbell bench press exercise",
        "Strength training for chest",
        "Upper body workout with barbell",
        "Barbell chest exercises",
        "Bench press for chest muscles",
        "Building chest muscles with bench press",
        "Chest strengthening with barbell",
        "Bench press workout routine",
        "Barbell exercises for chest muscle growth"
      ]
    }
  ]
}