MUmusclewiki
search

Search exercises

Changed on

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

get/search

Request

  • Base URL
    https://api.musclewiki.com (the document declares no server; this is the origin it was published from)
  • Auth
    none declared

Query parameters

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

secondary_musclesstring[] nullable

Filter by secondary muscle groups (repeatable; valid values are listed under secondary_muscles in GET /filters). PROFESSIONAL tier or higher; lower plans get 403.

tertiary_musclesstring[] nullable

Filter by tertiary muscle groups (repeatable; valid values are listed under tertiary_muscles in GET /filters). PROFESSIONAL tier or higher; lower plans get 403.

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

secondary_musclesstring[] nullable

Secondary muscle groups. Null when your plan does not include muscle roles (PROFESSIONAL tier or higher); [] when included but no data.

tertiary_musclesstring[] nullable

Tertiary muscle groups. Null when your plan does not include muscle roles (PROFESSIONAL tier or higher); [] when included but no data.

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"
    ],
    "secondary_muscles": [
      "Forearms"
    ],
    "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."
    ],
    "tertiary_muscles": [
      "Front Shoulders"
    ],
    "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"
      }
    ]
  }
]

Changes

  • 7ef30449176bRevision changes
    • info

      added the new optional query request parameter secondary_muscles

    • info

      added the new optional query request parameter tertiary_muscles

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status