SSarah K.Active
TTom R.Invited
Keep your login.
Invite, sync and remove members via API. SSO on Enterprise.
See the end-user APIThe Fitness Content API
A fitness API for workouts, exercises and programs. One API for delivery, personalisation, and insights across your entire product.
Workout API • Stock Exercise Library • AI Recommend • AI Generate
Developer resources
Everything you need to evaluate, build, and integrate.
Built so your engineers can self-serve from read to ship.
Docs and live explorer
Read the full API reference in a cleaner modern format, or open the classic explorer to test endpoints live.
Custom player guideBest starting point for most teams: Open API docs.
OpenAPI specs
Use the source of truth for codegen, SDK generation, tooling, and technical review.
JSON is best for tooling. YAML is easier to read and diff.
For AI agents and coding assistants
Use machine-readable artifacts built for LLMs, coding agents, and chat-native implementation workflows.
Compact LLM indexUse these instead of scraping page HTML when integrating with AI tools.
From Content to Intelligence
Library first. Intelligence next. Insights that retain.
# Stock Exercise Library
GET /v1/orgs/{organizationId}/stock-exercises
?q=squat&availability=all-stock
&locale=en-US&limit=20
// Single-exercise clip + preview ({ data, links } item)
{
"id": "...",
"name": "Goblet Squat",
"kind": "single-exercise",
"muscleGroups": [{ "name": "Legs" }],
"equipment": [{ "name": "Dumbbell" }],
"preview": {
"url": "https://.../master.m3u8",
"poster": "https://.../poster.jpg"
},
"skillLevel": "beginner",
"audioInstructions": [...]
}
# Related: GET /v1/workouts/exercises/metadata
# Note: workspace uploads → GET /v1/orgs/{orgId}/video-assets (no stock)POST /v1/orgs/{orgId}/workouts/recommend
// Body whitelist: endUserProfileDetails + optional locale only
{
"endUserProfileDetails": {
"age": 28,
"fitnessLevels": ["beginner"],
"gender": "female"
}
}
// Response (HTTP 200) — ranked library workouts; text reason, not a score
{
"workouts": [
{
"id": "...",
"name": "Morning Flow",
"recommendation": "Matches beginner level and mobility focus."
},
{
"id": "...",
"name": "Core Basics",
"recommendation": "Short session aligned with your profile."
}
],
"reasoning": "..."
}POST /v1/orgs/{orgId}/workouts/{workoutId}/adapt
{
"endUserProfileId": "64e3bca9d1b7e600141a9712",
"endUserProfileDetails": {
"age": 28,
"gender": "female",
"fitnessLevels": ["advanced"],
"goalIds": ["63c92926f920a9005c4e619c"],
"trainingDaysPerWeek": 5,
"preferredEquipmentCategoryIds": ["67deb36a6a5e49797c122f56"]
},
"exerciseSources": ["premium_stock", "team_exercises"],
"userGuidance": "Training for 10K run. Focus on endurance. Limited time, prefer shorter workout."
}
// Response (HTTP 200) — ephemeral JSON (no persisted workout id; no /playlist)
{
"name": "Adapted: Endurance Builder",
"totalDurationSeconds": 1200,
"difficulty": "advanced",
"adaptationReasoning": "Shortened to 20min per user request. Swapped HIIT for steady-state cardio to support 10K goal.",
"instances": [...]
}POST /v1/orgs/{orgId}/workouts/generate
{
"endUserProfileDetails": {
"age": 28,
"fitnessLevels": ["beginner"]
},
"exerciseSources": ["premium_stock"],
"durationOptions": {
"minMinutes": 20,
"maxMinutes": 20
},
"categoryId": "615aa3f0dbe7140012c59e94",
"methodologyProfileId": "64e3bca9d1b7e600141a9713"
}
// Response (HTTP 200) — top-level ephemeral JSON (no workout.id)
// Play via JSON-receiver embed or custom player from instances[]
// Do NOT call GET /playlist or /music (those need a persisted id)
{
"name": "20min Beginner HIIT",
"totalDurationSeconds": 1200,
"difficulty": "beginner",
"instances": [
{ "kind": "single-exercise", "durationSeconds": 30, "exercise": { "id": "...", "name": "..." } },
{ "kind": "rest", "durationSeconds": 15 }
]
}GET /v1/orgs/{orgId}/endusers/{endUserId}/insights/digest
?date=2026-01-10
// {endUserId} may be hex id, email, or external id (prefer hex in production)
{
"pillars": [
{
"type": "health_pulse",
"status": "green",
"headline": "82 (+5 vs 7-day). Driver: Sleep.",
"action": "Maintain your sleep routine",
"readinessBand": "push"
},
{
"type": "training",
"status": "green",
"headline": "4 workouts. Form: 78%. On pace.",
"action": "Next: Full Body Strength"
}
],
"todaysFocus": "Complete: Full Body Strength",
"dataCompleteness": 0.75
}Step 1
Stock Exercise Library
Browse and stream individual clips. Build pickers and players—without filming.
- Search free and premium stock by muscle, gear, and level
- Localised names and audio. Preview ready to play
Step 2
AI Recommend
Suggest the best next workout or plan using goals and profile signals.
- Personalised "Next Up" in seconds
- Works with your existing content
Step 3
AI Adapt
Evolve existing workouts and programs as users progress and context changes.
- Progression without manual programming
- Keeps plans relevant, longer
Step 4
AI Generate
Create on-the-fly workouts and multi-week programmes tailored per user. Optional methodologyProfileId applies Programming DNA; omit means none.
- Ephemeral workout JSON — play via JSON-receiver (no /playlist id)
- Built around constraints: time, level, equipment. Optional methodologyProfileId; omit means none.
Step 5
AI Insights
Turn sessions, feedback, and goals into daily guidance and 360 insights.
- Daily digest + pillar detail views
- Built for re-engagement loops
From exercise clips to adaptive programs—one API.
For product leaders
Your app. Our training brain.
Programmes, picks and progress through one API. Live in your app, under your login.
"recommendation":"Legs yesterday. Upper body today."
Every pick explains why.
A plain-language reason with every recommendation.
See Recommend
Miss a day. Keep the plan.
Programmes adapt. Progress stays.
See Adapt
Open it from any message.
Deep link a workout or programme from push, email or CRM.
See deep linksNo SDK to maintain.
One public API, the same one our iOS and Android apps run on. Generate typed clients from OpenAPI.
Bring your own health data.
Steps, sleep, heart rate and more feed every insight.
Webhooks
Know the moment they finish.
Workouts, programmes and daily signals, pushed to your server as they happen. Build streaks, leaderboards and nudges your way.
- Workout completed
workout_session.completedLeaderboards, streaks, CRM sync - Programme started
plan.startedOnboarding, challenge sign-up - Programme progress
plan.progress_updatedProgress bars, catch-up nudges - Programme completed
plan.completedRewards, next-programme offers - Daily insights ready
insights.digest_readyStreak-at-risk nudges
POSTDelivered · 200
{
"type": "workout_session.completed",
"occurredAt": "2026-10-29T18:42:11.000Z",
"endUser": { "externalUserId": "crm-12345" },
"data": {
"workoutName": "Upper Body Power",
"completionPercent": 100,
"surface": "embed"
}
}- Signed with Standard Webhooks
- Retries for 3 days
- 30-day catch-up feed
- IDs only. No health data.
On every plan with API access.
Delivery Options
From ready-made library pages to fully custom player experiences — deliver content your way.
Embed & Go
Embed a workout player or your entire customisable content library.
Best for: Web apps, portals, MVPs, landing pages, corporate wellness
View in docs→Stream Videos
Full-length workout video or audio streams, ready for distribution.
Best for: VOD catalogues, CMS publishing, YouTube workflows
View in docs→Build Your UX
Playlists, segments, and stock exercise previews in your UI.
Best for: Apps that need an exercise picker—not only full workouts
View in docs→Generate - Play - Track
Library without production
Ship exercise video from day one. No shoot. No media stack.
Personalised Experiences
Deliver workouts tailored to goals, fitness level, and equipment—at scale.
Instant, Multi-Channel Delivery
Embed interactive players, stream full workouts, or export videos across channels.
Lower Costs, Less Ops
Replace heavy content pipelines with one API for delivery, tracking, and learning.
Faster Time-to-Market
Clean OpenAPI flows and proven patterns. Many teams go live in days.
Keep members coming back
Recommend, adapt, and daily insights that drive adherence—not one-and-done sessions.
Your integration copilot
Explore the API in chat. Build faster with agents.
Exercise APIs compared
Most exercise APIs return GIFs, short clips, or text data. Hyperhuman delivers HD video plus generation, adaptation, and delivery.
| Media | AI workout generation | White-label delivery | Languages | AI-agent tooling | |
|---|---|---|---|---|---|
| Hyperhuman | HD multi-angle videos + licensed classes | Generate, recommend, and adapt full workouts | Branded apps, embeds, and players | 18 | MCP server, llms.txt, AGENTS.md |
| ExerciseDB | Animated GIFs | — | — | English | llms.txt |
| YMove | HD exercise video clips | — | — | — | MCP server, llms.txt |
| MuscleWiki | Exercise demonstration videos | — | — | 14 | MCP server, llms.txt |
| API Ninjas | Text-only exercise data | — | — | English | — |
Based on each vendor's public documentation. Last reviewed: August 2026. "—" means not offered or not publicly documented.
FAQs Hyperhuman API
Some of the things you might want to know
Can I browse individual stock exercise videos via the API?
Yes. The Stock Exercise Library returns searchable single-exercise clips with preview streams, posters, and rich metadata—ready for pickers, players, and swap flows.
Endpoint: GET /v1/orgs/{organizationId}/stock-exercises
Why is /video-assets empty when I want Hyperhuman stock exercises?
GET /v1/orgs/{orgId}/video-assets returns only videos in your workspace library (uploads or licensed content you added). Stock clips are not stored there by default.
Use GET /v1/orgs/{orgId}/stock-exercises to browse the global Stock Exercise Library.
Which plans include the Stock Exercise Library API?
Ultra (annual) or Custom / Enterprise plans with catalog access. It is not included on Platform trials or Ultra monthly.
See pricing at https://hyperhuman.cc/pricing or chat with us.
Is there any documentation available for the API?
Yes, comprehensive API documentation is available to help you get started with integrating the API into your systems. We aim to make the integration of our API a plug & play process, connect and get started in as little as a few lines of code. You can focus on your core business and let us cover content delivery.
Link to the Hyperhuman API Specification: https://hyperhuman.cc/api-docs
For further inquiries or assistance, please contact our dedicated support team at support@hyperhuman.cc
How do I access the Hyperhuman API?
Access to the Hyperhuman content API is provided via a unique API key available when upgrading to any of our paid plans. More details about the limits included for each plan can be found at https://hyperhuman.cc/pricing
Chat with us anytime to define your API needs and quota.
What type of fitness content can I deliver to my clients?
You can create and publish any type of on-demand video workouts and programs, follow-along workouts, online physical therapy, fitness tutorials, yoga or pilates videos to sports mastery videos and fitness classes. All workouts come with a wide range of data and multimedia assets so you can deliver the most engaging and personalized experience for your clients.
How do I embed Hyperhuman content on my website?
Embedding Hyperhuman content is easy. Copy the provided iFrame code for the specific workout or program page, and paste it into your website's HTML. Customize appearance by adjusting width, height, and other parameters within the iFrame code. For all publicly listed workouts and programs, use auto-generated content pages with dedicated iFrame codes for seamless integration.
What are the two output formats for workouts provided by the Fitness Content API?
We provide two distinct workout output formats tailored for seamless integration into your mobile apps or digital products:
Interactive Version: This format offers modular data systems, including individual exercise clips, audio instructions, and metadata. Ideal for businesses seeking a customizable fitness experience within their existing platforms.
Full-Length Follow-Along Videos: Fully produced videos ready for immediate use. Perfect for digital fitness companies aiming to deliver a guided workout experience without additional post-production efforts.
How does the Interactive Version enhance the offerings for businesses and digital fitness companies?
Integration: Easily integrate modular components into your existing mobile apps or digital products, providing users with a personalized and interactive fitness experience.
Customization: Tailor workouts to specific preferences, adapt to different fitness levels, or target specific muscle groups, catering to a diverse audience.
Versatility: The modular data system allows for versatile use, empowering businesses to adapt and evolve their fitness content seamlessly.
Are there additional costs associated with choosing a specific format?
No, the choice between the interactive version and follow-along videos does not impact the cost. Enjoy the flexibility to select the format that aligns with your business goals without any additional charges.
Are there any limitations on the number of API requests I can make?
Yes, there are limitations on the number of API requests you can make based on your active subscription plan. More details about the limits included for each plan can be found at https://hyperhuman.cc/pricing
Is there any support available for the API?
Yes, our dedicated support team is ready to provide assistance and answer any queries to ensure a seamless integration.
For further inquiries or assistance, please contact our dedicated support team at support@hyperhuman.cc
Do you support localization / multiple locales?
Yes. The Hyperhuman Content API supports localized workout experiences across 18 locales, so your app can deliver the same workout in the user’s language—video + metadata + audio guidance.
What gets localized: workout titles/descriptions, exercise names, equipment, muscle groups, and audio instructions (where enabled).
How to request a locale: pass locale (e.g., fr-FR) when fetching workout details or playlists:
GET /v1/workouts/{workoutId}?locale=fr-FR
GET /v1/workouts/{workoutId}/playlist?locale=fr-FR
Supported locales (18): en-US, en-GB, en-AU, fr-FR, de-DE, es-ES, it-IT, pt-PT, he-IL, ro-RO, cs-CZ, fi-FI, lt-LT, nl-NL, pl-PL, ar-XA, nb-NO, sv-SE
Fallback behavior: if a locale isn’t available, the API falls back to English by default.
Can we embed a player vs build our own?
Yes. Hyperhuman supports both: a plug-and-play embedded workout player (fastest) and a custom player implementation (maximum control) using the same Workout API + playlist endpoints.
Option A — Embedded player (fastest to ship)
Use an iframe workout player to stream a pre-built workout:
https://team.hyperhuman.cc/embed/workout/{workoutId}?organizationId={orgId}&apiKey={apiKey}&locale=en-US
Or embed a player that receives AI-generated workout JSON (great for “generate → instantly play” flows).
Best for: web apps, portals, landing pages, corporate wellness intranets, MVPs.
Option B — Custom player (full control in your UI)
Fetch workout details + a structured playlist with streaming media URLs and render your own experience:
GET /v1/workouts/{workoutId}
GET /v1/workouts/{workoutId}/playlist?locale={locale}
You’ll receive segment timing + media assets (intro/exercise/break/outro), plus pre-signed media URLs (progressive MP4) ready to play.
Best for: mobile apps, connected hardware, advanced coaching UX, custom analytics.
Can the API apply our programming methodology?
Yes. Workout and plan generate accept an optional team methodologyProfileId so Programming DNA is applied explicitly. Unknown, personal, or inactive ids return an error. If you omit the field, none is applied.
Is there a free trial?
There is a free plan. Platform includes a 7-day trial. There is no free API tier.
Does Hyperhuman have an MCP server?
Yes. A standard MCP server is at https://mcp.hyperhuman.cc/mcp. ChatGPT uses the dedicated plugin: Hyperhuman plugin in ChatGPT.
Is there an SDK?
Hyperhuman has no SDK. Typed clients can be generated from the OpenAPI spec. AI Motion uses the Asensei SDK inside your app, with motion bundles from the exercise library for supported exercises.
How does Hyperhuman compare with ExerciseDB?
ExerciseDB returns exercise data. Hyperhuman adds HD video, workout generation, adaptation, and delivery.
Does the API have webhooks?
Yes. Signed events for completed workouts, programme progress and daily insights reach your HTTPS endpoint as they happen. Failed deliveries retry for 3 days, and a 30-day feed catches you up. Payloads carry IDs only: no names, emails or health values. Included on plans with API access. Read the webhook docs.
Can we run challenges and leaderboards?
Yes, in your own app. Subscribe to workout and programme webhooks and count completions your way. Hyperhuman has no built-in leaderboard. Webhooks send workout and programme events, not steps or wearable data.
Which API docs should I use first?
Start with the modern API docs for the cleanest reference experience. Use the classic explorer when you want to test endpoints live in the browser.
Do you provide OpenAPI files?
Yes. Hyperhuman provides OpenAPI in both JSON and YAML for codegen, SDK generation, and technical review.
Do you provide docs for LLMs and coding agents?
Yes. Use the compact LLM index for quick context, the full LLM bundle for deeper endpoint coverage, and the agent guide for implementation conventions and common integration rules.
Can I explore the API before I have production access?
Yes. You can review docs, samples, OpenAPI files, and AI-ready resources before moving to a plan with production API access.
Explore more
Exercise library
Browse by muscle, equipment, and level.
Exercise video API
HD exercise videos over REST.
API documentation
Interactive OpenAPI reference for developers.
White-label Club app
Launch a branded member app on iOS and Android.
Fitness content licensing
License premium clips, classes, and branded collections.
Pricing
Content, Platform, Ultra, and Enterprise.
System status
Live uptime and incidents for the API and apps.
