Motorsport V2 API Overview

​

Base URL

https://api.sportsapipro.com/v2/motorsport

​

Authentication

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/motorsport/live

​

Motorsport-Specific Notes

• Events are races/sessions — not matches. Each session (FP1, FP2, FP3, Qualifying, Sprint, Race) is a separate event
• Race weekends — 4-6 sessions per Grand Prix weekend (Friday-Sunday)
• Categories — Championship types (F1=36, MotoGP=1325, Moto2=1580, Moto3=1581, IndyCar=1527)
• Score format — Finishing positions (P1-P20+), championship points
• Participants — 20+ drivers/riders on track simultaneously
• Off-weekends — During breaks there may be 0 events

​

Canonical IDs and Routing

​

Key IDs to remember

​

Upstream limitations

• /sport/motorsport/scheduled-events/{date} always returns an empty list (motorsport stages are not published in the date-scoped feed). Use the race calendar endpoint instead.
• Constructor teams (e.g. Red Bull Racing 214902) do not expose /events/last or /near-events. Only driver “teams” do.
• Individual stage sub-endpoints /scores, /lineups, /statistics, /incidents, /startgrid, /player-statistics, /best-players, /graph, /pregame-form, /streaks, /odds*, /winning-odds, /award, /h2h, /media, /votes, /missing-players, /channels, /venue are not available for motorsport — the upstream feed embeds finishing order, starting grid, lap data, and race incidents inside the stage detail. Use GET /api/match/:matchId instead.
• Season-level /season/{sid}/venues and /season/{sid}/statistics also return 404 for motorsport.
• /api/live/all currently returns 404 on the motorsport vanity — use /api/live for live sessions. /api/live is the canonical live feed for motorsport and carries the same event data.
• /tournament/{id}/season/{sid}/standings and /standings/teams both return constructor standings (Mercedes, Red Bull, Aprilia Racing, etc). There is no drivers-standings endpoint. There is also no per-race results[] array, so a drivers points table cannot be derived. The only driver-level ranking available today is race wins: read winner from each stage in /tournament/{id}/season/{sid}/races and count by driver.
• /events/next/0 returns an empty list during off-season / winter break (e.g. between F1 seasons). This is expected, not a bug.

​

Race Weekend Structure

​

Formula 1 (typical)

​

MotoGP (typical)

​

Championship Points (F1 2025+)

​

Key Motorsport Statistics

​

Endpoint Categories

​

Example Requests

curl -X GET "https://api.sportsapipro.com/v2/motorsport/live" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  'https://api.sportsapipro.com/v2/motorsport/live',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const data = await response.json();

import requests

response = requests.get(
    'https://api.sportsapipro.com/v2/motorsport/live',
    headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()

​

UI Design Ideas

• Starting grid view: Read the startingGrid / results[] block from /match/{id} (stage detail) — show grid positions (pole position highlighted)
• Race results: Show finishing order with gaps (“+5.2s”, “+1 lap”, “DNF”)
• Championship standings: Constructors’ Championship only. F1 rows carry position, points, victories, podiums, polePositions, racesStarted, racesWithPoints; MotoGP rows carry position, points only — render the columns you actually receive rather than assuming the F1 shape. A drivers table is not available; if you show one, build it from race wins.
• Race calendar: Show full season calendar with circuits — use .../rounds + .../venues
• Lap chart: Use /match/{id}/graph — show position changes lap-by-lap
• Team colors: F1 teams have distinctive colors — display branding prominently
• Session types: Clearly label Practice/Qualifying/Sprint/Race — very different contexts
• DNF/DNS: Handle “Did Not Finish” and “Did Not Start” statuses
• Fastest lap: Show which driver set it — prestigious stat
• Weather: Rain transforms races — show prominently if available

​

MotoGP Championship Points

​

Sport Comparison — Motorsport vs Other Sports