Skip to main content

Base URL

Authentication

All requests require an x-api-key header:

Esports-Specific Notes

Supported Games

Three major competitive games are covered:
  • Counter-Strike 2 (CS2) — Category ID: 1572
  • League of Legends (LoL) — Category ID: 1571
  • Dota 2 — Category ID: 1570

Categories = Games

Unlike traditional sports where categories represent countries, in esports categories represent games. Use /api/countries to list all game categories.

Match Format

  • CS2: Best of 1 (groups) or Best of 3/5 (playoffs). Maps: Mirage, Inferno, Nuke, Anubis, Ancient, Dust2, Vertigo.
  • LoL: Best of 1 (regular season) or Best of 3/5 (playoffs). Games last 25-45 min.
  • Dota 2: Best of 2 (groups) or Best of 3/5 (playoffs). Games last 30-60 min.
Score fields use period1 through period5 (maps or games in a series).

Team Size

All three games feature 5 players per team.

24/7 Schedule

Esports runs around the clock with 100-200+ matches per day across all games. There are almost always live matches at any time.

Streaming

The /channels endpoint returns Twitch and YouTube stream links instead of traditional TV channels.

Key Stats

  • CS2: Kills, Deaths, Assists, ADR (Average Damage per Round), KAST%, Rating 2.0
  • LoL: Kills, Deaths, Assists, CS (Creep Score), Gold, Towers, Dragons, Barons
  • Dota 2: Kills, Deaths, Assists, GPM (Gold Per Minute), XPM, Last Hits, Denies

Test IDs

Use the search endpoint to discover IDs:

Endpoint Categories

Total: 89 endpoints

Example Requests

UI Design Ideas

  • Score display: Show map-by-map (Map 1: 16-13, Map 2: 13-16, Map 3: 16-10 = 2-1)
  • Team branding: Use /teams/{id}/image — org logos are central to esports identity
  • Playoff brackets: Critical for tournament UIs — use /knockout
  • Stream links: Show Twitch/YouTube links prominently — use /match/{id}/channels
  • Map veto: CS2 map pick/ban — check /match/{id}/incidents
  • Player IGN: Players known by in-game name (s1mple, Faker), not real name
  • 24/7 schedule: Always show timezone — matches run around the clock
  • H2H records: Very important — use /match/{id}/h2h

Sport Comparison — Esports vs Traditional Sports

Last modified on June 29, 2026