L'API Contenu Fitness
Une seule API pour la diffusion, la personnalisation et les insights sur tout votre produit.
Du contenu a l'intelligence
Commencez simple. Ajoutez l'intelligence. Terminez avec des insights qui favorisent la fidelisation.
# 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
}Publier le contenu
Listez, filtrez et publiez instantanement des entrainements et programmes dans votre app.
- Votre bibliotheque devient la surface produit
- Les metadonnees facilitent la decouverte
Recommandation IA
Suggerez le meilleur entrainement ou plan suivant selon les objectifs et signaux du profil.
- Prochain a l'ecran personnalise en secondes
- Fonctionne avec votre contenu existant
Adaptation IA
Faites evoluer les entrainements et programmes existants selon la progression et le contexte.
- Progression sans programmation manuelle
- Maintient les plans pertinents plus longtemps
Generation IA
Creez des entrainements a la demande et programmes plurisémanaires adaptes a chaque utilisateur.
- Seances fraiches sans tapis roulant de contenu
- Construit autour des contraintes : temps, niveau, equipement
Insights IA
Transformez seances, retours et objectifs en guidance quotidienne et insights 360.
- Digest quotidien + vues detail piliers
- Concu pour les boucles de re-engagement
De la diffusion a l'amelioration continue — sans construire une equipe data science.
Options de diffusion
Des pages bibliotheque pretes a l'emploi aux experiences lecteur entierement personnalisees — diffusez le contenu a votre facon.
Integrer et partir
Integrez un lecteur d'entrainement ou toute votre bibliotheque de contenu personnalisable.
Ideal pour : Apps web, portails, MVP, landing pages, bien-etre entreprise
Voir dans la doc→Streaming video
Videos entrainement ou flux audio complets, prets pour la distribution.
Ideal pour : Catalogues VOD, publication CMS, workflows YouTube
Voir dans la doc→Construisez votre UX
Votre interface alimentee par playlists, segments et liens de streaming securises.
Ideal pour : Apps mobiles, materiel connecte, experiences coaching premium
Voir dans la doc→Generer - Lire - Suivre
FAQ API Hyperhuman
Quelques points que vous pourriez vouloir connaitre
Oui, une documentation API complete est disponible pour vous aider a integrer l'API dans vos systemes. Notre objectif est de faire de l'integration de notre API un processus plug & play : connectez-vous et demarrez en quelques lignes de code. Concentrez-vous sur votre activite principale et laissez-nous gerer la diffusion du contenu.
Lien vers la specification de l'API Hyperhuman : https://hyperhuman.cc/api-docs
Pour toute question ou assistance, contactez notre equipe support a support@hyperhuman.com
L'acces a l'API contenu Hyperhuman se fait via une cle API unique disponible lors du passage a l'un de nos plans payants. Plus de details sur les limites incluses pour chaque plan sur https://hyperhuman.cc/pricing
Planifions un appel rapide pour definir vos besoins API et quotas sur https://hyperhuman.cc/book-a-demo
Vous pouvez creer et publier tout type d'entrainements video a la demande et programmes, entrainements a suivre, physiotherapie en ligne, tutoriels fitness, videos yoga ou pilates jusqu'aux videos de maitrise sportive et cours de fitness. Tous les entrainements incluent une large gamme de donnees et d'actifs multimedia pour offrir l'experience la plus engageante et personnalisee a vos clients.
L'integration du contenu Hyperhuman est simple. Copiez le code iFrame fourni pour la page d'entrainement ou de programme specifique, et collez-le dans le HTML de votre site. Personnalisez l'apparence en ajustant la largeur, la hauteur et d'autres parametres dans le code iFrame. Pour tous les entrainements et programmes publics, utilisez les pages de contenu auto-generees avec des codes iFrame dedies pour une integration fluide.
Nous fournissons deux formats de sortie d'entrainement distincts adaptes a une integration fluide dans vos applications mobiles ou produits digitaux :
Version interactive : Ce format offre des systemes de donnees modulaires, incluant des clips d'exercices individuels, des instructions audio et des metadonnees. Ideal pour les entreprises recherchant une experience fitness personnalisable dans leurs plateformes existantes.
Videos completes a suivre : Videos entierement produites pretes a l'emploi immediat. Parfait pour les entreprises fitness digital visant une experience entrainement guidee sans efforts de post-production supplementaires.
Integration : Integrez facilement des composants modulaires dans vos applications mobiles ou produits digitaux existants, offrant aux utilisateurs une experience fitness personnalisee et interactive.
Personnalisation : Adaptez les entrainements aux preferences specifiques, aux differents niveaux de fitness ou aux groupes musculaires cibles, pour une audience diversifiee.
Polyvalence : Le systeme de donnees modulaire permet une utilisation versatile, permettant aux entreprises d'adapter et faire evoluer leur contenu fitness de maniere fluide.
Non, le choix entre la version interactive et les videos a suivre n'impacte pas le cout. Profitez de la flexibilite pour selectionner le format aligne avec vos objectifs commerciaux sans frais supplementaires.
Oui, des limites s'appliquent au nombre de requetes API selon votre plan d'abonnement actif. Plus de details sur les limites incluses pour chaque plan sur https://hyperhuman.cc/pricing
Oui, notre equipe support dediee est prete a fournir une assistance et repondre a toutes vos questions pour garantir une integration fluide.
Pour toute question ou assistance, contactez notre equipe support a support@hyperhuman.com
Oui. L'API Content Hyperhuman prend en charge des experiences d'entrainement localisees dans 13 langues, votre app peut donc proposer le meme entrainement dans la langue de l'utilisateur — video + metadonnees + instructions audio.
Ce qui est localise : titres/descriptions des entrainements, noms des exercices, equipement, groupes musculaires et instructions audio (si active).
Comment demander une langue : passez le parametre locale (ex. fr-FR) lors de la recuperation des details d'entrainement ou des playlists :
GET /v1/workouts/{workoutId}?locale=fr-FR
GET /v1/workouts/{workoutId}/playlist?locale=fr-FR
Langues prises en charge (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
Comportement par defaut : si une langue n'est pas disponible, l'API revient a l'anglais par defaut.
Oui. Hyperhuman prend en charge les deux : un lecteur d'entrainement integre plug-and-play (le plus rapide) et une implementation de lecteur personnalise (controle maximal) utilisant la meme API Workout et les endpoints playlist.
Option A — Lecteur integre (le plus rapide a deployer)
Utilisez un lecteur d'entrainement iframe pour diffuser un entrainement pre-construit :
https://team.hyperhuman.cc/embed/workout/{workoutId}?organizationId={orgId}&apiKey={apiKey}&locale=en-US
Ou integrez un lecteur qui recoit du JSON d'entrainement genere par l'IA (ideal pour les flux "generer -> lire instantanement").
Ideal pour : applications web, portails, landing pages, intranets bien-etre entreprise, MVP.
Option B — Lecteur personnalise (controle total dans votre interface)
Recuperez les details d'entrainement + une playlist structuree avec flux HLS et affichez votre propre 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.
Ideal pour : applications mobiles, materiel connecte, UX coaching avancee, analytics personnalisees.
