Upload tracking - PoseTracker

Upload tracking is the WebView path for offline files: the user picks a video or image, PoseTracker runs pose estimation in the browser, and you receive the same type events as live camera (counter, keypoints, …). SDK apps should use media sources (source="video" / source="image") instead of this URL.

https://app.posetracker.com/pose_tracker/upload_tracking?token=YOUR_API_KEY&source=video&exercise=push_up

Required and shared

Param	Role
`token`	Required API key
`source`	`video` (default) or `image`
`exercise`	Optional catalog id. Omit for keypoints-only (no rep counting)
`reference` / `reference_movement`	XOR with `exercise` — reference movement

Shared with live tracking: skeleton, keypoints, angles, recommendations, progression, minGrade, blazepose, isAndroid / android, userHeightCm, devicePitchDeg, postureBox. Same plan gating. userExercise is not read on this upload URL — use live tracking for Studio customs.

Upload-specific

Param	Default	Role
`videoSrc` / `imageSrc`	—	Preload a remote URL (CORS applies)
`showUpload`	`true`	Show the file picker UI
`export`	`false`	Request an export when the plan allows — listen for `export_ready`
`width` / `height`	—	Layout
`containerMinHeight`	`200`	Min height of the player
`containerMaxWidth` / `containerMaxHeight`	—	Caps
`objectFit`	`contain`	How the media is fitted
`uploadButtonPosition`	`center`	Picker placement
`uploadAreaPadding`	`12`	Padding around the picker

Messages that differ from live

Boot (initialization.message):

Video: loading video → Your video is processing, please stay on this page (N%) → Analysis completed (ready: true)
Image: loading image → initializing pose model → running (ready: true)

Extra types: export_ready ({ url }), keypoints_batch. Shapes: WebView messages. Stay on the page until ready: true — navigating away aborts analysis.

Example

<iframe
  src="https://app.posetracker.com/pose_tracker/upload_tracking?token=YOUR_API_KEY&source=video&exercise=push_up&skeleton=true"
  allow="camera *; microphone *"
  style="width:100%;max-width:480px;aspect-ratio:16/10;border:0"
  title="PoseTracker upload"
></iframe>

For LLMs: Upload WebView is /pose_tracker/upload_tracking?token=…&source=video|image. Same exercise ids as live tracking. SDK equivalent is media-sources, not this URL. https://docs.posetracker.com/webview/upload

Last modified on September 14, 2026