Skip to main content
GET
/
analysis
/
{analysis_id}
/
results
Get analysis results
curl --request GET \
  --url 'https://partner-api.ochy-prod.com/analysis/{analysis_id}/results?apiKey='
{ "video_id": "cac1f6d4-deec-4ca0-801c-773f07a0eb5a", "status": "success", "percentage": 100, "thumbnail": "https://storage.googleapis.com/ochy-7871a.appspot.com/partners/.../output/cac1f6d4_thumbnail.jpg?<signed-url-parameters>", "output_video": "https://storage.googleapis.com/ochy-7871a.appspot.com/partners/.../output/encoded_analyzed_cac1f6d4.mp4?<signed-url-parameters>", "biomechanical_analysis": { "analysis_content": { "arm": { "range_good": [ 75, 85 ], "range_okay": [ 71, 89 ], "score_number": 0.5775, "measured_value": 80, "texts": { "exercice": [ "bi_stretch", "trapeze_cervical_stretch" ], "explanation": "An overly bent arm movement limits the range of motion of the upper body during running. This can affect balance and coordination. Improper arm movement can result in excessive tension in the upper body and lead to a feeling of fatigue during training.\nYour arms should not only swing forward but also backward, contributing to the efficiency of propulsion. Avoid clenching your fists and focus on keeping your shoulders relaxed.\nPractice the movement of your arms in front of a mirror with the intention of keeping your shoulders relaxed.", "position": "Moderate flexion", "recap": [ "Elbow too closed.", "Increase arm swinging.", "Relax shoulders and loosen fists.", "Upper body range restricted." ], "consequences": "An overly bent arm movement limits the range of motion of the upper body during running. This can affect balance and coordination. Improper arm movement can result in excessive tension in the upper body and lead to a feeling of fatigue during training.", "correction": "Your arms should not only swing forward but also backward, contributing to the efficiency of propulsion. Avoid clenching your fists and focus on keeping your shoulders relaxed.", "coach_tips": "Practice the movement of your arms in front of a mirror with the intention of keeping your shoulders relaxed.", "search_key": "ArmOT", "title": "Arms position" } }, "back_cycle": { "range_good": [ 0, 97 ], "range_okay": [ 97, 106 ], "score_number": 0.26310810810810814, "measured_value": 105, "texts": { "exercice": [ "ab_reinforcement", "ischio_reinforcement", "psoas_reinforcement" ], "explanation": "A restricted leg cycle imposes limitations on the range of motion in the hip, thereby affecting propulsion efficiency. This restriction can also have adverse effects on the knees and ankles, increasing the risk of injury. Adopting shorter strides significantly amplifies the energy expenditure required to maintain a given speed. This increased energy demand can result in early fatigue.\nBeing mindful of the range of motion in your leg and hip movements will allow you to have better technique. Incorporate sprints or accelerations to encourage more dynamic movements of the back leg. Including mobility and proprioception exercises would also be beneficial.\nVisualize your rear heel being tethered to a balloon, lifting it behind you with each stride.", "position": "Low heel kick", "recap": [ "Need for more energy to maintain speed.", "Restriction of movement amplitude.", "Sprint exercises to improve amplitude.", "The back knee is too open." ], "search_key": "BackCycleB", "title": "Back knee angle at foot landing" } }, "foot": { "foot_strike_pattern": "midfoot", "range_good": [ -10, 10 ], "range_okay": [ 10, 20 ], "score_number": 0.32093333333333335, "measured_value": 16.2, "texts": { "foot_strike_explanation": "Landing on the mid-foot at this angle significantly amplifies the impact on the musculo-tendinous structures of the lower limbs. The body struggles to manage the forces involved in such an exaggerated position, heightening the risk of injury.", "overstride_explanation": "When the foot lands more than 10┬░ in front of the center of gravity, it causes considerable strain on the joints, muscles, and tendons of the lower limb. This could lead to injuries if not addressed. It is critical to engage in specific strength training exercises and corrective running drills to return to a safer stride.", "overstride_title": "Mid-foot strike in front of the center of gravity", "phases": { "amortisation": "The ankle is forced into extreme dorsiflexion, compromising stability. The posterior chain muscles must work excessively to absorb the force, which may lead to fatigue and injury.", "impact": "The mid-foot lands far in front of the center of gravity, generating high-stress forces that may impact the knee and hip joints. There is a significant risk of overloading the stabilizing structures of the ankle.", "propulsion": "Propulsion efficiency is severely reduced due to the excessive stress on the lower limb, and there may be significant compensation through the upper body or other muscle groups." }, "position": "Flat foot landing", "title": "Foot landing" } }, "forward_cycle": { "range_good": [ 145, 180 ], "range_okay": [ 136, 145 ], "score_number": 0.864, "measured_value": 161, "texts": { "exercice": [ "ab_reinforcement", "ischio_reinforcement" ], "explanation": "If the leading leg is too bent during foot placement on the ground while running, it can lead to a loss of efficiency and potentially increase the risk of injuries.\nKeep practicing, concentrating on keeping your knee in this position.\nWhile running, imagine an invisible string attached to your knee, gently pulling upward. With each step, lift your knee slightly toward this invisible line, then let it come down naturally.", "position": "Ideal Position", "recap": [ "Continue to practice in this position.", "Optimal running efficiency.", "The front knee angle is ideal." ], "search_key": "ForwardCycleG", "title": "Front knee angle at foot landing" } }, "head": { "range_good": [ -14, -4 ], "range_okay": [ -18, 0 ], "score_number": 0.29700000000000004, "measured_value": 0, "texts": { "exercice": [ "trapeze_cervical_stretch" ], "explanation": "Excessive upward gaze can lead to muscle tension both in the neck and along the spine, causing fatigue and discomfort. Looking too high can also result in less effective breathing, leading to a decrease in oxygen supply to the muscles.\nKeep your head in a neutral position, aligning your gaze with the horizon. Avoid excessively lifting your chin; this will help you maintain a more balanced head position and improve your posture and awareness of the environment during the run.\nImagine that you are holding a balloon between your chin and your chest, and try to maintain this slight pressure during the run. Also, practice looking about 20 meters ahead of you.", "position": "Gaze too much skyward", "recap": [ "Align your gaze with the horizon.", "Gaze too high.", "Pain in the cervical area." ], "consequences": "Excessive upward gaze can lead to muscle tension both in the neck and along the spine, causing fatigue and discomfort. Looking too high can also result in less effective breathing, leading to a decrease in oxygen supply to the muscles.", "correction": "Keep your head in a neutral position, aligning your gaze with the horizon. Avoid excessively lifting your chin; this will help you maintain a more balanced head position and improve your posture and awareness of the environment during the run.", "coach_tips": "Imagine that you are holding a balloon between your chin and your chest, and try to maintain this slight pressure during the run. Also, practice looking about 20 meters ahead of you.", "search_key": "HeadBT", "title": "Head position" } }, "trunk": { "range_good": [ 6, 12 ], "range_okay": [ 2, 16 ], "score_number": 0.3159574468085106, "measured_value": -5, "texts": { "exercice": [ "ab_reinforcement" ], "explanation": "A torso not leaning forward enough can accentuate the load on the lower back muscles, leading to early fatigue and increasing the risk of lower back pain. To compensate for the backward-leaning posture, the gluteal muscles may be excessively engaged, leading to muscle tension in that region. A backward-leaning torso can shift the center of gravity backward, overloading the leg muscles. This will reduce the ability to propel the body forward, resulting in a loss of efficiency and an increase in energy expenditure.\nEngaging the abdominal muscles will help support the lumbar region and maintain a posture with an intention to move forward. Also, ensure that your pelvis is neutral, neither tilted forward nor backward, to avoid overuse of the gluteal muscles.\nDuring the run, focus on vertical alignment by imagining an invisible cord pulling upward from the top of your head.", "position": "Not leaning forward enough", "recap": [ "Overload on the lumbar and gluteal muscles.", "Properly brace by keeping a neutral pelvis.", "Risks of lower back pain.", "Torso too leaned back." ], "search_key": "TrunkBT", "title": "Back position" } } }, "running_styles": [ { "animal": "Bear", "animal_explanation": "Bears, especially when not sprinting, have a gait that involves longer contact times with the ground. This \"stick\" style offers stability, especially beneficial given their body structure and weight.", "title": "Stick", "summary": "Running style characterized by an intermediate step frequency, a long stance phase and a short flight phase.", "explanation": "This running style can be beneficial at low running speeds, or in conditions in which high vertical peak forces are unbeneficial.", "percentage": 100 } ], "total_score": 0.413 } }

Authorizations

apiKey
string
query
required

Your API key, passed as a query parameter on every request.

Path Parameters

analysis_id
string
required

Analysis ID returned by the start endpoint.

Response

Analysis completed or pending.

video_id
string
Example:

"3dde3402-94d7-462e-a784-9306207108dd"

status
string
Example:

"success"

percentage
integer
Example:

100

thumbnail
string

Signed URL to the analysis thumbnail image (expires after 1 hour).

Example:

"https://storage.googleapis.com/ochy-7871a.appspot.com/partners/.../output/<analysis_id>_thumbnail.jpg?<signed-url-parameters>"

output_video
string

Signed URL to the annotated output video (expires after 1 hour).

Example:

"https://storage.googleapis.com/ochy-7871a.appspot.com/partners/.../output/encoded_analyzed_<analysis_id>.mp4?<signed-url-parameters>"

biomechanical_analysis
object

Full biomechanical analysis results. Shape varies by analysis type.

Side view includes: analysis_content (arm, back_cycle, foot, forward_cycle, head, trunk -- each with score_number, measured_value, range_good, range_okay, and texts with position, search_key, title, recap, exercice, plus consequences, correction, and coach_tips inlined next to recap), running_styles (array of detected styles; objects may include animal, animal_explanation, title, summary, explanation, percentage; asset URLs are omitted), and total_score.

Back view includes: analysis_content (knee_adduction, pelvic_drop, pronation -- each with left/right containing range_bad, range_good, range_okay, score_number, measured_value, and texts with explanation, position, recap, search_key, side, title where applicable, plus consequences and correction inlined next to recap), and total_score. For back view, the explanation field is currently not available for pelvic_drop.

measured_value, range_good, range_okay, and range_bad are always expressed in degrees. Range boundaries may overlap because scoring uses implicit inclusion/exclusion rules. For example, with range_good: [0, 102] and range_okay: [102, 111], values up to 102 are considered good, and values strictly greater than 102 are considered okay.

For both views, consequences and correction come from segmented_explanation flattened into texts; the nested segmented_explanation key is never returned. Those two fields may be an empty string, a string, or an array of strings depending on the metric and result.

For side view, total_score is not a simple average of the individual score_number values. It is based on a weighted calculation.