> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ascendapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# EXERCISEB V1

> A developer-friendly fitness exercise database featuring over 2,000 structured exercises with rich metadata, images, and GIFs. Available as a free hosted tier and a paid RapidAPI tier with enhanced features.

***

## Free vs Paid

<Tabs>
  <Tab title="Free">
    1,500 exercises with 180p GIFs. No authentication required, just call the hosted API directly.

    ```bash theme={"system"}
    curl -X GET "https://oss.exercisedb.dev/api/v1/exercises"
    ```

    <Card title="Free API Docs" icon="book-open" href="https://oss.exercisedb.dev/docs">
      Full endpoint reference for the free tier.
    </Card>
  </Tab>

  <Tab title="Paid (RapidAPI)">
    Enhanced data with multi-resolution media, difficulty levels, exercise types, and more.

    <Steps>
      <Step title="Subscribe on RapidAPI">
        Head to [EDB WITH IMAGES AND GIFS on RapidAPI](https://rapidapi.com/ascendapi/api/edb-with-gifs-and-images-by-ascendapi) and subscribe to a plan.
      </Step>

      <Step title="Copy your API key">
        After subscribing, go to the **App** tab in the playground and copy your `X-RapidAPI-Key`.
      </Step>

      <Step title="Add headers to every request">
        | Header            | Value                                                  |
        | ----------------- | ------------------------------------------------------ |
        | `X-RapidAPI-Key`  | Your unique API key from the RapidAPI dashboard        |
        | `X-RapidAPI-Host` | `edb-with-gifs-and-images-by-ascendapi.p.rapidapi.com` |
      </Step>
    </Steps>

    <Info>
      Not sure how to subscribe? Follow the [Quickstart guide](/quickstart) for a step-by-step walkthrough.
    </Info>
  </Tab>
</Tabs>

***

## Schema

<Tabs>
  <Tab title="Free">
    ```json theme={"system"}
    {
      "exerciseId": "EIeI8Vf",
      "name": "barbell bench press",
      "gifUrl": "https://static.exercisedb.dev/media/EIeI8Vf.gif",
      "targetMuscles": ["pectorals"],
      "bodyParts": ["chest"],
      "equipments": ["barbell"],
      "secondaryMuscles": ["triceps", "shoulders"],
      "instructions": [
        "Step:1 Lie flat on a bench with your feet flat on the ground...",
        "Step:2 Grasp the barbell with an overhand grip...",
        "Step:3 Lift the barbell off the rack...",
        "Step:4 Lower the barbell slowly towards your chest...",
        "Step:5 Pause for a moment when the barbell touches your chest.",
        "Step:6 Push the barbell back up to the starting position...",
        "Step:7 Repeat for the desired number of repetitions."
      ]
    }
    ```

    | Field              | Type       | Description                |
    | ------------------ | ---------- | -------------------------- |
    | `exerciseId`       | `string`   | Unique exercise identifier |
    | `name`             | `string`   | Exercise name              |
    | `gifUrl`           | `string`   | Single animated GIF URL    |
    | `bodyParts`        | `string[]` | Target body regions        |
    | `targetMuscles`    | `string[]` | Primary muscles worked     |
    | `secondaryMuscles` | `string[]` | Supporting muscles         |
    | `equipments`       | `string[]` | Required equipment         |
    | `instructions`     | `string[]` | Step-by-step guide         |
  </Tab>

  <Tab title="Paid (RapidAPI)">
    ```json theme={"system"}
    {
      "exerciseId": "edb_T5uXtLj",
      "name": "barbell bench press",
      "bodyParts": ["chest"],
      "targetMuscles": ["pectorals"],
      "secondaryMuscles": ["triceps", "shoulders"],
      "equipments": ["barbell"],
      "difficulty": "intermediate",
      "exerciseTypes": ["strength"],
      "overview": "The barbell bench press is a classic compound exercise...",
      "imageUrls": {
        "360p": "https://assets.exercisedb.dev/media/uc9UW4p.png",
        "480p": "https://assets.exercisedb.dev/media/KrucGym.png",
        "720p": "https://assets.exercisedb.dev/media/jVlPn4h.png",
        "1080p": "https://assets.exercisedb.dev/media/UlcSMxu.png"
      },
      "gifUrls": {
        "360p": "https://assets.exercisedb.dev/media/qU7GQpl.gif",
        "480p": "https://assets.exercisedb.dev/media/bqZjg7F.gif",
        "720p": "https://assets.exercisedb.dev/media/Ec7u4jR.gif",
        "1080p": "https://assets.exercisedb.dev/media/q61OKxC.gif"
      },
      "instructions": [
        "Step:1 Lie flat on a bench...",
        "Step:7 Repeat for the desired number of repetitions."
      ],
      "relatedExerciseIds": ["edb_mbpKFKd", "edb_SIiTlYd", "edb_TUGkclM", "edb_WQUuNhp"]
    }
    ```

    | Field                       | Type       | Description                          | Status         |
    | --------------------------- | ---------- | ------------------------------------ | -------------- |
    | `exerciseId`                | `string`   | Unique exercise identifier           | ✅ Available    |
    | `name`                      | `string`   | Exercise name                        | ✅ Available    |
    | `bodyParts`                 | `string[]` | Target body regions                  | ✅ Available    |
    | `targetMuscles`             | `string[]` | Primary muscles worked               | ✅ Available    |
    | `secondaryMuscles`          | `string[]` | Supporting muscles                   | ✅ Available    |
    | `equipments`                | `string[]` | Required equipment                   | ✅ Available    |
    | `difficulty`                | `string`   | Difficulty level                     | ✅ Available    |
    | `exerciseTypes`             | `string[]` | Type of exercise                     | ✅ Available    |
    | `imageUrls`                 | `object`   | Multi-resolution images (360p–1080p) | ✅ Available    |
    | `gifUrls`                   | `object`   | Multi-resolution GIFs (360p–1080p)   | ✅ Available    |
    | `overview`                  | `string`   | Exercise description                 | ✅ Available    |
    | `instructions`              | `string[]` | Step-by-step guide                   | ✅ Available    |
    | `relatedExerciseIds`        | `string[]` | Related exercises                    | ✅ Available    |
    | `maleMuscleActivationUrl`   | `string`   | Male Workout activation  URL         | 🔜 Next Update |
    | `femaleMuscleActivationUrl` | `string`   | Female Workout activation  URL       | 🔜 Next Update |
    | `exerciseTips`              | `string[]` | Pro hypertrophy tips                 | 🔵 Coming Soon |
    | `caloriesBurned`            | `number`   | Estimated calories per set           | 🔵 Coming Soon |
    | `movementType`              | `string`   | Compound or isolation                | 🔵 Coming Soon |
    | `commonMistake`             | `string[]` | Common form mistakes                 | 🔵 Coming Soon |
  </Tab>
</Tabs>

***

## Media

Every exercise includes rich media served from a fast CDN.

<Note>
  Media resolution and availability depends on your plan. The free tier includes **180p GIFs only**. Multi-resolution images and GIFs (360p–1080p) are available on the **paid RapidAPI tier**.
</Note>

<Tabs>
  <Tab title="Free">
    A single GIF per exercise.

    ```json theme={"system"}
    "gifUrl": "https://static.exercisedb.dev/media/EIeI8Vf.gif"
    ```
  </Tab>

  <Tab title="Paid (RapidAPI)">
    ### Images

    | Resolution | Recommended Use                       |
    | ---------- | ------------------------------------- |
    | `360p`     | Thumbnails, list views, low-bandwidth |
    | `480p`     | Cards, preview tiles                  |
    | `720p`     | Detail pages, standard displays       |
    | `1080p`    | Full-screen, retina displays          |

    <Frame>
      <img src="https://assets.exercisedb.dev/media/jVlPn4h.png" alt="Bench Press 720p" />
    </Frame>

    ### GIFs

    Each exercise includes an gifs demonstration.

    <Frame>
      <img src="https://assets.exercisedb.dev/media/Ec7u4jR.gif" alt="Bench Press Gif 720p" />
    </Frame>

    ### Workout Activation

    Male and female workout activation images per exercise coming in the next update.

    <Tip>
      The primary and secondary muscle colors in the image are customizable.
    </Tip>

    <Tabs>
      <Tab title="Male">
        <Frame>
          <img src="https://cdn.exercisedb.dev/exercisedb/workout-map.png" alt="Male muscle activation" />
        </Frame>
      </Tab>

      <Tab title="Female">
        <Frame>
          <img src="https://cdn.exercisedb.dev/exercisedb/workout-f-2.png" alt="Female muscle activation" />
        </Frame>
      </Tab>
    </Tabs>
  </Tab>
</Tabs>

***

## Perfect For

<AccordionGroup>
  <Accordion title="Fitness Apps" icon="dumbbell">
    Display targeted exercise data with rich visuals, muscle diagrams, and step-by-step instructions inside your app.
  </Accordion>

  <Accordion title="Workout Planners" icon="calendar">
    Build structured programs using body part targeting, difficulty levels, and exercise types.
  </Accordion>

  <Accordion title="Personal Training" icon="user">
    Equip trainers with detailed exercise breakdowns, equipment requirements, and related exercise suggestions.
  </Accordion>

  <Accordion title="Strength Training" icon="chart-line">
    Filter by equipment, difficulty, and muscle groups to build progressive overload programs.
  </Accordion>
</AccordionGroup>

***

## Resources

<CardGroup cols={2}>
  <Card title="API Reference" icon="code" href="/api-reference">
    Full endpoint details, parameters, and response shapes.
  </Card>

  <Card title="Website" icon="link" href="https://ascendapi.com">
    Pricing, demos, and more about EXERCISEB V1.
  </Card>
</CardGroup>