exercises

List exercises

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

get/exercises

Query parameters

limitinteger

Maximum number of results (1-100)

Maximum number of results (1-100)

offsetinteger

Number of results to skip

Number of results to skip

searchstring nullable

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

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

genderstring nullable

Filter by gender: 'male' or 'female'

Filter by gender: 'male' or 'female'

categorystring nullable

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

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

musclesstring[] nullable

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

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

difficultystring nullable

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

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

forcestring nullable

Filter by force type: Push, Pull, or Hold

Filter by force type: Push, Pull, or Hold

mechanicstring nullable

Filter by mechanic: Isolation or Compound

Filter by mechanic: Isolation or Compound

gripsstring[] nullable

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

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

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

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

No recorded changes to this endpoint across all 1 revision of this API.