League and season calendar research
Mit LoL Esports-Endpunkten verwandelst du league and season calendar research in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
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.
Endpunkt-Familien
6
Dokumentierte Parameter
48
Beispiele
13
Live-Katalog-Snapshot
Aktive Endpunkte
13
Methoden
GET
Pflichtparameter
19
Schema-Referenzen
13
{
"platform": "LoL Esports",
"endpoint": "lolesports-completed-events",
"method": "GET",
"path": "/lolesports/completed-events",
"auth": "apiKey"
}Use Cases
Collect official League of Legends Esports leagues, season history, schedules, standings, news cards, match events, and live game windows.
Mit LoL Esports-Endpunkten verwandelst du league and season calendar research in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit LoL Esports-Endpunkten verwandelst du tournament standings monitoring in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit LoL Esports-Endpunkten verwandelst du match and live-game analysis in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Managed Execution
Jede Zahl unten stammt direkt aus dem Live-LoL Esports-Endpunktkatalog — 13 Endpunkte, 48 dokumentierte Request-Parameter und 13 veröffentlichte Response-Schemas — demselben Katalog, gegen den auch Docs und Playground laufen.
13 documented LoL Esports endpoints, grouped into 13 request families — Completed Events, Event and Game Details, plus 10 more.
48 request parameters are documented across those LoL Esports endpoints, 19 of them required — the full input contract is public before you write any integration code.
13 of the 13 LoL Esports endpoints ship a recorded example response, and 13 carry a documented response schema — you can code against the real JSON before the first request.
LoL Esports endpoints document their error responses (400, 404, 429 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
13 hosted MCP tools back the LoL Esports endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Abdeckungskarte
/lolesports/completed-events
/lolesports/event
/lolesports/game-details
/lolesports/game-window
/lolesports/gpr
/lolesports/leagues
Ausgewählte Endpunkte
/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.
Hinweise zur Response
- `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-Tool 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.
Hinweise zur Response
- `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-Tool 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.
Hinweise zur Response
- 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-Tool 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.
Hinweise zur Response
- 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-Tool 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.
Hinweise zur Response
- 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-Tool 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`.
Hinweise zur Response
- `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-Tool lolesports_leagues
Verwandte APIs
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.
So scrapst du 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.