https://github.com/cyberboyanmol/exercisedb-api
OpenSource ExerciseDB API is an exercises dataset api that allows users to access high-quality exercises data which consists 1300+ exercises. This API offers extensive information on each exercise, including target body parts, equipment needed, GIFs for visual guidance, and step-by-step instructions.
https://github.com/cyberboyanmol/exercisedb-api
backend-api backend-service exercise-database exercise-dataset exercisedb-api exercises fitness fitness-api fitness-app gym gymdataset hono honojs open-api vercel-serverless workout-tracker
Last synced: 18 days ago
JSON representation
OpenSource ExerciseDB API is an exercises dataset api that allows users to access high-quality exercises data which consists 1300+ exercises. This API offers extensive information on each exercise, including target body parts, equipment needed, GIFs for visual guidance, and step-by-step instructions.
- Host: GitHub
- URL: https://github.com/cyberboyanmol/exercisedb-api
- Owner: cyberboyanmol
- License: mit
- Created: 2024-03-03T05:07:32.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-10T20:41:58.000Z (19 days ago)
- Last Synced: 2025-04-11T22:52:31.598Z (18 days ago)
- Topics: backend-api, backend-service, exercise-database, exercise-dataset, exercisedb-api, exercises, fitness, fitness-api, fitness-app, gym, gymdataset, hono, honojs, open-api, vercel-serverless, workout-tracker
- Language: TypeScript
- Homepage: https://exercisedb-api.vercel.app/docs
- Size: 264 KB
- Stars: 74
- Watchers: 4
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# 🚀 New Exercise Dataset
What's Inside Our New Dataset
- 3,000+ exercises
- High-quality video demonstration.
- High-quality images
- Multilingual supports
- Many More..
Check out the [Pricing Plan](https://dub.sh/JTgJoq2) for detailed information.
For inquiries:
Telegram: [@cyberboyanmol](https://t.me/cyberboyanmol) (fast response)
## Note: Enterprise Solutions
If you're building an application and need complete control over the exercise data, we offer offline dataset access instead of API as SaaS. This includes:
- Full offline access to all 3,000+ exercises
- with montly/annually subscription
- Regular dataset updates
- Custom data formats
- Unlimited usage rights
- Direct technical support
- Integration assistance
Exercise sample
```sh
{
"exerciseId": "K6NnTv0",
"name": "Bench Press",
"imageUrl": "Barbell-Bench-Press_Chest.png",
"equipments": ["Barbell"],
"bodyParts": ["Chest"],
"exerciseType": "weight_reps",
"targetMuscles": ["Pectoralis Major Clavicular Head"],
"secondaryMuscles": [
"Deltoid Anterior",
"Pectoralis Major Clavicular Head",
"Triceps Brachii"
],
"videoUrl": "Barbell-Bench-Press_Chest_.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": [
"U0uPZBq",
"QD32SbB",
"pdm4AfV",
"SebLXCG",
"T3JogV7",
"hiWPEs1",
"Y5ppDdt",
"C8OV7Pv",
"r3tQt3U",
"dCSgT7N"
]
}
```
Sample Image
Sample Video
https://github.com/user-attachments/assets/6845a963-4d80-4dfd-b602-e49616a9483f
# ExerciseDB API
ExerciseDB API, accessible at [exercisedb-api.vercel.app](https://exercisedb-api.vercel.app/), is an exercises API that allows users to access high-quality exercises data which consists 1300+ exercises. This API offers extensive information on each exercise, including target body parts, equipment needed, GIFs for visual guidance, and step-by-step instructions.
## ⚠️ Important Notice
The unauthorized downloading, scraping, or bulk collection of data from this API is strictly prohibited. This API is intended for individual exercise lookups and legitimate application integration only. If you need access to the complete dataset or have specific requirements, please contact via Telegram at [@cyberboyanmol](https://t.me/cyberboyanmol). We're happy to discuss proper data usage and potential collaborations.
## 📚 Documentation
Check out the [API documentation](https://exercisedb-api.vercel.app/docs) for detailed information on how to use the API.
## 📰 Changelog
For a detailed list of changes, see the [CHANGELOG](CHANGELOG.md).
## 🔌 Running Locally
> [!NOTE]
> You need `Bun(1.1.25+)` or `Node.js(v20+)`
1. Clone the repository:
```sh
git clone https://github.com/cyberboyanmol/exercisedb-api
cd exercisedb-api
```
2. Install the required dependencies:
```sh
bun install
```
3. Launch the development server:
```sh
bun run dev
```
## ☁️ Deploying Your Own Instance
You can easily deploy your own instance of the API by clicking the button below:
[](https://vercel.com/new/clone?repository-url=https://github.com/cyberboyanmol/exercisedb-api)
## 📜 License
This project is distributed under the [MIT License](https://opensource.org/licenses/MIT). For more information, see the issue [ISSUE](https://github.com/cyberboyanmol/exercisedb-api/issues/3) included in this repository.