> ## 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 V2

> A multipurpose exercise dataset with 11,000+ exercises, 15,000+ videos, and 20,000+ images built for fitness, physiotherapy, strength training, and beyond.

<Note>
  Both free and paid tiers are accessed via RapidAPI. The only difference is that **free tier media is watermarked**. All fields, endpoints, and features are otherwise identical.
</Note>

***

## Get Your API Key

<Steps>
  <Step title="Subscribe on RapidAPI">
    Head to [ EDB with Videos and Images on RapidAPI](https://rapidapi.com/ascendapi/api/edb-with-videos-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-videos-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>

***

## Schema

```json theme={"system"}
 {
    "exerciseId": "exr_41n2hxnFMotsXTj3",
    "name": "Bench Press",
    "imageUrl": "https://cdn.exercisedb.dev/media/images/CNKJtB2O5Y.webp",
    "imageUrls": {
      "360p": "https://cdn.exercisedb.dev/media/images/bYjT0KGRUo.webp",
      "480p": "https://cdn.exercisedb.dev/media/images/CNKJtB2O5Y.webp",
      "720p": "https://cdn.exercisedb.dev/media/images/AetqvRI4jK.webp",
      "1080p": "https://cdn.exercisedb.dev/media/images/VM46gFp1mS.webp"
    },
    "equipments": ["BARBELL"],
    "bodyParts": ["CHEST"],
    "exerciseType": "STRENGTH",
    "targetMuscles": ["PECTORALIS MAJOR STERNAL HEAD"],
    "secondaryMuscles": ["PECTORALIS MAJOR CLAVICULAR HEAD", "ANTERIOR DELTOID", "TRICEPS BRACHII"],
    "videoUrl": "https://cdn.exercisedb.dev/videos/Trn4QDW/41n2hxnFMotsXTj3__Barbell-Bench-Press_Chest2_.mp4",
    "keywords": [
      "Chest workout with barbell",
      "Barbell bench press exercise",
      "Strength training for chest",
      "Upper body workout with barbell",
      "Barbell chest exercises",
      "Bench press for chest muscles",
      "Building chest muscles with bench press",
      "Chest strengthening with barbell",
      "Bench press workout routine",
      "Barbell exercises for chest muscle growth"
    ],
    "overview": "The Bench Press is a classic strength training exercise that primarily targets the chest, shoulders, and triceps, contributing to upper body muscle development. It is suitable for anyone, from beginners to professional athletes, looking to improve their upper body strength and muscular endurance. Individuals may want to incorporate bench press into their routine for its effectiveness in enhancing physical performance, promoting bone health, and improving body composition.",
    "instructions": [
      "Grip the barbell with your hands slightly wider than shoulder-width apart, palms facing your feet, and lift it off the rack, holding it straight over your chest with your arms fully extended.",
      "Slowly lower the barbell down to your chest while keeping your elbows at a 90-degree angle.",
      "Once the barbell touches your chest, push it back up to the starting position while keeping your back flat on the bench.",
      "Repeat this process for the desired number of repetitions, always maintaining control of the barbell and ensuring your form is correct."
    ],
    "exerciseTips": [
      "Avoid Arching Your Back: One common mistake is excessively arching the back during the lift. This can lead to lower back injuries. Your lower back should have a natural arch, but it should not be overly exaggerated. Your butt, shoulders, and head should maintain contact with the bench at all times.",
      "Controlled Movement: Avoid the temptation to lift the barbell too quickly. A controlled, steady lift is more effective and reduces the risk of injury. Lower the bar to your mid-chest slowly, pause briefly, then push it back up without locking your elbows at the top.",
      "Don't Lift Alone:"
    ],
    "variations": [
      "Decline Bench Press: This variation is performed on a decline bench to target the lower part of the chest.",
      "Close-Grip Bench Press: This variation focuses on the triceps and the inner part of the chest by placing the hands closer together on the bar.",
      "Dumbbell Bench Press: This variation uses dumbbells instead of a barbell, allowing for a greater range of motion and individual arm movement.",
      "Reverse-Grip Bench Press: This variation is performed by flipping your grip so that your palms face towards you, targeting the upper chest and triceps."
    ],
    "relatedExerciseIds": [
      "exr_41n2hPFTn4fEG8Bx",
      "exr_41n2hfGATUH6QYu5",
      "exr_41n2hYxxWAwXX57z",
      "exr_41n2heKDPVZrnq5Y",
      "exr_41n2hM1MEG81baQX",
      "exr_41n2hjhUQ3cXvDpe",
      "exr_41n2hNpnikEpEu7g",
      "exr_41n2htZnfjAfHeum",
      "exr_41n2hKxRy59v8iGj",
      "exr_41n2hU3GCnWWS86T"
    ]
  }
```

| 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 engaged            | ✅ Available    |
| `equipments`                | `string[]` | Required equipment                    | ✅ Available    |
| `exerciseType`              | `string`   | Type of exercise e.g. `STRENGTH`      | ✅ Available    |
| `imageUrl`                  | `string`   | Default image URL                     | ✅ Available    |
| `imageUrls`                 | `object`   | Multi-resolution images (360p–1080p)  | ✅ Available    |
| `videoUrl`                  | `string`   | Exercise demonstration video URL      | ✅ Available    |
| `overview`                  | `string`   | Detailed exercise description         | ✅ Available    |
| `instructions`              | `string[]` | Step-by-step guide                    | ✅ Available    |
| `exerciseTips`              | `string[]` | Pro tips for form and hypertrophy     | ✅ Available    |
| `variations`                | `string[]` | Exercise variations with descriptions | ✅ Available    |
| `keywords`                  | `string[]` | SEO and search keywords               | ✅ Available    |
| `relatedExerciseIds`        | `string[]` | IDs of related exercises              | ✅ Available    |
| `maleMuscleActivationUrl`   | `string`   | Male workout activation heatmap URL   | 🔜 Next Update |
| `femaleMuscleActivationUrl` | `string`   | Female workout activation heatmap URL | 🔜 Next Update |
| `difficultyLevel`           | `string`   | Difficulty level                      | 🔵 Coming Soon |
| `caloriesBurned`            | `number`   | Estimated calories per set            | 🔵 Coming Soon |
| `movementType`              | `string`   | Compound or isolation                 | 🔵 Coming Soon |

***

## Media

11,000+ exercises with 20,000+ images and 15,000+ videos all served from a fast CDN.

<Note>
  Free tier media is **watermarked**. Paid tier serves clean, watermark-free assets across all resolutions.
</Note>

### Images

Multi-resolution static images in four sizes.

| 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://cdn.exercisedb.dev/media/images/VM46gFp1mS.webp" alt="Bench Press 1080p" />
</Frame>

### Video

Each exercise includes an MP4 demonstration video for in-app playback.

<Tip>
  Use `videoUrl` on exercise detail screens. Fall back to `imageUrls` for list and card views to keep load times fast.
</Tip>

<Frame>
  <video src="https://cdn.exercisedb.dev/videos/Trn4QDW/41n2hxnFMotsXTj3__Barbell-Bench-Press_Chest2_.mp4" autoPlay loop muted playsInline style={{ width: "100%", borderRadius: "8px" }} />
</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>

***

## 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 ExerciseDB.
  </Card>
</CardGroup>
