EXERCISEB V1

Free vs Paid

Free
Paid (RapidAPI)

1,500 exercises with 180p GIFs. No authentication required, just call the hosted API directly.

curl -X GET "https://oss.exercisedb.dev/api/v1/exercises"

Free API Docs

Full endpoint reference for the free tier.

Enhanced data with multi-resolution media, difficulty levels, exercise types, and more.

Subscribe on RapidAPI

Head to EDB WITH IMAGES AND GIFS on RapidAPI and subscribe to a plan.

Copy your API key

After subscribing, go to the App tab in the playground and copy your X-RapidAPI-Key.

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`

Not sure how to subscribe? Follow the Quickstart guide for a step-by-step walkthrough.

Schema

Free
Paid (RapidAPI)

{
  "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

{
  "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

Media

Every exercise includes rich media served from a fast CDN.

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.

Free
Paid (RapidAPI)

A single GIF per exercise.

"gifUrl": "https://static.exercisedb.dev/media/EIeI8Vf.gif"

Images

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

GIFs

Each exercise includes an gifs demonstration.

Workout Activation

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

The primary and secondary muscle colors in the image are customizable.

Male
Female

Perfect For

Fitness Apps

Display targeted exercise data with rich visuals, muscle diagrams, and step-by-step instructions inside your app.

Workout Planners

Build structured programs using body part targeting, difficulty levels, and exercise types.

Personal Training

Equip trainers with detailed exercise breakdowns, equipment requirements, and related exercise suggestions.

Strength Training

Filter by equipment, difficulty, and muscle groups to build progressive overload programs.

Getting Started

Products

Guides

Troubleshooting

Free vs Paid

Free API Docs

Schema

Media

Images

GIFs

Workout Activation

Perfect For

Resources

API Reference

Website

​Free vs Paid

Free API Docs

​Schema

​Media

​Images

​GIFs

​Workout Activation

​Perfect For

​Resources

API Reference

Website

Free vs Paid

Schema

Media

Images

GIFs

Workout Activation

Perfect For

Resources