# LOL eSports API Unofficial documentation to internal Riot Games APIs for LOL eSports. ## Week Schedule ```http GET /api/programmingWeek/{date}/{timezone}.json HTTP/1.1 Host: http://na.lolesports.com ``` ### Parameters | Name | Description | Type | |--------|-------------------------------------------|--------| | date | YYYY-MM-DD date to look up matches | string | | offset | ±[hh][mm] timezone offset for match times | string | ### Example ```http GET /api/programmingWeek/2014-05-19/-0700.json HTTP/1.1 Host: http://na.lolesports.com ``` ```json { "programming_block": { "1719": { "id": "1719" }, "1773": { "id": "1773" }, "1774": { "id": "1774" }, "1775": { "id": "1775" }, "1826": { "id": "1826" }, "1827": { "id": "1827" }, "1828": { "id": "1828" }, "1855": { "id": "1855" }, "1887": { "id": "1887" }, "1888": { "id": "1888" }, "1889": { "id": "1889" } }, "days": [ { "blockNum": 0, "date": "2014-05-19T07:00:00+00:00", "day": "Monday" }, { "blockNum": 2, "blockIds": [ "1855", "1773" ], "date": "2014-05-20T07:00:00+00:00", "day": "Tuesday" }, { "blockNum": 1, "blockIds": [ "1774" ], "date": "2014-05-21T07:00:00+00:00", "day": "Wednesday" }, { "blockNum": 1, "blockIds": [ "1775" ], "date": "2014-05-22T07:00:00+00:00", "day": "Thursday" }, { "blockNum": 1, "blockIds": [ "1826" ], "date": "2014-05-23T07:00:00+00:00", "day": "Friday" }, { "blockNum": 4, "blockIds": [ "1887", "1719", "1827", "1888" ], "date": "2014-05-24T07:00:00+00:00", "day": "Saturday" }, { "blockNum": 2, "blockIds": [ "1889", "1828" ], "date": "2014-05-25T07:00:00+00:00", "day": "Sunday" } ], "containsMatch": true, "nextProgBlock": { "status": 1, "blockId": "1776", "blockDate": "2014-05-29T16:00:00+00:00" } } ``` -- ## Tournamnent ```http GET /api/programming/{block_id}.json HTTP/1.1 Host: http://na.lolesports.com ``` ### Parameters | Name | Description | Type | |----------------|---------------------------------------------|--------| | expand_matches | Include to include rich match meta data | string | ### Example ```http GET /api/programming/1855.json?expand_matches=1 HTTP/1.1 Host: http://na.lolesports.com ``` ```json { "blockId": "1773", "dateTime": "2014-05-20T15:00:00+00:00", "tickets": " ", "matches": { "2291": { "dateTime": "2014-05-20T15:00Z", "matchName": "Fnatic vs SK Gaming", "winnerId": "67", "matchId": "2291", "url": "/tourney/match/2291", "maxGames": "1", "isLive": false, "isFinished": "1", "tournament": { "id": "102", "name": "EU Summer Split", "round": "1" }, "contestants": { "blue": { "id": "68", "name": "Fnatic", "logoURL": "/sites/default/files/styles/grid_medium_square/public/fnaticlogo.png?itok=1C-vza-C", "acronym": "FNC", "wins": 0, "losses": 1 }, "red": { "id": "67", "name": "SK Gaming", "logoURL": "/sites/default/files/styles/grid_medium_square/public/sk-white.png?itok=Z75PKCOL", "acronym": "SK", "wins": 1, "losses": 0 } }, "gamesInfo": { "game0": { "id": "2774", "winnerId": "67" } }, "liveStreams": false, "polldaddyId": "8011364:36412083:36412084" } }, "leagueId": "2", "tournamentId": "102", "significance": "0", "tbdTime": "0", "leagueColor": "#CA3B3B", "week": "1", "body": [], "label": "EU Summer Split - Week 1" } ``` -- ## Tournament Week Schedule ```http GET /api/programming.json?parameters[method]=all HTTP/1.1 Host: http://na.lolesports.com ``` ### Parameters Note: All parameters need to be wrapped in parameters[param] scope. | Name | Description | Type | |----------------|---------------------------------------------|--------| | week | Week number in tournament to return matches | number | | tournament | Tournament ID to search within | number | | expand_matches | Include to include rich match meta data | string | ### Example ```http GET /api/programming.json?parameters[method]=all¶meters[week]=1¶meters[tournament]=102¶meters[expand_matches]=1 HTTP/1.1 Host: http://na.lolesports.com ``` ```json [ { "blockId": "1773", "dateTime": "2014-05-20T15:00:00+00:00", "tickets": " ", "matches": { "2291": { "dateTime": "2014-05-20T15:00Z", "matchName": "Fnatic vs SK Gaming", "winnerId": "67", "matchId": "2291", "url": "/tourney/match/2291", "maxGames": "1", "isLive": false, "isFinished": "1", "tournament": { "id": "102", "name": "EU Summer Split", "round": "1" }, "contestants": { "blue": { "id": "68", "name": "Fnatic", "logoURL": "/sites/default/files/styles/grid_medium_square/public/fnaticlogo.png?itok=1C-vza-C", "acronym": "FNC", "wins": 0, "losses": 1 }, "red": { "id": "67", "name": "SK Gaming", "logoURL": "/sites/default/files/styles/grid_medium_square/public/sk-white.png?itok=Z75PKCOL", "acronym": "SK", "wins": 1, "losses": 0 } }, "gamesInfo": { "game0": { "id": "2774", "winnerId": "67" } }, "liveStreams": false, "polldaddyId": "8011364:36412083:36412084" } }, "leagueId": "2", "tournamentId": "102", "significance": "0", "tbdTime": "0", "leagueColor": "#CA3B3B", "week": "1", "body": [], "label": "EU Summer Split - Week 1" } ] ``` -- ## Match ```http GET /api/match/{id}.json HTTP/1.1 Host: http://na.lolesports.com ``` ### Example ```http GET /api/match/2291.json HTTP/1.1 Host: http://na.lolesports.com ``` ```json { "tournament": { "id": "102", "name": "EU Summer Split", "round": "1" }, "url": "/tourney/match/2291", "dateTime": "2014-05-20T15:00Z", "winnerId": "67", "matchId": "2291", "maxGames": "1", "isLive": false, "isFinished": "1", "contestants": { "blue": { "id": "68", "name": "Fnatic", "logoURL": "/sites/default/files/styles/grid_medium_square/public/fnaticlogo.png?itok=1C-vza-C", "acronym": "FNC", "wins": 0, "losses": 1 }, "red": { "id": "67", "name": "SK Gaming", "logoURL": "/sites/default/files/styles/grid_medium_square/public/sk-white.png?itok=Z75PKCOL", "acronym": "SK", "wins": 1, "losses": 0 } }, "liveStreams": false, "polldaddyId": "8011364:36412083:36412084", "games": { "game0": { "id": "2774", "winnerId": "67" } }, "name": "Fnatic vs SK Gaming" } ``` -- ## Champions ```http GET /cdn/4.7.16/data/{locale}/champion.json HTTP/1.1 Host: http://ddragon.leagueoflegends.com ``` ### Example ```http GET /cdn/4.7.16/data/en_US/champion.json HTTP/1.1 Host: http://ddragon.leagueoflegends.com ``` ```json { "type": "champion", "format": "standAloneComplex", "version": "4.7.16", "data": { "Aatrox": { "version": "4.7.16", "id": "Aatrox", "key": "266", "name": "Aatrox", "title": "the Darkin Blade", "blurb": "Aatrox is a legendary warrior, one of only five that remain of an ancient race known as the Darkin. He wields his massive blade with grace and poise, slicing through legions in a style that is hypnotic to behold. With each foe felled, Aatrox's ...", "info": { "attack": 8, "defense": 4, "magic": 3, "difficulty": 6 }, "image": { "full": "Aatrox.png", "sprite": "champion0.png", "group": "champion", "x": 0, "y": 0, "w": 48, "h": 48 }, "tags": [ "Fighter", "Tank" ], "partype": "BloodWell", "stats": { "hp": 395, "hpperlevel": 85, "mp": 30, "mpperlevel": 45, "movespeed": 345, "armor": 18, "armorperlevel": 3.8, "spellblock": 30, "spellblockperlevel": 1.25, "attackrange": 150, "hpregen": 5.75, "hpregenperlevel": 0.5, "mpregen": 0, "mpregenperlevel": 0, "crit": 0, "critperlevel": 0, "attackdamage": 55, "attackdamageperlevel": 3.2, "attackspeedoffset": -0.04, "attackspeedperlevel": 3 } }, "AnotherChampion": {} } } ``` ## Summoner Spells ```http GET /cdn/4.7.16/data/{locale}/summoner.json HTTP/1.1 Host: http://ddragon.leagueoflegends.com ``` ### Example ```json { "type": "summoner", "version": "4.7.16", "data": { "SummonerBarrier": { "id": "SummonerBarrier", "name": "Barrier", "description": "Shields your champion for 115-455 (depending on champion level) for 2 seconds.", "tooltip": "Temporarily shields {{ f1 }} damage from your champion for 2 seconds.", "maxrank": 1, "cooldown": [ 0 ], "cooldownBurn": "0", "cost": [ 0 ], "costBurn": "0", "effect": [], "effectBurn": [], "vars": [ { "link": "@cooldownsummoner", "coeff": 125, "key": "f1" } ], "key": "21", "summonerLevel": 6, "modes": [ "ARAM", "CLASSIC", "TUTORIAL", "ODIN" ], "costType": "NoCost", "range": "self", "rangeBurn": "self", "image": { "full": "SummonerBarrier.png", "sprite": "spell0.png", "group": "spell", "x": 0, "y": 0, "w": 48, "h": 48 }, "resource": "No Cost" }, "SummonerBoost": {} } } ```