Search exercises

Search exercises by text query in names and instruction steps, with optional filters for muscles, difficulty, and more.

qstring required

Search query (2-200 characters)

limitinteger

Maximum number of results (1-50)

genderstring nullable

Filter videos by gender: 'male' or 'female'

categorystring nullable

Filter by equipment category

musclesstring[] nullable

Filter by primary muscle groups

difficultystring nullable

Filter by difficulty level

forcestring nullable

Filter by force type

mechanicstring nullable

Filter by mechanic type

langstring nullable

Response language code (e.g. 'en-us', 'pt-br'). Defaults to 'en-us' when omitted. See GET /languages for the full list. Non-English languages require GROWTH tier or higher (BASIC keys get them in the Playground).

Response

Successful Response

idinteger required

Unique exercise identifier

namestring required

Exercise name

primary_musclesstring[] required

Primary muscle groups targeted

categorystring required

Equipment category

forcestring nullable

Force type: Push, Pull, or Hold

gripsstring[] required

Grip types used

mechanicstring nullable

Exercise mechanic: Isolation or Compound

difficultystring nullable

Difficulty level: Novice, Beginner, Intermediate, or Advanced

stepsstring[] required

Step-by-step instructions

bodymap_malestring nullable

Base bodymap stream URL for male images

bodymap_femalestring nullable

Base bodymap stream URL for female images

Example response

[
  {
    "bodymap_female": "https://api.musclewiki.com/stream/images/bodymaps/1?gender=female",
    "bodymap_male": "https://api.musclewiki.com/stream/images/bodymaps/1?gender=male",
    "category": "Barbell",
    "difficulty": "Intermediate",
    "force": "Pull",
    "grips": [
      "Underhand"
    ],
    "id": 1,
    "mechanic": "Isolation",
    "name": "Barbell Curl",
    "primary_muscles": [
      "Biceps"
    ],
    "steps": [
      "While holding the upper arms stationary, curl the weights forward.",
      "Continue the movement until your biceps are fully contracted.",
      "Hold the contracted position for a second.",
      "Slowly bring the weight back down to the starting position."
    ],
    "videos": [
      {
        "angle": "front",
        "gender": "male",
        "og_image": "https://api.musclewiki.com/stream/images/og_images/og-male-Barbell-barbell-curl-front.jpg",
        "url": "https://api.musclewiki.com/stream/videos/branded/male-Barbell-barbell-curl-front.mp4"
      },
      {
        "angle": "side",
        "gender": "male",
        "og_image": "https://api.musclewiki.com/stream/images/og_images/og-male-Barbell-barbell-curl-side.jpg",
        "url": "https://api.musclewiki.com/stream/videos/branded/male-Barbell-barbell-curl-side.mp4"
      }
    ]
  }
]

Search exercises

Query parameters

Response

Example response

Changes