exercises

Get a paginated list of exercises with optional filtering. Returns minimal information optimized for list views.

get/exercises

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

limitinteger

Maximum number of results (1-100)

offsetinteger

Number of results to skip

searchstring nullable

Search in exercise names and steps (2-200 characters)

genderstring nullable

Filter by gender: 'male' or 'female'

categorystring nullable

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

musclesstring[] nullable

Filter by primary muscle groups (e.g., Biceps, Chest)

difficultystring nullable

Filter by difficulty: Novice, Beginner, Intermediate, or Advanced

forcestring nullable

Filter by force type: Push, Pull, or Hold

mechanicstring nullable

Filter by mechanic: Isolation or Compound

gripsstring[] nullable

Filter by grip types (e.g., Overhand, Underhand, Neutral)

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

totalinteger required

Total number of items

limitinteger required

Items per page

offsetinteger required

Items skipped

countinteger required

Items in current response

Example response

{
  "count": 20,
  "limit": 20,
  "offset": 0,
  "results": [],
  "total": 100
}

Changes

    • info

      added the new optional query request parameter secondary_muscles

    • info

      added the new optional query request parameter tertiary_muscles