Query parameters

Full reference for all Upload Tracking query parameters.

All features are controlled via query parameters.

Base URL:

https://app.posetracker.com/pose_tracker/upload_tracking

Shared parameters with the Tracking endpoint

These parameters exist on both endpoints:

• token

• exercise (video only on Upload Tracking)

• difficulty (defaults can differ)

• keypoints

• blazepose

• skeleton (Upload Tracking uses true/false)

• width / height

If you need webcam real-time tracking, use:

• Tracking Endpoint params

Required

token (required)

Your PoseTracker API key.

If missing or invalid, the page shows:

• Invalid params. Please refer to our API documentation. Missing token=YOUR API_KEY

• A link to the tracking-endpoint documentation: Tracking Endpoint params

Example:

https://app.posetracker.com/pose_tracker/upload_tracking?token=YOUR_API_KEY

Source type and media URL

source (optional)

• video (default)

• image

Rules:

• If source=video and no videoSrc: show upload button (unless showUpload=false).

• If source=image and no imageSrc: show upload button (unless showUpload=false).

• If videoSrc or imageSrc is set: media loads automatically and analysis starts when ready.

videoSrc (optional, video only)

Direct URL of a video to analyze.

CORS is required when the media is on another domain. See CORS for remote URLs.

imageSrc (optional, image only)

Direct URL of an image to analyze.

Same CORS rules as videoSrc.

Feature flags (plan-gated)

Defaults:

• skeleton=true

• all other flags default to false

Plan gating:

• On the Free plan, keypoints, angles, blazepose, recommendations, progression, export are not allowed.

• See Plan restrictions.

keypoints (optional)

• true / false (default false)

• Sends keypoint coordinates to the host app.

• Developer/Custom/Company only.

angles (optional)

• true / false (default false)

• Sends computed angles to the host app.

• Developer/Custom/Company only.

skeleton (optional)

• true (default) / false

• Draws the skeleton overlay.

blazepose (optional)

• true / false (default false)

• Uses BlazePose instead of MoveNet.

• Developer/Custom/Company only.

export (optional, video only)

• true / false (default false)

• Enables exporting a new overlay video.

• Developer/Custom/Company only.

recommendations (optional, video only)

• true / false (default false)

• Enables real-time posture recommendations.

• Developer/Custom/Company only.

progression (optional, video only)

• true / false (default false)

• Enables progression per repetition.

• Developer/Custom/Company only.

Exercise tracking (video only)

exercise

Movement identifier. Required for:

• rep counter

• progression

• recommendations

Examples:

• squat

• pushup

• lunge

• plank

• balance_leg_left

• balance_leg_right

• balance_leg

• jumping_jack

• low_impact_jack

difficulty (optional)

• easy (default)

• normal

• pro

Affects validation thresholds for counting repetitions.

UI customization (optional)

showUpload

• true (default)

• false

uploadLabel

Button label. Example: Upload a video.

uploadButtonClass

CSS class name(s) applied to the upload button.

uploadButtonStyle

Inline style string (semicolon-separated). Only a safe subset is applied.

Common supported properties:

• background-color

• color

• padding

• border-radius

• font-size

uploadButtonPosition

• top

• bottom

• floating

containerClass

CSS class name(s) for the main container.

width / height

Display width/height in pixels.