Die Fitness Content API
Eine API für Bereitstellung, Personalisierung und Einblicke in Ihr gesamtes Produkt.
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.
Von Content zu Intelligenz
Zuerst die Library. Dann Intelligence. Insights, die binden.
# Stock Exercise Library
GET /v1/orgs/{organizationId}/stock-exercises
?q=squat&availability=all-stock
&locale=en-US&limit=20
// Single-exercise clip + preview
{
"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/metadataPOST /v1/orgs/{orgId}/workouts/recommend
{
"endUserProfileDetails": {
"age": 28,
"fitnessLevels": ["beginner"]
},
"durationOptions": {
"minMinutes": 20,
"maxMinutes": 30
}
}
// Response (instant <100ms)
{
"workouts": [
{ "id": "...", "title": "Morning Flow", "matchScore": 0.95 },
{ "id": "...", "title": "Core Basics", "matchScore": 0.89 }
]
}POST /v1/orgs/{orgId}/workouts/{workoutId}/adapt
{
"endUserProfileId": "64e3bca9d1b7e600141a9712",
"endUserProfileDetails": {
"age": 28,
"gender": "female",
"fitnessLevels": ["advanced"],
"goalIds": ["63c92926f920a9005c4e619c"],
"trainingDaysPerWeek": 5,
"preferredEquipmentCategoryIds": ["67deb36a..."]
},
"exerciseSources": ["premium_stock", "team_exercises"],
"userGuidance": "Training for 10K run. Focus on
endurance. Limited time, prefer shorter workout."
}
// Response (personalized from original)
{
"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"
}
// Response (2-8 seconds)
{
"workout": {
"id": "generated-abc123",
"title": "20min Beginner HIIT",
"duration": 1200,
"segments": [...]
}
}GET /v1/orgs/{orgId}/endusers/{email}/insights/digest
?date=2026-01-10
// Daily AI Digest Response
{
"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
}Stock Exercise Library
Einzelne Clips browsen und streamen. Picker und Player bauen—ohne zu filmen.
- Free- und Premium-Stock nach Muskel, Equipment und Level suchen
- Lokalisierte Namen und Audio. HLS-Preview sofort abspielbar
KI-Empfehlung
Schlagen Sie das beste nächste Workout oder den besten Plan anhand von Zielen und Profilsignalen vor.
- Personalisierte "Als Nächstes"-Empfehlung in Sekunden
- Funktioniert mit Ihrem bestehenden Content
KI-Anpassung
Entwickeln Sie bestehende Workouts und Programme weiter, wenn Nutzer Fortschritte machen und sich der Kontext ändert.
- Fortschritt ohne manuelle Programmierung
- Hält Pläne länger relevant
KI generieren
Erstellen Sie spontane Workouts und mehrwöchige Programme, die auf den jeweiligen Benutzer zugeschnitten sind.
- Frische Sessions ohne Content-Laufband
- Basierend auf Einschränkungen: Zeit, Niveau, Ausrüstung
KI-Einblicke
Verwandeln Sie Sitzungen, Feedback und Ziele in tägliche Anleitung und 360-Grad-Einblicke.
- Tägliche Zusammenfassung + Säulendetailansichten
- Gebaut für Wiedereingliederungsschleifen
Von Exercise-Clips zu adaptiven Programmen—eine API.
Bereitstellungsoptionen
Von vorgefertigten Bibliotheksseiten bis hin zu vollständig benutzerdefinierten Player-Erlebnissen – stellen Sie Inhalte nach Ihren Wünschen bereit.
Embed & Go
Betten Sie einen Workout-Player oder Ihre gesamte anpassbare Inhaltsbibliothek ein.
Am besten für: Web-Apps, Portale, MVPs, Landing Pages, Corporate Wellness
In der Doku ansehen→Streamen Sie Videos
Trainingsvideo- oder Audiostreams in voller Länge, bereit zur Verteilung.
Am besten für: VOD-Kataloge, CMS-Publishing, YouTube-Workflows
In der Doku ansehen→Erstellen Sie Ihre UX
Playlists, Segmente und Stock-Exercise-Previews in Ihrer UI.
Am besten für: Apps, die einen Exercise-Picker brauchen—nicht nur volle Workouts
In der Doku ansehen→Generate - Play - Track
FAQ Hyperhuman-API
Einige Punkte, die Sie wissen sollten
Yes. The Stock Exercise Catalog 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
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.
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 book a demo at https://hyperhuman.cc/book-a-demo
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.com
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
Let's schedule a quick call to define your API needs and quota at https://hyperhuman.cc/book-a-demo
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.
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.
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.
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.
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.
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
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.com
Yes. The Hyperhuman Content API supports localized workout experiences across 16 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 (16): 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
Fallback behavior: if a locale isn’t available, the API falls back to English by default.
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 HLS streams 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 URLs and HLS master playlists for adaptive streaming.
Best for: mobile apps, connected hardware, advanced coaching UX, custom analytics.
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.
Yes. Hyperhuman provides OpenAPI in both JSON and YAML for codegen, SDK generation, and technical review.
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.
Yes. You can review docs, samples, OpenAPI files, and AI-ready resources before moving to a plan with production API access.
