Search key mapping

The GET /analysis/{analysis_id}/results response includes a search_key in each biomechanical item (under texts). Use this stable key for internal mapping (e.g. to your own labels, content, or translations) instead of relying on the human-readable position or title, which may be localized. The tables below list all possible search_key values per analysis type, with the associated position and a short explanation (from the English content assets).

Back view

Back view analysis returns analysis_content with knee_adduction, pelvic_drop, and pronation. Each side (left / right) has a texts.search_key.

Pelvic drop

search_key	position	explanation
`PelvicG`	Pelvis aligned	Right and left sides of pelvis are at the same height; ideal position.
`PelvicO`	Mild pelvic drop	Right and left sides of the pelvis are not aligned; strengthen gluteal muscles, hamstrings, adductors and hip flexors.
`PelvicB`	Excessive pelvic drop	Right and left sides of the pelvis are not aligned; same strengthening and awareness as PelvicO with higher severity.

Foot posture (pronation)

search_key	position	explanation
`Overpronation`	Overpronation	Abnormal pronation; foot moves inward; risk of injuries (e.g. shin splints, plantar fasciitis).
`Pronation`	Pronation	Foot moves inward; natural during contact; if excessive, risk of pain and need for proprioception work.
`Neutral`	Neutral	Foot straight, no pronation or supination; good position, can reinforce with proprioception.
`Supination`	Supination	Foot moves outward; natural when leaving the ground; excess can cause IT band, Achilles, foot issues.
`Oversupination`	Oversupination	Abnormal supination; risk of leg injuries, increased stiffness and impact.

Knee adduction

search_key	position	explanation
`ExcessiveAbduction`	Excessive abduction	Tibia away from midline, knee collapses inward; strengthen adductors, glutes, quadriceps; linked to knee valgus.
`MildAbduction`	Mild abduction	Same direction as excessive but milder; knee inward relative to hip–ankle line.
`KneeAligned`	Knee aligned	Tibial movement parallel to midline; ideal knee position and efficiency.
`MildAdduction`	Mild adduction	Tibia toward midline, knee shifts outward; strengthen hip, gluteal, abdominal muscles; can be linked to knee varus.
`ExcessiveAdduction`	Excessive adduction	Same as mild adduction with higher severity; linked to knee varus.

Side view

Side view analysis returns analysis_content with arm, back_cycle, foot, forward_cycle, head, and trunk.

Arms position

search_key	position	explanation
`ArmBD`	Over-extension	Elbow too open; loss of efficiency; maintain appropriate amplitude.
`ArmBT`	Excessive flexion	Elbow too closed; risk of muscle tension; loosen fists and relax shoulders.
`ArmG`	Ideal arm position	Good body stability and elbow angle; keep working on this position.
`ArmOD`	Moderate extension	Elbow too open; strain on back muscles; slightly bend the elbows.
`ArmOT`	Moderate flexion	Elbow too closed; increase arm swinging; relax shoulders and loosen fists.

Back knee angle at foot landing

search_key	position	explanation
`BackCycleB`	Low heel kick	Restricted leg cycle; need more energy to maintain speed; sprint exercises to improve amplitude.
`BackCycleG`	Ideal Position	Good spring effect of the leg; stride naturally wider; back knee angle is ideal.
`BackCycleO`	Okay heel kick	Limited propulsion; back knee too open; work on amplitude of hips and leg.

Front knee angle at foot landing

search_key	position	explanation
`ForwardCycleB`	Excessive flexion	Front knee too closed; limited running efficiency; improve leg lift (e.g. skipping).
`ForwardCycleG`	Ideal Position	Front knee angle is ideal; optimal running efficiency.
`ForwardCycleO`	Moderate flexion	Front knee too closed; work on amplitude (e.g. stair climbing).

Foot landing

Side view analysis_content.foot includes texts.search_key, plus foot_strike_pattern (rearfoot / midfoot / forefoot) and overstride-related text fields (overstride_title, overstride_explanation, foot_strike_explanation, phases). Each search_key encodes both the foot strike pattern and how far ahead of the body the foot lands. Use texts.search_key with POST /exercises for strengthening recommendations tied to that state.

Under the body (ideal)

search_key	position	overstride_title
`RearfootGZ`	Under center of mass	Heel strike under center of mass
`MidfootGZ`	Under center of mass	Midfoot strike under center of mass
`ForefootGZ`	Under center of mass	Forefoot strike under center of mass

Slight overstride

search_key	position	overstride_title
`RearfootG`	Slightly overstriding	Heel strike with slight overstride
`MidfootG`	Slightly overstriding	Midfoot strike with slight overstride
`ForefootG`	Slightly overstriding	Forefoot strike with slight overstride

Moderate overstride

search_key	position	overstride_title
`RearfootO`	Moderate overstride	Heel strike with moderate overstride
`MidfootO`	Moderate overstride	Midfoot strike with moderate overstride
`ForefootO`	Moderate overstride	Forefoot strike with moderate overstride

Excessive overstride

search_key	position	overstride_title
`RearfootB`	Excessive overstride	Heel strike with excessive overstride
`MidfootB`	Excessive overstride	Midfoot strike with excessive overstride
`ForefootB`	Excessive overstride	Forefoot strike with excessive overstride

The exercises catalog also includes FORE_FOOT, MID_FOOT, and REAR_FOOT. These are not returned as texts.search_key. They match stride-drill content by foot strike pattern alone. Map them from foot.foot_strike_pattern:

foot_strike_pattern	exercise lookup key
`forefoot`	`FORE_FOOT`
`midfoot`	`MID_FOOT`
`rearfoot`	`REAR_FOOT`

Head position

search_key	position	explanation
`HeadBD`	Gaze too focused toward the ground	Gaze too low; lift gaze to improve posture; risk of slouched posture.
`HeadBT`	Gaze too much skyward	Gaze too high; align with horizon; risk of cervical pain.
`HeadG`	Gaze in ideal position	Good body balance; maintain this position.
`HeadOD`	Gaze slightly toward the ground	Gaze too low; overuse of neck muscles; lift your gaze.
`HeadOT`	Gaze slightly skyward	Gaze too high; align head, neck, and back; risk of muscle tension.

Back position (trunk)

search_key	position	explanation
`TrunkBD`	The torso is too leaned forward.	Excessive tension in lumbar muscles; lift gaze to raise the torso.
`TrunkBT`	Not leaning forward enough	Torso too leaned back; overload on lumbar and gluteal muscles; brace with neutral pelvis.
`TrunkG`	The torso is in an ideal position.	Stride balance favored; stay braced.
`TrunkOD`	The torso is slightly leaned forward.	Slightly too far forward; straighten the torso.
`TrunkOT`	Not sufficiently forward-leaning	Torso too far back; engage abdominals to stabilize the back.

Using search_key in your integration

Prefer search_key for logic, routing, or mapping (e.g. to your own copy or assets).
Use position and title for display when needed.

Running styles

Running styles are returned in biomechanical_analysis.running_styles (side view only). They do not use search_key. Each object includes title, animal, animal_explanation, summary, explanation, and percentage. title is the unique identifier for a running style. It is always one of the English values below (even when animal, summary, and explanation are localized). Use title for logic, routing, or mapping to your own labels — the same role search_key plays for other biomechanical segments. An analysis returns 1–2 of these styles; when two are returned, their percentage values sum to approximately 100. All possible states:

title (UID)	animal	meaning
`Hop`	Kangaroo	High step frequency, relatively low stance phase
`Bounce`	Gazelle	Intermediate cadence, short stance, long flight
`Push`	Cheetah	Relatively low cadence, medium stance, more horizontal propulsion
`Stick`	Bear	Intermediate cadence, long stance, short flight
`Sit`	Ostrich	Intermediate cadence and stance/flight ratio; larger knee flexion at contact

Getting started

Guides

Back view

Pelvic drop

Foot posture (pronation)

Knee adduction

Side view

Arms position

Back knee angle at foot landing

Front knee angle at foot landing

Foot landing

Under the body (ideal)

Slight overstride

Moderate overstride

Excessive overstride

Head position

Back position (trunk)

Using search_key in your integration

Running styles

​Back view

​Pelvic drop

​Foot posture (pronation)

​Knee adduction

​Side view

​Arms position

​Back knee angle at foot landing

​Front knee angle at foot landing

​Foot landing

​Under the body (ideal)

​Slight overstride

​Moderate overstride

​Excessive overstride

​Related exercise lookup keys (foot strike only)

​Head position

​Back position (trunk)

​Using search_key in your integration

​Running styles

Back view

Pelvic drop

Foot posture (pronation)

Knee adduction

Side view

Arms position

Back knee angle at foot landing

Front knee angle at foot landing

Foot landing

Under the body (ideal)

Slight overstride

Moderate overstride

Excessive overstride

Related exercise lookup keys (foot strike only)

Head position

Back position (trunk)

Using search_key in your integration

Running styles