Skip to content

Changelog

All notable changes to API v1 are documented here.

[1.7.0] - 2026-07

Added

  • Tracking download: row status and confidence columns (analysis version 0.5.36+)
  • New columns: status, overlap_partner_id, position_conf, identity_conf
  • Full-squad coverage: off-camera players now included as 5 Hz projected rows (pitch coordinates only, no pixel coordinates)
  • For the previous on-camera-only behavior, filter with df[df['status'].str.startswith('detected')]
  • See Download Tracking

Changed

  • Cleaner event spans: duplicate event blocks at segment boundaries removed (~20 fewer duplicates per game)
  • Corrected match timeline durations (~2s per segment)
  • Improved position quality through better camera calibration; ~3% of frames that could not be calibrated are now omitted instead of returned with degraded accuracy

Unchanged

  • Summary player statistics remain computed from detection-backed rows only — values stay comparable with earlier versions
  • Events schema, filter types, and all units are unchanged

[1.6.0] - 2026-03

Added

  • Ball action filter (ball_action)
  • Filter by passes, drives (dribbles), and shots
  • Filter by specific players or teams
  • Requires analysis version 0.5.10 or later
  • Response includes player_id, team_id, and team_name fields

[1.5.0] - 2026-02

Added

  • Video management endpoints documentation
  • GET /videos - List all videos
  • POST /videos - Upload new video
  • GET /videos/{id} - Get video details
  • PUT /videos/{id} - Update video metadata
  • Create analysis endpoint documentation
  • POST /videos/{id}/analysis - Create analysis for video
  • Complete workflow examples for video upload and analysis creation

[1.4.0] - 2026-02

Added

  • Player names in the Summary endpoint
  • Each entry in the Summary players array includes a name display label (e.g., "Team A #10") alongside player_id, team_id and stats.
  • For a plain player-id → display-name map, use the Meta-data endpoint (GET /analyses/{id}/meta-data), which returns an identities object.

[1.3.0] - 2026-02

Added

  • Summary endpoint (GET /analyses/{id}/summary)
  • Comprehensive game overview
  • Per-minute possession breakdown
  • Player distance and speed statistics
  • Analysable duration metrics

Changed

  • Player stats now include speed buckets (walking, jogging, running, sprinting)

[1.2.0] - 2026-01

Added

  • Tracking download (GET /analyses/{id}/tracking/download)
  • Download raw tracking data as Parquet or JSON
  • Includes all player positions at 25 FPS

[1.1.0] - 2024-12

Added

  • player_possession filter type
  • team_side_perspective option for ball location filter

Fixed

  • Padding now correctly applied in query-intervals

[1.0.0] - 2024-10

Initial Release

  • Events endpoint
  • Meta-data endpoint
  • Query intervals with filters:
  • team_possession
  • ball_location
  • player_ball_proximity
  • match_timeline
  • scene