La API de contenido fitness
Una API para entrega, personalizacion e insights en todo tu producto.
Del contenido a la inteligencia
Empieza simple. Anade inteligencia. Termina con insights que impulsan la retencion.
# Browse & Play Workouts
GET /v1/workouts?categoryId=...&limit=20
GET /v1/workouts/{workoutId}
GET /v1/workouts/{workoutId}/playlist
// Workout detail response
{
"id": "615aa3f0dbe7140012c59e94",
"title": "Full Body HIIT",
"duration": 1200,
"difficulty": "intermediate",
"trainer": { "name": "Alex" },
"thumbnail": "https://..."
}
# Playlist: segments + HLS URLsPOST /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
}Publica contenido
Lista, filtra y publica entrenamientos y programas al instante en tu app.
- Tu biblioteca se convierte en la superficie de tu producto
- Los metadatos hacen el descubrimiento sencillo
IA Recomendar
Sugiere el mejor entrenamiento o plan siguiente segun objetivos y senales del perfil.
- Siguiente personalizado en segundos
- Funciona con tu contenido existente
IA Adaptar
Evoluciona entrenamientos y programas segun progresen los usuarios y cambie el contexto.
- Progresion sin programacion manual
- Mantiene los planes relevantes mas tiempo
IA Generar
Crea entrenamientos al vuelo y programas de varias semanas por usuario.
- Sesiones nuevas sin cinta de contenido
- Basado en restricciones: tiempo, nivel, equipo
IA Insights
Convierte sesiones, feedback y objetivos en guia diaria e insights 360.
- Resumen diario y vistas detalle por pilares
- Disenado para bucles de recompromiso
De la entrega a la mejora continua sin montar un equipo de ciencia de datos.
Opciones de entrega
Desde paginas de biblioteca listas hasta experiencias de reproductor totalmente personalizadas.
Embed e ir
Integra un reproductor de entrenamientos o toda tu biblioteca de contenido personalizable.
Ideal para: Apps web, portales, MVPs, landing pages, wellness corporativo
Ver en documentacion→Stream de videos
Videos de entrenamiento completos o streams de audio listos para distribucion.
Ideal para: Catalogos VOD, publicacion CMS, flujos YouTube
Ver en documentacion→Construye tu UX
Tu interfaz impulsada por listas, segmentos y enlaces de streaming seguros.
Ideal para: Apps moviles, hardware conectado, experiencias de coaching premium
Ver en documentacion→Generar - Reproducir - Seguir
FAQs Hyperhuman API
Algunas cosas que quizas quieras saber
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 programmes, 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 personalised experience for your clients.
Embedding Hyperhuman content is easy. Copy the provided iFrame code for the specific workout or programme page, and paste it into your website's HTML. Customise appearance by adjusting width, height, and other parameters within the iFrame code. For all publicly listed workouts and programmes, 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 customisable 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 personalised and interactive fitness experience.
Customisation: 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 13 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 (13): en-US, en-GB, en-AU, fr-FR, de-DE, es-ES, it-IT, pt-PT, he-IL, ro-RO, cs-CZ, fi-FI, nl-NL
Fallback behaviour: 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.
