League and season calendar research
LoL Esportsエンドポイントを使えば、「League and season calendar research」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Join Riot's regional and international competitions to season/split calendars, tournament standings, match games, latest news cards, and live statistical windows.
Collect official League of Legends Esports leagues, season history, schedules, standings, news cards, match events, and live game windows.
エンドポイントファミリー
6
ドキュメント化されたパラメータ
48
サンプル数
13
ライブカタログスナップショット
稼働エンドポイント
13
メソッド
GET
必須パラメータ
19
スキーマ参照
13
{
"platform": "LoL Esports",
"endpoint": "lolesports-completed-events",
"method": "GET",
"path": "/lolesports/completed-events",
"auth": "apiKey"
}ユースケース
Collect official League of Legends Esports leagues, season history, schedules, standings, news cards, match events, and live game windows.
LoL Esportsエンドポイントを使えば、「League and season calendar research」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
LoL Esportsエンドポイントを使えば、「Tournament standings monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
LoL Esportsエンドポイントを使えば、「Match and live-game analysis」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のLoL Esportsエンドポイントカタログから取得しています（エンドポイント13件、ドキュメント化されたリクエストパラメータ48個、公開レスポンススキーマ13件）。DocsとPlaygroundが参照しているカタログと同じものです。
LoL Esportsのエンドポイントは13件、13つのリクエストファミリーに分類されています（Completed Events、Event、Game Detailsほか10件）。
これらのLoL Esportsエンドポイントには48個のリクエストパラメータがドキュメント化されており、うち19個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
13件のLoL Esportsエンドポイントのうち13件が実際のサンプルレスポンスを、13件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
LoL Esportsのエンドポイントは成功時のスキーマに加えてエラーレスポンス（400、404、429、503）もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
LoL Esportsのエンドポイントは13個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
/lolesports/completed-events
/lolesports/event
/lolesports/game-details
/lolesports/game-window
/lolesports/gpr
/lolesports/leagues
主要エンドポイント
/lolesports/completed-eventsReturns every completed match of one tournament with final game wins and the game ids and VOD references for each game. An empty list is valid for a tournament that has not started.
レスポンスに関する注記
- `games[].vods` carries the provider (for example `youtube`) and its `parameter` (the video id). Call [lolesports-event](lolesports-event.md) for locale and timing of each VOD. - An empty list is valid for a tournament that has not started. - The response is cached for up to ten minutes. - `state` has these values: `unstarted`, `inProgress`, `completed`. Team `outcome` has these values: `win`, `loss`.
MCPツール lolesports_completed_events
/lolesports/eventReturns one match: league, tournament, teams with game wins, best-of strategy, each game's id, number, state (`unneeded`, `unstarted`, `inProgress`, `completed`), blue/red side assignment and VODs, plus broadcast streams. Use a game `id` with lolesports-game-window or lolesports-game-details. An unknown match id returns not found.
レスポンスに関する注記
- `games[].state` has these values: `unneeded`, `unstarted`, `inProgress`, `completed`. `sides[].side` is `blue` or `red`. - Use `games[].id` with [lolesports-game-window](lolesports-game-window.md) and [lolesports-game-details](lolesports-game-details.md). - An unknown match id returns `404`. The response is cached for up to one minute. - Team `outcome` (when present) has these values: `win`, `loss`.
MCPツール lolesports_event
/lolesports/game-detailsReturns per-player detail frames for one game: level, KDA, gold, creep score, kill participation, damage share, wards, attack damage, ability power, armor, magic resistance, final items, rune ids and skill order. Use participant ids from lolesports-game-window metadata. The same `starting_time` rule as lolesports-game-window applies.
レスポンスに関する注記
- Participant numbers match [lolesports-game-window](lolesports-game-window.md) metadata. `items` and `rune_ids` are Riot data-dragon ids. - `skill_order` lists the ability letters in the order they were levelled. - The response is cached for up to ten seconds.
MCPツール lolesports_game_details
/lolesports/game-windowReturns the lolesports live-stats window for one game: patch, blue and red team and player metadata (champion, role, summoner name) and roughly ten seconds of frames with team gold, kills, towers, inhibitors, barons, dragons and per-player level, KDA, creep score and health. `game_state` is `in_game`, `paused` or `finished`. For a game in progress omit `starting_time` for the latest window; for a completed game pass a timestamp inside the game.
レスポンスに関する注記
- Omit `starting_time` while a game is live to get the latest frames. For a finished game pass a time inside the game; frames before the game start return an empty `frames` list. - `game_state` has these values: `in_game`, `paused`, `finished`. - `participant_id` values `1` to `5` are the blue side and `6` to `10` the red side; map them to players with `blue.participants` and `red.participants`. - The response is cached for up to ten seconds. - `role` in the player metadata has these values: `top`, `jungle`, `mid`, `bottom`, `support`.
MCPツール lolesports_game_window
/lolesports/gprReturns the League of Legends Esports Global Power Rankings (GPR): every ranked team with rank, GPR score, Elo, previous rank and rank change, home league, match and game records, average opponent GPR and the tournaments counted with each result and placement. `season` selects `current` (the running year, default) or the Worlds snapshot of a four-digit year (`2025`, `2024`; every season listed in the response's `seasons` is accepted, and a year without a snapshot returns 404); `league` keeps one home league's teams and `history` adds the daily GPR history points. The response lists the seasons and home leagues available.
レスポンスに関する注記
- Teams are ordered by `rank`. `rank_change` is the previous rank minus the current rank (positive means the team moved up). `match_record` and `game_record` count the window `start_date` to `end_date`. - `tournaments` lists the events counted for the team with the team's record and `placement`; `seasons` lists the GPR pages the site links (each has a `kind` of `current` or `worlds`) and `leagues` the home leagues present, with team counts. - The data is the site's own server-rendered GPR page (about 2.5 MB), so the response is cached for up to one hour. An unavailable page returns `503`; a missing one `404`.
MCPツール lolesports_gpr
/lolesports/leaguesReturns every league on lolesports.com with its numeric `id`, `slug`, name, region, image and display status (`force_selected`, `selected`, `not_selected`, `hidden`). Use a league `id` with lolesports-schedule or lolesports-tournaments. Region labels are upstream values such as `EMEA`, `KOREA`, `CHINA`, `NORTH AMERICA` and `INTERNATIONAL`.
レスポンスに関する注記
- `id` is the numeric league id for [lolesports-schedule](lolesports-schedule.md) and [lolesports-tournaments](lolesports-tournaments.md); `slug` is the site's URL name. - `region` is an upstream label such as `EMEA`, `KOREA`, `CHINA`, `NORTH AMERICA`, `BRAZIL`, `PACIFIC` or `INTERNATIONAL`. - `display_status` has these values: `force_selected`, `selected`, `not_selected`, `hidden`. Hidden leagues are legacy leagues kept for old tournaments. - The directory changes rarely and is cached for up to one hour.
MCPツール lolesports_leagues
関連API
Sports & Gaming
Browse public sports and event data from FanDuel Sportsbook. Discover market-specific event types, follow a league or schedule, and read the markets and prices FanDuel publishes for that event and market.
Sports & Gaming
Follow public horse-racing cards across tracks and countries. Discover today's tracks, inspect races and runners, and read official results, wager-type reference data, and published pool information without placing a wager.
Sports & Gaming
Explore FanDuel Research's public editorial and sports-data surfaces. Discover sport slugs and teams, read articles and player updates, inspect live fixtures, and retrieve the published projection tables with their source-specific slate identifiers.
LoL Esportsのスクレイピング方法
LoL Esports is Riot Games' competition hub for regional leagues and international events. Its official news page is a latest-first editorial list, while the schedule and season archive distinguish regions, splits, and tournament stages. Riot's community guidelines separately caution that independent community competitions must not be presented as official Riot or LoL Esports events. Crawlora's 13 production-published routes cover league and season discovery, schedule, current news cards, standings, completed matches, event detail, teams, and game-level feeds. The schedule uses returned cursors rather than a date-range parameter, and a game window is a short time-sliced sample. Keep region, season, tournament, match, and game IDs at their own levels; an empty live result may simply mean no match is in progress. On 2026-10-30 the leagues route returned 51 leagues, the live route returned none at 03:59 UTC although Worlds 2026 (2026-10-15 to 2026-11-15) was marked inProgress, and the Global Power Rankings snapshot calculated 2026-10-29 ranked 58 teams, led by Gen.G (1556), Hanwha Life Esports (1540), Bilibili Gaming (1513), T1 (1493) and G2 Esports (1463).
/lolesports/leagues returns numeric league IDs and regional labels. `/lolesports/seasons` adds historical season/split/tournament groupings, while `/lolesports/tournaments` lists a league's events. Reuse returned IDs—not display-name slugs—for standings, completed events, and event detail. Each league carries a display_status; on 2026-10-30 three leagues were force_selected (Worlds, MSI, First Stand), six selected, 33 not_selected and nine hidden. LCK, LPL and LCP were all not_selected, so the field is the site's navigation setting, not a measure of competitive weight, and should not be used to drop leagues.
/lolesports/schedule accepts an optional league_id and page_token, but no date window or page number. Follow older_page_token and newer_page_token from the response to traverse the source's schedule. An inactive league may validly return an empty list.
Take match IDs from schedule, live, or standings rows into /lolesports/event. Its game IDs then feed /lolesports/game-window and /lolesports/game-details. game-window exposes roughly ten seconds of frames; optional starting_time values must be UTC timestamps aligned to ten-second boundaries.
The hl parameter controls names and labels and accepts the documented locale list, defaulting to en-US. Preserve state (unstarted, inProgress, completed), tournament stage, and region with each record. A valid empty live feed means no match is playing, not that the league directory is broken.
/lolesports/news lists up to 100 newest cards for a supported `hl` locale. Cards include links and summaries; author arrays may be empty. On 2026-10-30 the newest three of the 100 cards were all YouTube links (external true, empty authors) published between 2026-10-12 and 2026-10-15, so the latest card can be weeks old and point off-site. This route has no page cursor, article-body, author-profile, or byline-search operation.
/lolesports/gpr is a season ranking snapshot, not a tournament bracket. It accepts season current, 2025, or 2024; an optional league slug from its leagues list; limit 1–200; and history=true for daily rank, score, and Elo points. Preserve start_date/end_date and fetched_at because the ranking page is cached for up to an hour. The 2026-10-30 response covered 2026-01-01 to 2026-10-30, kept score and elo as different numbers (Gen.G score 1556, elo 1585), listed in-progress Worlds 2026 results with wins and losses but no placement, and split its 58 teams across CBLOL (8), LCK (10), LCP (8), LCS (8), LEC (10) and LPL (14).
FAQ
No. It accepts an optional league_id and a page_token returned by an earlier response. Store both cursors and traverse the source schedule instead of inventing date filters.
Call live or schedule, follow a match ID to event detail, then use its game ID with game-window. Omit starting_time for the latest live frames; historical windows require a timestamp aligned to a ten-second boundary.
It lists only matches in progress at the instant of the call. At 03:59 UTC on 2026-10-30 it returned an empty list while the GPR response still showed Worlds 2026 as inProgress. Fall back to the schedule with its cursors to find the next match before concluding the event has stopped.
No. Riot's community competition guidelines distinguish independent community tournaments from official Riot or LoL Esports events. The API represents its documented official data routes; do not label a community event as Riot-endorsed without source evidence.
No. /lolesports/gpr is a season-level global ranking with a source date window and optional daily history; /lolesports/standings follows stages and matches inside one tournament. Keep their scopes separate in a leaderboard.
No. `/lolesports/news` returns the latest article cards, links, summaries, and sometimes authors; it has no article-body/detail route, author-profile route, or byline search.