Skip to content

Changelog

All notable changes to API v1 are documented here.

[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

  • Identities field added to Summary endpoint
  • Maps player IDs to display names (e.g., "0-10": "Team A #10")
  • Replaces meta-data endpoint for player identity lookup

Deprecated

  • Meta-data endpoint (GET /analyses/{id}/meta-data)
  • Use Summary endpoint instead, which now includes identities field

[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