Match Endpoints

Esports V2 match data: scores, statistics, odds, streams

Scoring Format

Esports matches are played across maps/games. The /scores endpoint returns:

{
  "homeScore": { "period1": 16, "period2": 10, "period3": 16, "current": 2 },
  "awayScore": { "period1": 13, "period2": 16, "period3": 12, "current": 1 }
}

• period1+ = score per map (CS2: rounds won, typically to 13/16; LoL/Dota: 1=win, 0=loss)
• current = maps/games won
• Bo3 = first to 2 maps, Bo5 = first to 3 maps

Match Endpoints (22)

All match endpoints use the base URL https://v2.esports.sportsapipro.com.

Match Details

GET /api/match/:matchId

Returns full match details including teams, scores, status, and tournament context.

Scores

GET /api/match/:matchId/scores

Map-by-map or game-by-game scores (e.g., CS2: 16-13, 13-16, 16-10 = 2-1). Fields: period1 through period5.

Lineups

GET /api/match/:matchId/lineups

Team rosters for the match (5 players per team in CS2/LoL/Dota 2).

Statistics

GET /api/match/:matchId/statistics

Match stats: kills, deaths, assists, ADR, rating (CS2); CS, gold, towers (LoL/Dota).

Incidents

GET /api/match/:matchId/incidents

Round wins, map picks/bans, key moments during the match.

Player Statistics

GET /api/match/:matchId/player-statistics
GET /api/match/:matchId/player/:playerId/statistics

All player stats in match, or individual player stats.

Best Players & Award

GET /api/match/:matchId/best-players
GET /api/match/:matchId/award

Head-to-Head & Form

GET /api/match/:matchId/h2h
GET /api/match/:matchId/pregame-form
GET /api/match/:matchId/streaks
GET /api/match/:matchId/graph

Media

GET /api/match/:matchId/highlights
GET /api/match/:matchId/media

Match Info

GET /api/match/:matchId/votes
GET /api/match/:matchId/channels

The /channels endpoint returns Twitch and YouTube stream links.

Odds

GET /api/match/:matchId/odds
GET /api/match/:matchId/odds/all
GET /api/match/:matchId/odds/pre-match
GET /api/match/:matchId/odds/live
GET /api/match/:matchId/winning-odds