---
title: "Search exercises"
method: GET
path: "/search"
tags: ["search"]
---

# Search exercises

`GET /search`

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

## Query parameters

- `q` string, required — Search query (2-200 characters)
- `limit` integer — Maximum number of results (1-50)
- `gender` string, nullable — Filter videos by gender: 'male' or 'female'
- `category` string, nullable — Filter by equipment category
- `muscles` string[], nullable — Filter by primary muscle groups
- `difficulty` string, nullable — Filter by difficulty level
- `force` string, nullable — Filter by force type
- `mechanic` string, nullable — Filter by mechanic type
- `lang` string, 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 `200`

Successful Response

- ExerciseStandard[]
  - `id` integer, required — Unique exercise identifier
  - `name` string, required — Exercise name
  - `primary_muscles` string[], required — Primary muscle groups targeted
  - `category` string, required — Equipment category
  - `force` string, nullable — Force type: Push, Pull, or Hold
  - `grips` string[], required — Grip types used
  - `mechanic` string, nullable — Exercise mechanic: Isolation or Compound
  - `difficulty` string, nullable — Difficulty level: Novice, Beginner, Intermediate, or Advanced
  - `steps` string[], required — Step-by-step instructions
  - `videos` Video[], required — Available video demonstrations
    - `url` string, nullable — Direct URL to the video file (can be null)
    - `angle` string, required — Camera angle: front or side
    - `gender` string, required — Gender variant: male or female
    - `og_image` string, nullable — Open Graph image URL for preview/thumbnail
  - `bodymap_male` string, nullable — Base bodymap stream URL for male images
  - `bodymap_female` string, nullable — Base bodymap stream URL for female images

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/musclewiki/apis/musclewiki-api.md) · [All operations](https://skmtc.dev/musclewiki/apis/musclewiki-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/musclewiki/musclewiki-api/revisions/fccb1308d3dc/schema)