Sign in
metadata

Get random exercise

Get a random exercise, optionally filtered by category.

get/random

Query parameters

categorystring nullable

Filter by equipment category (e.g., barbell, dumbbell)

Filter by equipment category (e.g., barbell, dumbbell)

genderstring nullable

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

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

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 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"
    }
  ]
}

Changes