Unofficial documentation to internal Riot Games APIs for LOL eSports.
GET /api/programmingWeek/{date}/{timezone}.json HTTP/1.1
Host: http://na.lolesports.com| Name | Description | Type |
|---|---|---|
| date | YYYY-MM-DD date to look up matches | string |
| offset | ±[hh][mm] timezone offset for match times | string |
GET /api/programmingWeek/2014-05-19/-0700.json HTTP/1.1
Host: http://na.lolesports.com{
"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"
}
}--
GET /api/programming/{block_id}.json HTTP/1.1
Host: http://na.lolesports.com| Name | Description | Type |
|---|---|---|
| expand_matches | Include to include rich match meta data | string |
GET /api/programming/1855.json?expand_matches=1 HTTP/1.1
Host: http://na.lolesports.com{
"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"
}--
GET /api/programming.json?parameters[method]=all HTTP/1.1
Host: http://na.lolesports.comNote: 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 |
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[
{
"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"
}
]--
GET /api/match/{id}.json HTTP/1.1
Host: http://na.lolesports.comGET /api/match/2291.json HTTP/1.1
Host: http://na.lolesports.com{
"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"
}--
GET /cdn/4.7.16/data/{locale}/language.json HTTP/1.1
Host: http://ddragon.leagueoflegends.comGET /cdn/4.7.16/data/en_US/language.json HTTP/1.1
Host: http://ddragon.leagueoflegends.com{
"type": "language",
"version": "4.7.16",
"data": {
"Back": "Back",
"Continue": "Continue",
"Language": "Language",
"ItemInfo": "Item Info",
"NextRank_": "Next Rank:",
"Rank_": "Rank:",
"PlayingAs": "Playing As",
"PlayingAgainst": "Playing Against",
"CD_": "CD:",
"Range": "Range",
"Range_": "Range:",
"Details_": "Details:",
"PrimaryRole": "Primary Role",
"mobileCompanion": "Companion",
"mobileForum": "Forum",
"mobileFriends": "Friends",
"mobilePleaseWait": "Please wait...",
"mobileNews": "News",
"modeClassic": "Classic",
"modeOdin": "Dominion",
"modeAram": "ARAM",
"modeTutorial": "Tutorial",
"modeOneforall": "One for All",
"modeFirstblood": "Showdown",
"mode6v6": "Hexakill",
"modeCof": "FRONTEND_cof_game_mode_name",
"Map1": "Summoner's Rift",
"Map8": "The Crystal Scar",
"Map10": "The Twisted Treeline",
"Map12": "Howling Abyss",
"categoryChampion": "Champions",
"categoryItem": "Items",
"categoryMastery": "Masteries",
"categoryRune": "Runes",
"categorySummoner": "Summoner Spells",
"Gold": "Gold",
"Level": "Level",
"Abilities": "Abilities",
"ChampionInfo": "Champion Info",
"Lore": "Lore",
"Stats": "Stats",
"Tips": "Tips",
"statAbility": "Ability",
"statAttack": "Attack",
"statDefense": "Defense",
"statDifficulty": "Difficulty",
"statUtility": "Utility",
"Assassin": "Assassin",
"Fighter": "Fighter",
"Marksman": "Marksman",
"Mage": "Mage",
"Support": "Support",
"Tank": "Tank",
"spells_Self": "Self",
"spells_target_0": "Self",
"spells_target_1": "Target",
"spells_target_2": "Area",
"spells_target_3": "Cone",
"spells_target_4": "Self Area",
"spells_target_5": "Variable",
"spells_target_6": "Location",
"spells_target_7": "Direction",
"spells_target_8": "Vector Direction",
"spells_target_100": "Global",
"AllItems": "All Items",
"Armor": "Armor",
"Attack": "Attack",
"AttackSpeed": "Attack Speed",
"Consumable": "Consumable",
"CooldownReduction": "Cooldown Reduction",
"CriticalStrike": "Critical Strike",
"Damage": "Damage",
"Defense": "Defense",
"Health": "Health",
"HealthRegen": "Health Regen",
"LifeSteal": "Life Steal",
"Magic": "Magic",
"Mana": "Mana",
"ManaRegen": "Mana Regen",
"Movement": "Movement",
"SpellBlock": "Magic Resist",
"SpellDamage": "Ability Power",
"Boots": "Boots",
"NonbootsMovement": "Other Movement Items",
"Tenacity": "Tenacity",
"SpellVamp": "Spell Vamp",
"GoldPer": "Gold Income",
"Slow": "Slow",
"Aura": "Aura",
"Active": "Active",
"MagicPenetration": "Magic Penetration",
"ArmorPenetration": "Armor Penetration",
"colloq_Armor": ";",
"colloq_Attack": ";",
"colloq_AttackSpeed": ";as",
"colloq_Consumables": ";",
"colloq_CriticalStrike": ";",
"colloq_Damage": ";ad",
"colloq_Defense": ";",
"colloq_Health": ";hp",
"colloq_HealthRegen": ";hpregen;hp5",
"colloq_LifeSteal": ";lifesteal",
"colloq_Magic": ";",
"colloq_Mana": ";mp",
"colloq_ManaRegen": ";mpregen;mp5",
"colloq_Movement": ";movespeed",
"colloq_SpellBlock": ";mr",
"colloq_SpellDamage": ";ap",
"colloq_Consumable": ";",
"colloq_Boots": ";",
"colloq_NonbootsMovement": ";",
"colloq_CooldownReduction": ";cdr",
"colloq_Tenacity": ";",
"colloq_SpellVamp": ";spellvamp",
"colloq_GoldPer": ";gp10",
"colloq_Slow": ";",
"colloq_Aura": ";",
"colloq_Active": ";",
"colloq_MagicPenetration": ";",
"colloq_ArmorPenetration": ";",
"RecommendedItems": "Recommended Items",
"recommended_starting": "Starting Items",
"recommended_essential": "Essential Items",
"recommended_offensive": "Offensive Items",
"recommended_defensive": "Defensive Items",
"recommended_consumables": "Consumables",
"Require_": "Requires:",
"Cost_": "Cost:",
"OriginalCost_": "Original Cost:",
"SellsFor_": "Sells for:",
"UpgradeCost_": "Upgrade Cost:",
"Builds_": "Builds Into:",
"ButtonBuy": "BUY",
"ButtonSell": "SELL",
"SpecialRecipeSmall": "*",
"SpecialRecipeLarge": "Special",
"FlatArmorMod": "Armor",
"FlatAttackSpeedMod": "Attack Speed",
"FlatBlockMod": "Block",
"FlatCritChanceMod": "Crit Chance",
"FlatCritDamageMod": "Crit Dmg",
"FlatEnergyPoolMod": "Energy",
"FlatEnergyRegenMod": "Energy Regen / 5",
"FlatEXPBonus": "Exp Bonus",
"FlatHPPoolMod": "Health",
"FlatHPRegenMod": "Health Regen / 5",
"FlatMagicDamageMod": "Ability Power",
"FlatMovementSpeedMod": "Move Speed",
"FlatMPPoolMod": "Mana",
"FlatMPRegenMod": "Mana Regen / 5",
"FlatPhysicalDamageMod": "Physical Dmg",
"FlatSpellBlockMod": "Magic Resist",
"PercentArmorMod": "Armor %",
"PercentAttackSpeedMod": "Attack Speed %",
"PercentBlockMod": "Block %",
"PercentCritChanceMod": "Crit Chance %",
"PercentCritDamageMod": "Crit Dmg %",
"PercentDodgeMod": "Dodge %",
"PercentEXPBonus": "Exp Bonus %",
"PercentHPPoolMod": "Max Health %",
"PercentHPRegenMod": "Health % / 5",
"PercentMagicDamageMod": "Max Ability Power %",
"PercentMovementSpeedMod": "Move Speed %",
"PercentMPPoolMod": "Max Mana %",
"PercentMPRegenMod": "Mana % / 5",
"PercentPhysicalDamageMod": "Physical Dmg %",
"PercentSpellBlockMod": "Magic Resist %",
"rFlatArmorModPerLevel": "Armor at level 18",
"rFlatArmorPenetrationMod": "Armor Pen.",
"rFlatArmorPenetrationModPerLevel": "Armor Pen. at level 18",
"rFlatCritChanceModPerLevel": "Crit Chance at level 18",
"rFlatCritDamageModPerLevel": "Crit Dmg at level 18",
"rFlatDodgeMod": "Dodge",
"rFlatDodgeModPerLevel": "Dodge at level 18",
"rFlatEnergyModPerLevel": "Energy at level 18",
"rFlatEnergyRegenModPerLevel": "Energy Regen / 5 at level 18",
"rFlatGoldPer10Mod": "Gold per 10",
"rFlatHPModPerLevel": "Health at level 18",
"rFlatHPRegenModPerLevel": "Health Regen / 5 at level 18",
"rFlatMagicDamageModPerLevel": "Ability Power at level 18",
"rFlatMagicPenetrationMod": "Magic Pen.",
"rFlatMagicPenetrationModPerLevel": "Magic Pen. at level 18",
"rFlatMovementSpeedModPerLevel": "Move Speet at level 18",
"rFlatMPModPerLevel": "Mana at level 18",
"rFlatMPRegenModPerLevel": "Mana Regen / 5 at level 18",
"rFlatPhysicalDamageModPerLevel": "Physical Dmg at level 18",
"rFlatSpellBlockModPerLevel": "Magic Resist at level 18",
"rFlatTimeDeadMod": "Time Dead",
"rFlatTimeDeadModPerLevel": "Time Dead at level 18",
"rPercentArmorPenetrationMod": "Armor Pen. %",
"rPercentArmorPenetrationModPerLevel": "Armor Pen. % at level 18",
"rPercentAttackSpeedModPerLevel": "Attack Speed % at level 18",
"rPercentCooldownMod": "Cooldown %",
"rPercentCooldownModPerLevel": "Cooldown % at level 18",
"rPercentMagicPenetrationMod": "Magic Pen. %",
"rPercentMagicPenetrationModPerLevel": "Magic Pen. % at level 18",
"rPercentMovementSpeedModPerLevel": "Move Speed % at level 18",
"rPercentTimeDeadMod": "Time Dead %",
"rPercentTimeDeadModPerLevel": "Time Dead % / lvl",
"PercentLifeStealMod": "Lifesteal Bonus %",
"PercentSpellVampMod": "Spellvamp Bonus %",
"masteryOffense": "Offense",
"masteryDefense": "Defense",
"masteryUtility": "Utility",
"native_ar": "العربية",
"native_bg": "български език",
"native_cs": "čeština",
"native_de": "Deutsch",
"native_el": "ελληνικά",
"native_en": "English",
"native_es": "español",
"native_fr": "français",
"native_hu": "magyar",
"native_id": "Bahasa Indonesia",
"native_it": "Italiano",
"native_ja": "日本語",
"native_ko": "조선말",
"native_nl": "Nederlands",
"native_pl": "język polski",
"native_pt": "português",
"native_ro": "română",
"native_ru": "русский язык",
"native_th": "ภาษาไทย",
"native_tr": "Türkçe",
"native_vn": "Tiếng Việt",
"native_zh": "汉语",
"native_zh_CN": "简体字",
"native_zh_MY": "简体字",
"native_zh_TW": "繁體字"
},
"tree": {
"searchKeyIgnore": "",
"searchKeyRemap": []
}
}--
GET /cdn/4.7.16/data/{locale}/champion.json HTTP/1.1
Host: http://ddragon.leagueoflegends.comGET /cdn/4.7.16/data/en_US/champion.json HTTP/1.1
Host: http://ddragon.leagueoflegends.com{
"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": {}
}
}--
GET /cdn/4.7.16/data/{locale}/item.json HTTP/1.1
Host: http://ddragon.leagueoflegends.comGET /cdn/4.7.16/data/en_US/item.json HTTP/1.1
Host: http://ddragon.leagueoflegends.comExample response: https://gist.github.com/stillmotion/e15d0bfac97462dcb995
--
GET /cdn/4.7.16/data/{locale}/summoner.json HTTP/1.1
Host: http://ddragon.leagueoflegends.comGET /cdn/4.7.16/data/en_US/summoner.json HTTP/1.1
Host: http://ddragon.leagueoflegends.com{
"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": {}
}
}
Why some examples are not working?
http://na.lolesports.com/api/programmingWeek/2014-05-19/-0700.json for example...