WSBKDATA.PRO

Public Sports Data API

Public API documentation for WorldSBK and Cue Sports data, including calendar, riders, teams, standings, results, tournaments, players, matches, brackets, rankings, live scores, frames, and downloaded media assets.

Open Heyball App Open Full API Document Open Swagger

Access

Base URL

Use this host for all API requests.

https://api.wsbkdata.pro

Authentication

Protected endpoints require an API key.

X-API-Key: your_api_key
Authorization: Bearer your_api_key

Full Reference

The canonical external document contains all parameters and response examples.

GET https://doc.wsbkdata.pro/PUBLIC_API.md

Current Data

156WorldSBK riders
103WorldSBK teams
31Cue tournaments
208Cue players
455Cue matches
455Cue frame rows
247Cue ranking rows
80Cue media assets

WorldSBK Endpoints

Core Data

GET /api/motorsport/wsbk/seasons
GET /api/motorsport/wsbk/2026/calendar
GET /api/motorsport/wsbk/2026/riders?class_code=SBK
GET /api/motorsport/wsbk/2026/teams?class_code=SBK
GET /api/motorsport/wsbk/2026/standings?class_code=SBK

Results And Assets

GET /api/motorsport/wsbk/2026/results
GET /api/motorsport/wsbk/2026/result-documents
GET /api/motorsport/wsbk/2026/events/AUS/sessions
GET /api/motorsport/wsbk/sessions/{session_id}/results
GET /api/motorsport/wsbk/assets/{asset_id}

Cue Sports Endpoints

Tournaments And Players

GET /api/cue-sports/disciplines
GET /api/cue-sports/tournaments?discipline=heyball
GET /api/cue-sports/tournaments/{tournament_id}
GET /api/cue-sports/tournaments/{tournament_id}/entries
GET /api/cue-sports/players?source=cuescore
GET /api/cue-sports/players/{player_id}

Matches And Rankings

GET /api/cue-sports/tournaments/{tournament_id}/matches
GET /api/cue-sports/tournaments/{tournament_id}/bracket
GET /api/cue-sports/matches/{match_id}/frames
GET /api/cue-sports/live-scores?tournament_id=...
GET /api/cue-sports/rankings
GET /api/cue-sports/rankings/{ranking_id}/rows

Media Assets

WorldSBK Assets

Rider images, team images, event backgrounds, and circuit SVG assets are stored locally and returned as binary content.

GET /api/motorsport/wsbk/assets/{asset_id}

Cue Sports Assets

CueScore player avatars from public avatar URLs are downloaded into MongoDB and referenced by avatar_asset_id.

GET /api/cue-sports/assets/{asset_id}

Asset Response

Asset endpoints return binary data with long cache headers and the original source URL.

Content-Type: image/png
Cache-Control: public, max-age=31536000
X-Original-URL: https://...

Quick Examples

Get Heyball tournaments

curl -H "X-API-Key: your_api_key" \
  "https://api.wsbkdata.pro/api/cue-sports/tournaments?discipline=heyball&limit=20"

Get WorldSBK standings

curl -H "X-API-Key: your_api_key" \
  "https://api.wsbkdata.pro/api/motorsport/wsbk/2026/standings?class_code=SBK"

Important Notes

CueScore public data may not expose true frame-by-frame sequences. When only aggregate match scores are available, cue_match_frames stores a synthetic aggregate row with frame_number: 0, synthetic: true, and source_detail: aggregate_only.

For full field descriptions, query parameters, response shapes, and integration flows, use PUBLIC_API.md. Legacy focused documents are also available: API_DATA_FORMAT.md and CUE_SPORTS_API.md.