Skip to content
Get a key
API reference / Esports
GET/esports/matches

List esports matches

CS2, Dota 2 and League of Legends matches from the data provider and Valorant matches from Liquipedia (score = maps or games won; a Liquipedia match carries attribution), paginated and filtered

In preview, not in plans yetPay per call without a key: $0.002 in USDC

Parameters

  • gamestring · query

    cs2, dota2, lol or valorant

  • limitinteger · query

    Maximum results (1-100)

    Default: 50
  • offsetinteger · query

    Results to skip

    Default: 0
  • datestring · query

    Filter by date (YYYY-MM-DD)

  • date_fromstring · query

    Matches on or after this date (YYYY-MM-DD)

  • date_tostring · query

    Matches on or before this date (YYYY-MM-DD)

  • statusstring · query

    Filter by status (NS, Started, Pause, Finished, WO, Postponed, Canceled)

  • league_idinteger · query

    Filter by league ID

  • team_idinteger · query

    Only matches of this team (home or away, every competition)

  • orderstring · query

    desc for latest first (default: by start time ascending)

    One of: asc, desc
  • futurestring · query

    Filter to matches scheduled today or later (true)

Response

JSON with success, the result in data, and where the endpoint pages its results meta.

  • dataarray of object
  • attributionstring

    Attribution is set on a Valorant match from Liquipedia, and on a walkover whose winner came from it.

  • away_teamobject
  • idinteger
  • namestring
  • scoreinteger
  • best_ofinteger
  • gamestring

    cs2, dota2, lol...

  • has_mapsboolean

    maps or games with player lines at /matches/{id}/maps

  • home_teamobject
  • idinteger
  • namestring
  • scoreinteger
  • idinteger
  • league_idinteger
  • league_namestring

    "CS2: ESL Pro League Playoffs"

  • match_idinteger
  • start_datestring
  • start_timestring
  • statusstring

    NS, Started, Pause, Finished, WO, Postponed, Canceled

  • winnerstring

    Winner: home or away, for a finished series (the higher score) and a walkover whose winner is known (WO is stored 0-0; winner_source liquipedia when Liquipedia gave it).

  • winner_sourcestring
  • errorobject
  • codestring
  • messagestring
  • metaobject
  • attributionstring

    Attribution a data source's licence asks for (Cricsheet's history).

  • limitinteger
  • offsetinteger
  • totalinteger
  • successboolean

Errors

StatusCodeWhen
400INVALID_PARAMA parameter is missing or wrong, and the message names it. Fix the request; do not retry it.
401UNAUTHORIZEDThe key is missing, mistyped or was rotated.
402x402 offersNo key and no valid payment: the body lists what to pay. Only a 200 answer is charged.
500INTERNAL_ERROROur side. Try again after a few seconds and check the status page.

All errors have the shape described in Errors and limits.

Generated from the OpenAPI file, version 1.0. See it as JSON

Was this page helpful?