# Data Dragon > Read League of Legends' game data from Data Dragon, Riot Games' official source for it: every champion with its lore, stats, abilities and skins, every item with its price, stats and recipe, and the runes, summoner spells, profile icons and maps, in any of the game's languages and for any patch since 2012. Turn the numbers in match data into names and pictures (champion 62 is Wukong, item 3031 is Infinity Edge and queue 420 is Ranked Solo), pick a random champion, find the patch a region is on, and hear about a new patch the day it lands. Any splash art or icon can be downloaded to attach. Every action reads, and no account or API key is needed. App · Gaming · 18 actions. Web page: https://docs.lodol.com/docs/integrations/data-dragon ## Actions ### Download an image Download an image from Data Dragon and store it, so a later step can attach it to an email or a message or put it in a document. Give it any image URL another Data Dragon step returned: splash or loading screen art, a champion portrait, or an item, rune, spell, profile icon or minimap image. **Inputs** - Image URL (`image_url`, text, required): An image URL another Data Dragon step returned, like a champion's splash_url or an item's image_url. It has to be on ddragon.leagueoflegends.com. **Outputs** - `content_type` (text): The file's type, like image/png or image/jpeg - `document_ref` (text): The stored file's reference - `documents` (list): The stored image, as a one-file list steps can attach - `file_size_bytes` (number): The file's size in bytes - `file_url` (text): Where the stored file can be opened - `filename` (text): The file's name, like Aatrox_0.jpg - `source_url` (text): The Data Dragon URL it was downloaded from **Example output** ```json { "content_type": "image/jpeg", "document_ref": "doc_data_dragon_monkeyking_0", "documents": [ { "content_type": "image/jpeg", "document_ref": "doc_data_dragon_monkeyking_0", "filename": "MonkeyKing_0.jpg", "size_bytes": 179144, "url": "/actions/core/serve-document/doc_data_dragon_monkeyking_0" } ], "file_size_bytes": 179144, "file_url": "/actions/core/serve-document/doc_data_dragon_monkeyking_0", "filename": "MonkeyKing_0.jpg", "source_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/MonkeyKing_0.jpg" } ``` ### Get a champion Get one champion in full by name, Data Dragon ID or the key match data uses: Wukong, MonkeyKing and 62 all find the same champion. Comes back with lore, tips, base stats, the passive and the Q, W, E and R abilities with their cooldowns and costs, and every skin with its splash and loading screen art. A champion Data Dragon doesn't have comes back with found false and names that look close. **Inputs** - Champion (`champion`, text, required): The champion's name, like Wukong; its Data Dragon ID, like MonkeyKing; or its key, the number the Riot Games API calls championId, like 62. Capitals, spaces and apostrophes don't matter, and an English name finds the champion in every language. - Language (`language`, text): Optional. The language names and text come back in. English (United States) when left empty. One of: `ar_AE` (Arabic (United Arab Emirates)), `zh_CN` (Chinese (China)), `zh_MY` (Chinese (Malaysia)), `zh_TW` (Chinese (Taiwan)), `cs_CZ` (Czech (Czech Republic)), `en_AU` (English (Australia)), `en_PH` (English (Republic of the Philippines)), `en_SG` (English (Singapore)), `en_GB` (English (United Kingdom)), `en_US` (English (United States)), and 18 more. Default: `en_US`. - Version (`version`, text): Optional. The Data Dragon version to read, like 16.19.1, or a patch like 16.19 for its newest build. The newest version when left empty. Give the version a region's client is on (from Get a region's version) to match what its players see. **Outputs** - `ally_tips` (list): Tips for playing the champion - `blurb` (text): The start of the champion's lore - `enemy_tips` (list): Tips for playing against it - `found` (true/false): True when Data Dragon has it. False when nothing matches, which is an answer rather than an error - `id` (text): Data Dragon's ID for the champion, which its files and images go by, like MonkeyKing for Wukong - `image_url` (text): The champion's square portrait (PNG) - `key` (number): The champion's number, which the Riot Games API calls championId in match and mastery data, like 62 for Wukong - `language` (text): The language the text is in, like en_US - `loading_url` (text): The loading screen art of its default skin (JPG) - `lore` (text): The champion's whole lore - `name` (text): The champion's name, like Wukong - `passive` (object): The champion's passive ability - `ratings` (object): Riot's ratings of the champion, each from 1 to 10 - `resource` (text): What its abilities cost, like Mana or Energy - `roles` (list): Its roles: Assassin, Fighter, Mage, Marksman, Support or Tank, in English in every language - `skins` (list): Its skins, without the chromas, which have no art - `spells` (list): Its abilities, in order: Q, W, E and R - `splash_url` (text): The splash art of its default skin (JPG) - `stats` (object): The champion's base stats and how they grow each level - `suggestions` (list): Names close to what was asked for, when nothing matched exactly. Empty otherwise - `title` (text): The champion's title, like the Monkey King - `version` (text): The Data Dragon version this was read from, like 16.19.1 **Example output** ```json { "ally_tips": [ "Decoy and Nimbus Strike work well together to quickly strike your enemy and get out before they can retaliate.", "Try using Decoy near brush to make an enemy overreact to your movement." ], "blurb": "Wukong is a vastayan trickster who uses his strength, agility, and intelligence to confuse his opponents and gain the upper hand. After finding a lifelong friend in the warrior known as Master Yi, Wukong became the last student of the ancient martial...", "enemy_tips": [ "Wukong will often use Decoy after Nimbus Strike. Try delaying your abilities by a short amount of time to ensure that you're hitting the real Wukong.", "Wukong becomes tougher to kill when surrounded by his enemies. Try to isolate him to gain an advantage." ], "found": true, "id": "MonkeyKing", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/champion/MonkeyKing.png", "key": 62, "language": "en_US", "loading_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/loading/MonkeyKing_0.jpg", "lore": "Wukong is a vastayan trickster who uses his strength, agility, and intelligence to confuse his opponents and gain the upper hand. After finding a lifelong friend in the warrior known as Master Yi, Wukong became the last student of the ancient martial art known as Wuju. Armed with an enchanted staff, Wukong seeks to prevent Ionia from falling to ruin.", "name": "Wukong", "passive": { "description": "Wukong gains stacking armor and max health regeneration while fighting champions and monsters.", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/passive/MonkeyKingStoneSkin.png", "name": "Stone Skin" }, "ratings": { "attack": 8, "defense": 5, "difficulty": 3, "magic": 2 }, "resource": "Mana", "roles": [ "Fighter", "Tank" ], "skins": [ { "chroma_count": 0, "id": 62000, "loading_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/loading/MonkeyKing_0.jpg", "name": "default", "number": 0, "splash_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/MonkeyKing_0.jpg" }, { "chroma_count": 0, "id": 62001, "loading_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/loading/MonkeyKing_1.jpg", "name": "Volcanic Wukong", "number": 1, "splash_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/MonkeyKing_1.jpg" }, { "chroma_count": 0, "id": 62002, "loading_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/loading/MonkeyKing_2.jpg", "name": "General Wukong", "number": 2, "splash_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/MonkeyKing_2.jpg" }, { "chroma_count": 1, "id": 62003, "loading_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/loading/MonkeyKing_3.jpg", "name": "Jade Dragon Wukong", "number": 3, "splash_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/MonkeyKing_3.jpg" }, { "chroma_count": 1, "id": 62004, "loading_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/loading/MonkeyKing_4.jpg", "name": "Underworld Wukong", "number": 4, "splash_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/MonkeyKing_4.jpg" }, { "chroma_count": 0, "id": 62005, "loading_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/loading/MonkeyKing_5.jpg", "name": "Radiant Wukong", "number": 5, "splash_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/MonkeyKing_5.jpg" }, { "chroma_count": 0, "id": 62006, "loading_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/loading/MonkeyKing_6.jpg", "name": "Lancer Stratus Wukong", "number": 6, "splash_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/MonkeyKing_6.jpg" }, { "chroma_count": 8, "id": 62007, "loading_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/loading/MonkeyKing_7.jpg", "name": "Battle Academia Wukong", "number": 7, "splash_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/MonkeyKing_7.jpg" }, { "chroma_count": 8, "id": 62016, "loading_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/loading/MonkeyKing_16.jpg", "name": "Elderwood Wukong", "number": 16, "splash_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/MonkeyKing_16.jpg" }, { "chroma_count": 8, "id": 62026, "loading_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/loading/MonkeyKing_26.jpg", "name": "Mecha Kingdoms Wukong", "number": 26, "splash_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/MonkeyKing_26.jpg" } ], "spells": [ { "cooldown": "8/7.5/7/6.5/6", "cooldowns": [ 8, 7.5, 7, 6.5, 6 ], "cost": "20 Mana", "costs": [ 20, 20, 20, 20, 20 ], "description": "Wukong's next attack gains attack range, deals bonus damage, and reduces the target's armor for a few seconds.", "id": "MonkeyKingDoubleAttack", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/spell/MonkeyKingDoubleAttack.png", "max_rank": 5, "name": "Crushing Blow", "range": "250/275/300/325/350", "slot": "Q" }, { "cooldown": "22/21/20/19/18", "cooldowns": [ 22, 21, 20, 19, 18 ], "cost": "60/55/50/45/40 Mana", "costs": [ 60, 55, 50, 45, 40 ], "description": "Wukong becomes Invisible and dashes in a direction, leaving behind a clone that will attack nearby enemies.", "id": "MonkeyKingDecoy", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/spell/MonkeyKingDecoy.png", "max_rank": 5, "name": "Warrior Trickster", "range": "275", "slot": "W" }, { "cooldown": "10/9.25/8.5/7.75/7", "cooldowns": [ 10, 9.25, 8.5, 7.75, 7 ], "cost": "30/35/40/45/50 Mana", "costs": [ 30, 35, 40, 45, 50 ], "description": "Wukong dashes to a targeted enemy and sends out images to attack enemies near his target, dealing damage to each enemy struck.", "id": "MonkeyKingNimbus", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/spell/MonkeyKingNimbus.png", "max_rank": 5, "name": "Nimbus Strike", "range": "650", "slot": "E" }, { "cooldown": "130/110/90", "cooldowns": [ 130, 110, 90 ], "cost": "100 Mana", "costs": [ 100, 100, 100 ], "description": "Wukong's extends his staff and spins it around repeatedly, gaining Move Speed.\n\nEnemies struck take damage and are knocked up.", "id": "MonkeyKingSpinToWin", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/spell/MonkeyKingSpinToWin.png", "max_rank": 3, "name": "Cyclone", "range": "315", "slot": "R" } ], "splash_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/MonkeyKing_0.jpg", "stats": { "armor": 31, "armor_per_level": 4.7, "attack_damage": 66, "attack_damage_per_level": 0, "attack_range": 175, "attack_speed": 0.69, "attack_speed_per_level": 3, "crit_chance": 0, "crit_chance_per_level": 0, "health": 610, "health_per_level": 99, "health_regen": 3.5, "health_regen_per_level": 0.65, "magic_resist": 28, "magic_resist_per_level": 2.05, "mana": 330, "mana_per_level": 65, "mana_regen": 8, "mana_regen_per_level": 0.8, "move_speed": 340 }, "suggestions": [], "title": "the Monkey King", "version": "16.19.1" } ``` ### Get a profile icon Get the image of a profile icon by its ID, like the one a summoner profile carries. Data Dragon is asked whether it has the icon, so one newer than the version read comes back with found false rather than as a broken link. **Inputs** - Profile icon ID (`profile_icon_id`, text, required): The icon's number, like the profile_icon_id Get a summoner returns in the Riot Games integration. - Version (`version`, text): Optional. The Data Dragon version to read, like 16.19.1, or a patch like 16.19 for its newest build. The newest version when left empty. Give the version a region's client is on (from Get a region's version) to match what its players see. **Outputs** - `found` (true/false): True when Data Dragon has the icon in this version. Icons released after the version asked for are not in it - `id` (number): The profile icon's ID - `image_url` (text): The icon (PNG). Empty when it wasn't found - `version` (text): The Data Dragon version this was read from, like 16.19.1 **Example output** ```json { "found": true, "id": 588, "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/profileicon/588.png", "version": "16.19.1" } ``` ### Get a queue Turn a queue ID from match data into the kind of game it was: 420 is 5v5 Ranked Solo games on Summoner's Rift and 450 is ARAM. Says when Riot has retired the queue and what replaced it. A queue Riot doesn't list comes back with found false. **Inputs** - Queue ID (`queue_id`, text, required): The queue's number, which match data carries as queueId, like 420. **Outputs** - `description` (text): The kind of game, like 5v5 Ranked Solo games. Empty for custom games - `found` (true/false): True when Data Dragon has it. False when nothing matches, which is an answer rather than an error - `is_deprecated` (true/false): True for a queue Riot has retired - `map` (text): The map it is played on, like Summoner's Rift - `notes` (text): Riot's note on the queue, like what replaced it - `queue_id` (number): The queue's ID, which match data carries as queueId **Example output** ```json { "description": "5v5 Ranked Solo games", "found": true, "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 420 } ``` ### Get a random champion Pick a champion at random, or up to 10 different ones, from every champion or from one role. Built for a champion of the day, a random pick to play, or a challenge for a stream. Each comes back with its title, roles, blurb and art. **Inputs** - Role (`role`, text): Optional. Only champions with this role. Every champion when left empty. One of: `Assassin`, `Fighter`, `Mage`, `Marksman`, `Support`, `Tank`. - How many (`count`, number): Optional. How many different champions to pick, up to 10. 1 when left empty. From 1 to 10. Default: `1`. - Language (`language`, text): Optional. The language names and text come back in. English (United States) when left empty. One of: `ar_AE` (Arabic (United Arab Emirates)), `zh_CN` (Chinese (China)), `zh_MY` (Chinese (Malaysia)), `zh_TW` (Chinese (Taiwan)), `cs_CZ` (Czech (Czech Republic)), `en_AU` (English (Australia)), `en_PH` (English (Republic of the Philippines)), `en_SG` (English (Singapore)), `en_GB` (English (United Kingdom)), `en_US` (English (United States)), and 18 more. Default: `en_US`. - Version (`version`, text): Optional. The Data Dragon version to read, like 16.19.1, or a patch like 16.19 for its newest build. The newest version when left empty. Give the version a region's client is on (from Get a region's version) to match what its players see. **Outputs** - `champion` (object): The champion picked (the first, when several were) - `champions` (list): Every champion picked, all different - `count` (number): How many came back - `found` (true/false): False when no champion has the role asked for - `language` (text): The language the text is in, like en_US - `pool_size` (number): How many champions it was picked from - `version` (text): The Data Dragon version this was read from, like 16.19.1 **Example output** ```json { "champion": { "blurb": "Luxanna Crownguard hails from Demacia, an insular realm where magical abilities are viewed with fear and suspicion. Able to bend light to her will, she grew up dreading discovery and exile, and was forced to keep her power secret, in order to preserve...", "id": "Lux", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/champion/Lux.png", "key": 99, "loading_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/loading/Lux_0.jpg", "name": "Lux", "ratings": { "attack": 2, "defense": 4, "difficulty": 5, "magic": 9 }, "resource": "Mana", "roles": [ "Mage", "Support" ], "splash_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/Lux_0.jpg", "title": "the Lady of Luminosity" }, "champions": [ { "blurb": "Luxanna Crownguard hails from Demacia, an insular realm where magical abilities are viewed with fear and suspicion. Able to bend light to her will, she grew up dreading discovery and exile, and was forced to keep her power secret, in order to preserve...", "id": "Lux", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/champion/Lux.png", "key": 99, "loading_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/loading/Lux_0.jpg", "name": "Lux", "ratings": { "attack": 2, "defense": 4, "difficulty": 5, "magic": 9 }, "resource": "Mana", "roles": [ "Mage", "Support" ], "splash_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/Lux_0.jpg", "title": "the Lady of Luminosity" } ], "count": 1, "found": true, "language": "en_US", "pool_size": 5, "version": "16.19.1" } ``` ### Get a region's version Get the version and default language a region's game client is on, like Europe West's or Korea's. A region can trail the newest version for a day or two after a patch, so reading data for its version shows what its players see. **Inputs** - Region (`region`, text, required): The region, like na or euw. The platform the Riot Games integration takes, like na1 or euw1, works too. One of: `na` (North America (na)), `euw` (Europe West (euw)), `eune` (Europe Nordic & East (eune)), `kr` (Korea (kr)), `jp` (Japan (jp)), `br` (Brazil (br)), `lan` (Latin America North (lan)), `las` (Latin America South (las)), `oce` (Oceania (oce)), `tr` (Türkiye (tr)), and 8 more. **Outputs** - `data_versions` (object): The version of each kind of data the region reads, usually all the same - `language` (text): The region's default language, like en_US or ko_KR - `name` (text): The region's name, like North America - `region` (text): The region's Data Dragon name, like na or euw - `version` (text): The Data Dragon version the region's game client is on, which can lag behind the newest for a day or two after a patch **Example output** ```json { "data_versions": { "champion": "16.19.1", "item": "16.19.1", "language": "16.19.1", "map": "16.19.1", "profile_icon": "16.19.1", "summoner_spell": "16.19.1" }, "language": "en_US", "name": "North America", "region": "na", "version": "16.19.1" } ``` ### Get a rune Get one rune by its name or the perk ID match data carries, like Electrocute or 8112, with its path, its row and what it does. A rune path's ID or name, like 8100 or Domination, comes back as the path. Stat shards aren't in Data Dragon, so their IDs (5001 and up) come back with found false. **Inputs** - Rune (`rune`, text, required): The rune's name, like Electrocute, or the perk ID match data carries, like 8112. A rune path's name or ID, like Domination or 8100, finds the path. - Language (`language`, text): Optional. The language names and text come back in. English (United States) when left empty. One of: `ar_AE` (Arabic (United Arab Emirates)), `zh_CN` (Chinese (China)), `zh_MY` (Chinese (Malaysia)), `zh_TW` (Chinese (Taiwan)), `cs_CZ` (Czech (Czech Republic)), `en_AU` (English (Australia)), `en_PH` (English (Republic of the Philippines)), `en_SG` (English (Singapore)), `en_GB` (English (United Kingdom)), `en_US` (English (United States)), and 18 more. Default: `en_US`. - Version (`version`, text): Optional. The Data Dragon version to read, like 16.19.1, or a patch like 16.19 for its newest build. The newest version when left empty. Give the version a region's client is on (from Get a region's version) to match what its players see. **Outputs** - `found` (true/false): True when Data Dragon has it. False when nothing matches, which is an answer rather than an error - `icon_url` (text): Its icon (PNG) - `id` (number): The rune's ID, which match data carries as a perk, like 8112 - `is_keystone` (true/false): True for a keystone, the path's main rune - `key` (text): Data Dragon's key for the rune, like Electrocute - `kind` (text): rune, or path when a whole rune path was asked for - `language` (text): The language the text is in, like en_US - `long_description` (text): What it does, with its numbers - `name` (text): The rune's name - `path` (text): The rune path it is in, like Domination - `path_id` (number): The rune path's ID, like 8100 - `short_description` (text): What it does, in a sentence - `slot` (number): Its row in the path: 0 for the keystones, then 1, 2 and 3 - `suggestions` (list): Names close to what was asked for, when nothing matched exactly. Empty otherwise - `version` (text): The Data Dragon version this was read from, like 16.19.1 **Example output** ```json { "found": true, "icon_url": "https://ddragon.leagueoflegends.com/cdn/img/perk-images/Styles/Domination/Electrocute/Electrocute.png", "id": 8112, "is_keystone": true, "key": "Electrocute", "kind": "rune", "language": "en_US", "long_description": "Hitting a champion with 3 separate attacks or abilities within 3s deals bonus adaptive damage.\n\nDamage: 70 - 240 (+0.1 bonus AD, +0.05 AP) damage.\nCooldown: 20s\n\n'We called them the Thunderlords, for to speak of their lightning was to invite disaster.'", "name": "Electrocute", "path": "Domination", "path_id": 8100, "short_description": "Hitting a champion with 3 separate attacks or abilities in 3s deals bonus adaptive damage.", "slot": 0, "suggestions": [], "version": "16.19.1" } ``` ### Get a summoner spell Get one summoner spell by the number match data carries, its ID or its name: 4, SummonerFlash and Flash all find Flash. Where a game mode has its own spell of the same name, like Arena's Flash, the one in the game mode chosen wins. A spell Data Dragon doesn't have comes back with found false. **Inputs** - Summoner spell (`summoner_spell`, text, required): The number match data carries as summoner1Id or summoner2Id, like 4; the spell's Data Dragon ID, like SummonerFlash; or its name, like Flash. - Game mode (`game_mode`, text): Optional. When several spells share the name asked for (Arena has its own Flash), the one this game mode offers wins. Summoner's Rift when left empty. One of: `CLASSIC` (Summoner's Rift (CLASSIC)), `ARAM`, `CHERRY` (Arena (CHERRY)), `SWIFTPLAY`, `URF` (Ultra Rapid Fire (URF)), `ARSR` (All Random Summoner's Rift (ARSR)), `ONEFORALL` (One for All), `NEXUSBLITZ` (Nexus Blitz), `ULTBOOK` (Ultimate Spellbook), `BRAWL`, and 3 more. Default: `CLASSIC`. - Language (`language`, text): Optional. The language names and text come back in. English (United States) when left empty. One of: `ar_AE` (Arabic (United Arab Emirates)), `zh_CN` (Chinese (China)), `zh_MY` (Chinese (Malaysia)), `zh_TW` (Chinese (Taiwan)), `cs_CZ` (Czech (Czech Republic)), `en_AU` (English (Australia)), `en_PH` (English (Republic of the Philippines)), `en_SG` (English (Singapore)), `en_GB` (English (United Kingdom)), `en_US` (English (United States)), and 18 more. Default: `en_US`. - Version (`version`, text): Optional. The Data Dragon version to read, like 16.19.1, or a patch like 16.19 for its newest build. The newest version when left empty. Give the version a region's client is on (from Get a region's version) to match what its players see. **Outputs** - `cooldown` (number): Its cooldown, in seconds - `description` (text): What it does - `found` (true/false): True when Data Dragon has it. False when nothing matches, which is an answer rather than an error - `game_modes` (list): The game modes that offer it, like CLASSIC (Summoner's Rift), ARAM or CHERRY (Arena) - `id` (text): Data Dragon's ID for the spell, like SummonerFlash - `image_url` (text): Its icon (PNG) - `key` (number): The spell's number, which match data carries as summoner1Id and summoner2Id, like 4 for Flash - `language` (text): The language the text is in, like en_US - `name` (text): The spell's name - `range` (number): Its range - `suggestions` (list): Names close to what was asked for, when nothing matched exactly. Empty otherwise - `summoner_level` (number): The account level it unlocks at - `version` (text): The Data Dragon version this was read from, like 16.19.1 **Example output** ```json { "cooldown": 300, "description": "Teleports you a short distance toward your cursor.", "found": true, "game_modes": [ "ARAM", "TUTORIAL", "KIWI", "ULTBOOK", "FIRSTBLOOD", "SWIFTPLAY", "CLASSIC", "PRACTICETOOL", "RUBY", "RUBY_TRIAL_1", "BRAWL", "WIPMODEWIP4", "URF", "SNOWURF", "KIWI_JADE", "RUBY_TRIAL_3", "ONEFORALL", "ARSR", "NEXUSBLITZ", "DOOMBOTSTEEMO", "RUBY_TRIAL_2" ], "id": "SummonerFlash", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/spell/SummonerFlash.png", "key": 4, "language": "en_US", "name": "Flash", "range": 425, "suggestions": [], "summoner_level": 7, "version": "16.19.1" } ``` ### Get an item Get one item in full by its ID from match data or its name: what it does, the stats it gives as the shop lists them, its price, and the items it builds from and into with their prices. An item Data Dragon doesn't have comes back with found false and names that look close. **Inputs** - Item (`item`, text, required): The item's ID, as match data carries it, like 3031, or its name, like Infinity Edge. Shop nicknames work too, like ie or bf. - Map (`map_id`, text): Optional. When a name matches an item on several maps (Arena and ARAM keep their own copies), which map's to return. Summoner's Rift when left empty. An ID always finds its own item. One of: `11` (Summoner's Rift), `12` (Howling Abyss (ARAM)), `30` (Rings of Wrath (Arena)), `any` (Every map). Default: `11`. - Language (`language`, text): Optional. The language names and text come back in. English (United States) when left empty. One of: `ar_AE` (Arabic (United Arab Emirates)), `zh_CN` (Chinese (China)), `zh_MY` (Chinese (Malaysia)), `zh_TW` (Chinese (Taiwan)), `cs_CZ` (Czech (Czech Republic)), `en_AU` (English (Australia)), `en_PH` (English (Republic of the Philippines)), `en_SG` (English (Singapore)), `en_GB` (English (United Kingdom)), `en_US` (English (United States)), and 18 more. Default: `en_US`. - Version (`version`, text): Optional. The Data Dragon version to read, like 16.19.1, or a patch like 16.19 for its newest build. The newest version when left empty. Give the version a region's client is on (from Get a region's version) to match what its players see. **Outputs** - `builds_from` (list): The items it is built from - `builds_into` (list): The items it builds into - `consumable` (true/false): True when it is used up, like a potion - `description` (text): What the item gives and does, as the shop describes it - `found` (true/false): True when Data Dragon has it. False when nothing matches, which is an answer rather than an error - `gold` (object): The item's price, in gold - `id` (number): The item's ID, which match data carries, like 3031 - `image_url` (text): Its icon (PNG) - `language` (text): The language the text is in, like en_US - `maps` (list): The IDs of the maps it is on: 11 is Summoner's Rift, 12 ARAM and 30 Arena - `name` (text): The item's name - `plaintext` (text): A line on what it is for, like Slightly increases Move Speed - `purchasable` (true/false): True when it can be bought in the shop - `required_champion` (text): The one champion who can buy it, like Gangplank. Empty for most items - `stacks` (number): How many fit in one inventory slot - `stats` (list): The stats it gives, as the shop lists them - `suggestions` (list): Names close to what was asked for, when nothing matched exactly. Empty otherwise - `tags` (list): The shop categories it is in, like Boots or CriticalStrike - `version` (text): The Data Dragon version this was read from, like 16.19.1 **Example output** ```json { "builds_from": [ { "id": 1038, "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/item/1038.png", "name": "B. F. Sword", "total_gold": 1300 }, { "id": 1037, "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/item/1037.png", "name": "Pickaxe", "total_gold": 875 }, { "id": 1018, "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/item/1018.png", "name": "Cloak of Agility", "total_gold": 600 } ], "builds_into": [], "consumable": false, "description": "75 Attack Damage\n25% Critical Strike Chance\n30% Critical Strike Damage", "found": true, "gold": { "base": 725, "sell": 2450, "total": 3500 }, "id": 3031, "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/item/3031.png", "language": "en_US", "maps": [ 11, 12, 453 ], "name": "Infinity Edge", "plaintext": "Massively enhances critical strikes", "purchasable": true, "required_champion": null, "stacks": 1, "stats": [ { "name": "Attack Damage", "value": "75" }, { "name": "Critical Strike Chance", "value": "25%" }, { "name": "Critical Strike Damage", "value": "30%" } ], "suggestions": [], "tags": [ "CriticalStrike", "Damage" ], "version": "16.19.1" } ``` ### Get the latest version Get the newest Data Dragon version, like 16.19.1, with its patch and the version before it. Pass it to the other actions to pin a workflow to one patch, or schedule a workflow to compare it with the last one seen and hear about a new patch the day Data Dragon publishes it. **Inputs**: None. **Outputs** - `cdn_url` (text): Where this version's files are, for building other URLs - `dragontail_url` (text): This version's complete download, every file and image in one archive (over a gigabyte) - `patch` (text): The patch it belongs to, like 16.19, as patch notes name it - `previous_version` (text): The version before it, like 16.18.1 - `version` (text): The newest Data Dragon version, like 16.19.1. Pass it to the other actions to pin a workflow to one patch **Example output** ```json { "cdn_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1", "dragontail_url": "https://ddragon.leagueoflegends.com/cdn/dragontail-16.19.1.tgz", "patch": "16.19", "previous_version": "16.18.1", "version": "16.19.1" } ``` ### List champions List League of Legends champions with their key, roles, resource, Riot's difficulty ratings and their portrait, splash and loading screen art. Filter by role or by text in the name or title, and sort by name or by difficulty. Every champion comes back unless a filter is set. **Inputs** - Role (`role`, text): Optional. Only champions with this role. Every champion when left empty. One of: `Assassin`, `Fighter`, `Mage`, `Marksman`, `Support`, `Tank`. - Name contains (`search`, text): Optional. Only champions whose name, ID or title contains this text, like jax or the Darkin. Capitals and spaces don't matter. - Sort by (`sort_by`, text): Optional. Name, or Riot's difficulty rating, easiest or hardest first. Name when left empty. One of: `name` (Name, A to Z), `easiest` (Easiest to play first), `hardest` (Hardest to play first). Default: `name`. - Maximum champions (`limit`, number): Optional. How many champions to return, up to 200, which is all of them. 200 when left empty. From 1 to 200. Default: `200`. - Start at (`offset`, number): Optional. How many to skip first, for the next page when has_more came back true. 0 when left empty. From 0 to 10000. Default: `0`. - Language (`language`, text): Optional. The language names and text come back in. English (United States) when left empty. One of: `ar_AE` (Arabic (United Arab Emirates)), `zh_CN` (Chinese (China)), `zh_MY` (Chinese (Malaysia)), `zh_TW` (Chinese (Taiwan)), `cs_CZ` (Czech (Czech Republic)), `en_AU` (English (Australia)), `en_PH` (English (Republic of the Philippines)), `en_SG` (English (Singapore)), `en_GB` (English (United Kingdom)), `en_US` (English (United States)), and 18 more. Default: `en_US`. - Version (`version`, text): Optional. The Data Dragon version to read, like 16.19.1, or a patch like 16.19 for its newest build. The newest version when left empty. Give the version a region's client is on (from Get a region's version) to match what its players see. **Outputs** - `champions` (list): The champions in this page - `count` (number): How many came back - `has_more` (true/false): True when there are more past this page; raise Start at to read them - `language` (text): The language the text is in, like en_US - `total_count` (number): How many match in all, before the page was cut - `version` (text): The Data Dragon version this was read from, like 16.19.1 **Example output** ```json { "champions": [ { "blurb": "Innately connected to the magic of the spirit realm, Ahri is a fox-like vastaya who can manipulate her prey's emotions and consume their essence\u2014receiving flashes of their memory and insight from each soul she consumes. Once a powerful yet wayward...", "id": "Ahri", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/champion/Ahri.png", "key": 103, "loading_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/loading/Ahri_0.jpg", "name": "Ahri", "ratings": { "attack": 3, "defense": 4, "difficulty": 5, "magic": 8 }, "resource": "Mana", "roles": [ "Mage", "Assassin" ], "splash_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/Ahri_0.jpg", "title": "the Nine-Tailed Fox" }, { "blurb": "Something has awoken in Runeterra. Something ancient. Something terrible. The ageless horror known as Fiddlesticks stalks the edges of mortal society, drawn to areas thick with paranoia where it feeds upon terrorized victims. Wielding a jagged scythe...", "id": "Fiddlesticks", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/champion/Fiddlesticks.png", "key": 9, "loading_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/loading/Fiddlesticks_0.jpg", "name": "Fiddlesticks", "ratings": { "attack": 2, "defense": 3, "difficulty": 9, "magic": 9 }, "resource": "Mana", "roles": [ "Mage", "Support" ], "splash_url": "https://ddragon.leagueoflegends.com/cdn/img/champion/splash/Fiddlesticks_0.jpg", "title": "the Ancient Fear" } ], "count": 2, "has_more": true, "language": "en_US", "total_count": 7, "version": "16.19.1" } ``` ### List items List the items in a map's shop with their price, summary, shop categories and icon. Summoner's Rift unless another map is chosen. Filter by category, like Boots or Ability power, or by name (shop nicknames like ie work too), and sort by name or price. **Inputs** - Map (`map_id`, text): Optional. Whose shop to read. Arena and ARAM keep their own copies of many items under other IDs. Summoner's Rift when left empty. One of: `11` (Summoner's Rift), `12` (Howling Abyss (ARAM)), `30` (Rings of Wrath (Arena)), `any` (Every map). Default: `11`. - Category (`tag`, text): Optional. Only items in this shop category. Every category when left empty. One of: `Boots`, `Damage` (Attack damage), `CriticalStrike` (Critical strike), `AttackSpeed` (Attack speed), `OnHit` (On-hit effects), `ArmorPenetration` (Armor penetration), `LifeSteal` (Life steal), `SpellVamp` (Omnivamp), `SpellDamage` (Ability power), `MagicPenetration` (Magic penetration), and 19 more. - Name contains (`search`, text): Optional. Only items whose name contains this text, or whose shop nickname it is, like ie for Infinity Edge. - Only items in the shop (`purchasable_only`, true/false): Optional. On by default, which leaves out what can't be bought, like Gangplank's upgrades and items a champion transforms into. Turn it off to list those too. Default: `true`. - Sort by (`sort_by`, text): Optional. Name, or price either way. Name when left empty. One of: `name` (Name, A to Z), `cheapest` (Cheapest first), `most_expensive` (Most expensive first). Default: `name`. - Maximum items (`limit`, number): Optional. How many items to return, up to 1,000. 100 when left empty. From 1 to 1000. Default: `100`. - Start at (`offset`, number): Optional. How many to skip first, for the next page when has_more came back true. 0 when left empty. From 0 to 10000. Default: `0`. - Language (`language`, text): Optional. The language names and text come back in. English (United States) when left empty. One of: `ar_AE` (Arabic (United Arab Emirates)), `zh_CN` (Chinese (China)), `zh_MY` (Chinese (Malaysia)), `zh_TW` (Chinese (Taiwan)), `cs_CZ` (Czech (Czech Republic)), `en_AU` (English (Australia)), `en_PH` (English (Republic of the Philippines)), `en_SG` (English (Singapore)), `en_GB` (English (United Kingdom)), `en_US` (English (United States)), and 18 more. Default: `en_US`. - Version (`version`, text): Optional. The Data Dragon version to read, like 16.19.1, or a patch like 16.19 for its newest build. The newest version when left empty. Give the version a region's client is on (from Get a region's version) to match what its players see. **Outputs** - `count` (number): How many came back - `has_more` (true/false): True when there are more past this page; raise Start at to read them - `items` (list): The items in this page - `language` (text): The language the text is in, like en_US - `total_count` (number): How many match in all, before the page was cut - `version` (text): The Data Dragon version this was read from, like 16.19.1 **Example output** ```json { "count": 2, "has_more": true, "items": [ { "gold": { "base": 300, "sell": 770, "total": 1100 }, "id": 3006, "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/item/3006.png", "maps": [ 11, 12, 453 ], "name": "Berserker's Greaves", "plaintext": "Enhances Move Speed and Attack Speed", "purchasable": true, "tags": [ "AttackSpeed", "Boots" ] }, { "gold": { "base": 300, "sell": 210, "total": 300 }, "id": 1001, "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/item/1001.png", "maps": [ 11, 12, 453 ], "name": "Boots", "plaintext": "Slightly increases Move Speed", "purchasable": true, "tags": [ "Boots" ] } ], "language": "en_US", "total_count": 3, "version": "16.19.1" } ``` ### List languages List every language Data Dragon publishes its text in, with the code the other actions take, like en_US, and its name. Read from Data Dragon's own list, so a language added later shows up here. **Inputs**: None. **Outputs** - `count` (number): How many came back - `languages` (list): The languages, by code **Example output** ```json { "count": 28, "languages": [ { "code": "ar_AE", "name": "Arabic (United Arab Emirates)" }, { "code": "cs_CZ", "name": "Czech (Czech Republic)" }, { "code": "de_DE", "name": "German (Germany)" }, { "code": "el_GR", "name": "Greek (Greece)" }, { "code": "en_AU", "name": "English (Australia)" }, { "code": "en_GB", "name": "English (United Kingdom)" }, { "code": "en_PH", "name": "English (Republic of the Philippines)" }, { "code": "en_SG", "name": "English (Singapore)" }, { "code": "en_US", "name": "English (United States)" }, { "code": "es_AR", "name": "Spanish (Argentina)" }, { "code": "es_ES", "name": "Spanish (Spain)" }, { "code": "es_MX", "name": "Spanish (Mexico)" }, { "code": "fr_FR", "name": "French (France)" }, { "code": "hu_HU", "name": "Hungarian (Hungary)" }, { "code": "id_ID", "name": "Indonesian (Indonesia)" }, { "code": "it_IT", "name": "Italian (Italy)" }, { "code": "ja_JP", "name": "Japanese (Japan)" }, { "code": "ko_KR", "name": "Korean (Korea)" }, { "code": "pl_PL", "name": "Polish (Poland)" }, { "code": "pt_BR", "name": "Portuguese (Brazil)" }, { "code": "ro_RO", "name": "Romanian (Romania)" }, { "code": "ru_RU", "name": "Russian (Russia)" }, { "code": "th_TH", "name": "Thai (Thailand)" }, { "code": "tr_TR", "name": "Turkish (Turkey)" }, { "code": "vi_VN", "name": "Vietnamese (Viet Nam)" }, { "code": "zh_CN", "name": "Chinese (China)" }, { "code": "zh_MY", "name": "Chinese (Malaysia)" }, { "code": "zh_TW", "name": "Chinese (Taiwan)" } ] } ``` ### List maps List every map ID match data can carry, from Summoner's Rift (11) and Howling Abyss (12) to retired event maps, with Riot's note on each and a minimap image for the maps Data Dragon still has. **Inputs** - Language (`language`, text): Optional. The language names and text come back in. English (United States) when left empty. One of: `ar_AE` (Arabic (United Arab Emirates)), `zh_CN` (Chinese (China)), `zh_MY` (Chinese (Malaysia)), `zh_TW` (Chinese (Taiwan)), `cs_CZ` (Czech (Czech Republic)), `en_AU` (English (Australia)), `en_PH` (English (Republic of the Philippines)), `en_SG` (English (Singapore)), `en_GB` (English (United Kingdom)), `en_US` (English (United States)), and 18 more. Default: `en_US`. - Version (`version`, text): Optional. The Data Dragon version to read, like 16.19.1, or a patch like 16.19 for its newest build. The newest version when left empty. Give the version a region's client is on (from Get a region's version) to match what its players see. **Outputs** - `count` (number): How many came back - `language` (text): The language the text is in, like en_US - `maps` (list): The maps, by ID - `version` (text): The Data Dragon version this was read from, like 16.19.1 **Example output** ```json { "count": 18, "language": "en_US", "maps": [ { "id": 1, "minimap_url": null, "name": "Summoner's Rift", "notes": "Original Summer variant" }, { "id": 2, "minimap_url": null, "name": "Summoner's Rift", "notes": "Original Autumn variant" }, { "id": 3, "minimap_url": null, "name": "The Proving Grounds", "notes": "Tutorial Map" }, { "id": 4, "minimap_url": null, "name": "Twisted Treeline", "notes": "Original Version" }, { "id": 8, "minimap_url": null, "name": "The Crystal Scar", "notes": "Dominion map" }, { "id": 10, "minimap_url": null, "name": "Twisted Treeline", "notes": "Last TT map" }, { "id": 11, "minimap_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/map/map11.png", "name": "Summoner's Rift", "notes": "Current Version" }, { "id": 12, "minimap_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/map/map12.png", "name": "Howling Abyss", "notes": "ARAM map" }, { "id": 14, "minimap_url": null, "name": "Butcher's Bridge", "notes": "Alternate ARAM map" }, { "id": 16, "minimap_url": null, "name": "Cosmic Ruins", "notes": "Dark Star: Singularity map" }, { "id": 18, "minimap_url": null, "name": "Valoran City Park", "notes": "Star Guardian Invasion map" }, { "id": 19, "minimap_url": null, "name": "Substructure 43", "notes": "PROJECT: Hunters map" }, { "id": 20, "minimap_url": null, "name": "Crash Site", "notes": "Odyssey: Extraction map" }, { "id": 21, "minimap_url": null, "name": "Nexus Blitz", "notes": "Nexus Blitz map" }, { "id": 22, "minimap_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/map/map22.png", "name": "Teamfight Tactics", "notes": "Teamfight Tactics map" }, { "id": 30, "minimap_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/map/map30.png", "name": "Arena", "notes": "Arena map" }, { "id": 35, "minimap_url": null, "name": "The Bandlewood", "notes": "Map for Brawl (`BRAWL`). Work together with your team to escort minions into the enemy portal. No roles, no lanes, no pressure. Just a five-on-five brawl." }, { "id": 453, "minimap_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/map/map453.png", "name": null, "notes": null } ], "version": "16.19.1" } ``` ### List queues List the queues match data can carry, with the map each is played on, the kind of game and Riot's notes. Retired queues are left out unless asked for. **Inputs** - Include retired queues (`include_deprecated`, true/false): Optional. Off by default, which lists the queues in use. Turn it on to also list the ones Riot has retired, which older match data still carries. Default: `false`. **Outputs** - `count` (number): How many came back - `queues` (list): The queues, by ID **Example output** ```json { "count": 63, "queues": [ { "description": null, "is_deprecated": false, "map": "Custom games", "notes": null, "queue_id": 0 }, { "description": "1v1 Snowdown Showdown games", "is_deprecated": false, "map": "Howling Abyss", "notes": null, "queue_id": 72 }, { "description": "2v2 Snowdown Showdown games", "is_deprecated": false, "map": "Howling Abyss", "notes": null, "queue_id": 73 }, { "description": "6v6 Hexakill games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 75 }, { "description": "Ultra Rapid Fire games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 76 }, { "description": "One For All: Mirror Mode games", "is_deprecated": false, "map": "Howling Abyss", "notes": null, "queue_id": 78 }, { "description": "Co-op vs AI Ultra Rapid Fire games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 83 }, { "description": "6v6 Hexakill games", "is_deprecated": false, "map": "Twisted Treeline", "notes": null, "queue_id": 98 }, { "description": "5v5 ARAM games", "is_deprecated": false, "map": "Butcher's Bridge", "notes": null, "queue_id": 100 }, { "description": "Nemesis games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 310 }, { "description": "Black Market Brawlers games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 313 }, { "description": "Definitely Not Dominion games", "is_deprecated": false, "map": "Crystal Scar", "notes": null, "queue_id": 317 }, { "description": "All Random games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 325 }, { "description": "5v5 Draft Pick games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 400 }, { "description": "5v5 Ranked Solo games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 420 }, { "description": "5v5 Blind Pick games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 430 }, { "description": "5v5 Ranked Flex games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 440 }, { "description": "5v5 ARAM games", "is_deprecated": false, "map": "Howling Abyss", "notes": null, "queue_id": 450 }, { "description": "Swiftplay Games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 480 }, { "description": "Normal (Quickplay)", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 490 }, { "description": "Blood Hunt Assassin games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 600 }, { "description": "Dark Star: Singularity games", "is_deprecated": false, "map": "Cosmic Ruins", "notes": null, "queue_id": 610 }, { "description": "Summoner's Rift Clash games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 700 }, { "description": "ARAM Clash games", "is_deprecated": false, "map": "Howling Abyss", "notes": null, "queue_id": 720 }, { "description": "Co-op vs. AI Beginner Bot games", "is_deprecated": false, "map": "Twisted Treeline", "notes": null, "queue_id": 820 }, { "description": "Co-op vs. AI Intro Bot games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 870 }, { "description": "Co-op vs. AI Beginner Bot games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 880 }, { "description": "Co-op vs. AI Intermediate Bot games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 890 }, { "description": "ARURF games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 900 }, { "description": "Ascension games", "is_deprecated": false, "map": "Crystal Scar", "notes": null, "queue_id": 910 }, { "description": "Legend of the Poro King games", "is_deprecated": false, "map": "Howling Abyss", "notes": null, "queue_id": 920 }, { "description": "Nexus Siege games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 940 }, { "description": "Doom Bots Voting games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 950 }, { "description": "Doom Bots Standard games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 960 }, { "description": "Star Guardian Invasion: Normal games", "is_deprecated": false, "map": "Valoran City Park", "notes": null, "queue_id": 980 }, { "description": "Star Guardian Invasion: Onslaught games", "is_deprecated": false, "map": "Valoran City Park", "notes": null, "queue_id": 990 }, { "description": "PROJECT: Hunters games", "is_deprecated": false, "map": "Overcharge", "notes": null, "queue_id": 1000 }, { "description": "Snow ARURF games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 1010 }, { "description": "One for All games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 1020 }, { "description": "Odyssey Extraction: Intro games", "is_deprecated": false, "map": "Crash Site", "notes": null, "queue_id": 1030 }, { "description": "Odyssey Extraction: Cadet games", "is_deprecated": false, "map": "Crash Site", "notes": null, "queue_id": 1040 }, { "description": "Odyssey Extraction: Crewmember games", "is_deprecated": false, "map": "Crash Site", "notes": null, "queue_id": 1050 }, { "description": "Odyssey Extraction: Captain games", "is_deprecated": false, "map": "Crash Site", "notes": null, "queue_id": 1060 }, { "description": "Odyssey Extraction: Onslaught games", "is_deprecated": false, "map": "Crash Site", "notes": null, "queue_id": 1070 }, { "description": "Teamfight Tactics games", "is_deprecated": false, "map": "Convergence", "notes": null, "queue_id": 1090 }, { "description": "Ranked Teamfight Tactics games", "is_deprecated": false, "map": "Convergence", "notes": null, "queue_id": 1100 }, { "description": "Teamfight Tactics Tutorial games", "is_deprecated": false, "map": "Convergence", "notes": null, "queue_id": 1110 }, { "description": "Teamfight Tactics test games", "is_deprecated": false, "map": "Convergence", "notes": null, "queue_id": 1111 }, { "description": "Teamfight Tactics Choncc's Treasure Mode", "is_deprecated": false, "map": "Convergence", "notes": null, "queue_id": 1210 }, { "description": "Nexus Blitz games", "is_deprecated": false, "map": "Nexus Blitz", "notes": null, "queue_id": 1300 }, { "description": "Ultimate Spellbook games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 1400 }, { "description": "Arena", "is_deprecated": false, "map": "Rings of Wrath", "notes": null, "queue_id": 1700 }, { "description": "Arena", "is_deprecated": false, "map": "Rings of Wrath", "notes": "16 player lobby", "queue_id": 1710 }, { "description": "Swarm Mode Games", "is_deprecated": false, "map": "Swarm", "notes": "Swarm Mode 1 player", "queue_id": 1810 }, { "description": "Swarm", "is_deprecated": false, "map": "Swarm Mode Games", "notes": "Swarm Mode 2 players", "queue_id": 1820 }, { "description": "Swarm", "is_deprecated": false, "map": "Swarm Mode Games", "notes": "Swarm Mode 3 players", "queue_id": 1830 }, { "description": "Swarm", "is_deprecated": false, "map": "Swarm Mode Games", "notes": "Swarm Mode 4 players", "queue_id": 1840 }, { "description": "Pick URF games", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 1900 }, { "description": "Tutorial 1", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 2000 }, { "description": "Tutorial 2", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 2010 }, { "description": "Tutorial 3", "is_deprecated": false, "map": "Summoner's Rift", "notes": null, "queue_id": 2020 }, { "description": "Brawl", "is_deprecated": false, "map": "The Bandlewood", "notes": null, "queue_id": 2300 }, { "description": "ARAM: Mayhem", "is_deprecated": false, "map": "Howling Abyss", "notes": null, "queue_id": 2400 } ] } ``` ### List runes List the runes of every rune path (Precision, Domination, Sorcery, Resolve and Inspiration), or of one, with their IDs, what they do and their icons. Each rune says its row and keystones are marked, so a step can list the keystones alone. **Inputs** - Rune path (`rune_path`, text): Optional. Only this path's runes. Every path when left empty. One of: `Precision`, `Domination`, `Sorcery`, `Resolve`, `Inspiration`. - Only keystones (`keystones_only`, true/false): Optional. Off by default. Turn it on for just the keystones, the main rune each path is built around. Default: `false`. - Language (`language`, text): Optional. The language names and text come back in. English (United States) when left empty. One of: `ar_AE` (Arabic (United Arab Emirates)), `zh_CN` (Chinese (China)), `zh_MY` (Chinese (Malaysia)), `zh_TW` (Chinese (Taiwan)), `cs_CZ` (Czech (Czech Republic)), `en_AU` (English (Australia)), `en_PH` (English (Republic of the Philippines)), `en_SG` (English (Singapore)), `en_GB` (English (United Kingdom)), `en_US` (English (United States)), and 18 more. Default: `en_US`. - Version (`version`, text): Optional. The Data Dragon version to read, like 16.19.1, or a patch like 16.19 for its newest build. The newest version when left empty. Give the version a region's client is on (from Get a region's version) to match what its players see. **Outputs** - `count` (number): How many came back - `language` (text): The language the text is in, like en_US - `paths` (list): The rune paths they come from - `runes` (list): The runes, path by path and row by row - `version` (text): The Data Dragon version this was read from, like 16.19.1 **Example output** ```json { "count": 3, "language": "en_US", "paths": [ { "icon_url": "https://ddragon.leagueoflegends.com/cdn/img/perk-images/Styles/7200_Domination.png", "id": 8100, "key": "Domination", "keystones": [ "Electrocute", "Dark Harvest", "Hail of Blades" ], "name": "Domination", "rune_count": 12 } ], "runes": [ { "icon_url": "https://ddragon.leagueoflegends.com/cdn/img/perk-images/Styles/Domination/Electrocute/Electrocute.png", "id": 8112, "is_keystone": true, "key": "Electrocute", "long_description": "Hitting a champion with 3 separate attacks or abilities within 3s deals bonus adaptive damage.\n\nDamage: 70 - 240 (+0.1 bonus AD, +0.05 AP) damage.\nCooldown: 20s\n\n'We called them the Thunderlords, for to speak of their lightning was to invite disaster.'", "name": "Electrocute", "path": "Domination", "path_id": 8100, "short_description": "Hitting a champion with 3 separate attacks or abilities in 3s deals bonus adaptive damage.", "slot": 0 }, { "icon_url": "https://ddragon.leagueoflegends.com/cdn/img/perk-images/Styles/Domination/DarkHarvest/DarkHarvest.png", "id": 8128, "is_keystone": true, "key": "DarkHarvest", "long_description": "Damaging a Champion below 50% health deals adaptive damage and harvests their soul, permanently increasing Dark Harvest's damage by 11.\n\nDark Harvest damage: 30 (+11 damage per soul) (+0.1 bonus AD) (+0.05 AP)\nCooldown: 35s (resets to 1.0s on takedown)", "name": "Dark Harvest", "path": "Domination", "path_id": 8100, "short_description": "Damaging a low health champion inflicts adaptive damage and harvests a soul from the victim.", "slot": 0 }, { "icon_url": "https://ddragon.leagueoflegends.com/cdn/img/perk-images/Styles/Domination/HailOfBlades/HailOfBlades.png", "id": 9923, "is_keystone": true, "key": "HailOfBlades", "long_description": "Gain 90% (60% for ranged champions) Attack Speed and bonus true damage when you attack an enemy champion for up to 3 attacks.\n\nNo more than 3s can elapse between attacks or this effect will end.\n\nCooldown: 10s.\nOn-Hit Damage: 2 - 20 (+0.12 bonus AD, +0.1 AP) damage.\n\nAttack resets increase the attack limit by 1.\nAllows you to temporarily exceed the Attack Speed limit.", "name": "Hail of Blades", "path": "Domination", "path_id": 8100, "short_description": "Gain a large amount of Attack Speed and bonus true damage for the first 3 attacks made against enemy champions.", "slot": 0 } ], "version": "16.19.1" } ``` ### List summoner spells List the summoner spells with the number match data carries for each (summoner1Id and summoner2Id), cooldown, range, the account level they unlock at and the game modes that offer them. Choose a game mode, like Summoner's Rift or ARAM, for its spells alone. **Inputs** - Game mode (`game_mode`, text): Optional. Only the spells this game mode offers. Every spell, in every mode, when left empty. One of: `CLASSIC` (Summoner's Rift (CLASSIC)), `ARAM`, `CHERRY` (Arena (CHERRY)), `SWIFTPLAY`, `URF` (Ultra Rapid Fire (URF)), `ARSR` (All Random Summoner's Rift (ARSR)), `ONEFORALL` (One for All), `NEXUSBLITZ` (Nexus Blitz), `ULTBOOK` (Ultimate Spellbook), `BRAWL`, and 3 more. - Language (`language`, text): Optional. The language names and text come back in. English (United States) when left empty. One of: `ar_AE` (Arabic (United Arab Emirates)), `zh_CN` (Chinese (China)), `zh_MY` (Chinese (Malaysia)), `zh_TW` (Chinese (Taiwan)), `cs_CZ` (Czech (Czech Republic)), `en_AU` (English (Australia)), `en_PH` (English (Republic of the Philippines)), `en_SG` (English (Singapore)), `en_GB` (English (United Kingdom)), `en_US` (English (United States)), and 18 more. Default: `en_US`. - Version (`version`, text): Optional. The Data Dragon version to read, like 16.19.1, or a patch like 16.19 for its newest build. The newest version when left empty. Give the version a region's client is on (from Get a region's version) to match what its players see. **Outputs** - `count` (number): How many came back - `language` (text): The language the text is in, like en_US - `summoner_spells` (list): The summoner spells, by name - `version` (text): The Data Dragon version this was read from, like 16.19.1 **Example output** ```json { "count": 9, "language": "en_US", "summoner_spells": [ { "cooldown": 180, "description": "Gain a brief Shield.", "game_modes": [ "ARAM", "TUTORIAL", "KIWI", "ULTBOOK", "FIRSTBLOOD", "SWIFTPLAY", "CLASSIC", "PRACTICETOOL", "RUBY", "RUBY_TRIAL_1", "BRAWL", "URF", "KIWI_JADE", "RUBY_TRIAL_3", "ONEFORALL", "ASSASSINATE", "ARSR", "NEXUSBLITZ", "DOOMBOTSTEEMO", "RUBY_TRIAL_2" ], "id": "SummonerBarrier", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/spell/SummonerBarrier.png", "key": 21, "name": "Barrier", "range": 1200, "summoner_level": 4 }, { "cooldown": 240, "description": "Removes all disables (excluding suppression and airborne) and summoner spell debuffs affecting your champion and gives Tenacity.", "game_modes": [ "ARAM", "TUTORIAL", "KIWI", "ULTBOOK", "FIRSTBLOOD", "SWIFTPLAY", "CLASSIC", "PRACTICETOOL", "RUBY", "RUBY_TRIAL_1", "BRAWL", "URF", "KIWI_JADE", "RUBY_TRIAL_3", "ONEFORALL", "ARSR", "NEXUSBLITZ", "DOOMBOTSTEEMO", "RUBY_TRIAL_2" ], "id": "SummonerBoost", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/spell/SummonerBoost.png", "key": 1, "name": "Cleanse", "range": 200, "summoner_level": 9 }, { "cooldown": 240, "description": "Slows target enemy champion and reduces their damage dealt.", "game_modes": [ "URF", "PRACTICETOOL", "CLASSIC", "ULTBOOK", "DOOMBOTSTEEMO", "ARAM", "RUBY_TRIAL_3", "NEXUSBLITZ", "SWIFTPLAY", "ONEFORALL", "TUTORIAL", "RUBY", "WIPMODEWIP", "RUBY_TRIAL_2", "WIPMODEWIP3", "RUBY_TRIAL_1", "ARSR" ], "id": "SummonerExhaust", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/spell/SummonerExhaust.png", "key": 3, "name": "Exhaust", "range": 650, "summoner_level": 4 }, { "cooldown": 300, "description": "Teleports you a short distance toward your cursor.", "game_modes": [ "ARAM", "TUTORIAL", "KIWI", "ULTBOOK", "FIRSTBLOOD", "SWIFTPLAY", "CLASSIC", "PRACTICETOOL", "RUBY", "RUBY_TRIAL_1", "BRAWL", "WIPMODEWIP4", "URF", "SNOWURF", "KIWI_JADE", "RUBY_TRIAL_3", "ONEFORALL", "ARSR", "NEXUSBLITZ", "DOOMBOTSTEEMO", "RUBY_TRIAL_2" ], "id": "SummonerFlash", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/spell/SummonerFlash.png", "key": 4, "name": "Flash", "range": 425, "summoner_level": 7 }, { "cooldown": 240, "description": "Gain Move Speed and ignore unit collision for the duration.", "game_modes": [ "ARAM", "TUTORIAL_MODULE_1", "TUTORIAL", "KIWI", "ULTBOOK", "FIRSTBLOOD", "SWIFTPLAY", "CLASSIC", "PRACTICETOOL", "RUBY", "RUBY_TRIAL_1", "BRAWL", "URF", "KIWI_JADE", "RUBY_TRIAL_3", "TUTORIAL_MODULE_2", "ONEFORALL", "ASSASSINATE", "ARSR", "NEXUSBLITZ", "DOOMBOTSTEEMO", "RUBY_TRIAL_2" ], "id": "SummonerHaste", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/spell/SummonerHaste.png", "key": 6, "name": "Ghost", "range": 200, "summoner_level": 1 }, { "cooldown": 240, "description": "Restores Health and grants Move Speed to you and target allied champion.", "game_modes": [ "ARAM", "TUTORIAL_MODULE_1", "TUTORIAL", "KIWI", "ULTBOOK", "SWIFTPLAY", "CLASSIC", "PRACTICETOOL", "RUBY", "RUBY_TRIAL_1", "BRAWL", "URF", "KIWI_JADE", "RUBY_TRIAL_3", "TUTORIAL_MODULE_2", "ONEFORALL", "ASSASSINATE", "ARSR", "NEXUSBLITZ", "DOOMBOTSTEEMO", "RUBY_TRIAL_2" ], "id": "SummonerHeal", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/spell/SummonerHeal.png", "key": 7, "name": "Heal", "range": 875, "summoner_level": 1 }, { "cooldown": 180, "description": "Deals true damage over time to target enemy champion and reduces healing effects on them for the duration.", "game_modes": [ "ARAM", "TUTORIAL", "KIWI", "ULTBOOK", "FIRSTBLOOD", "SWIFTPLAY", "CLASSIC", "PRACTICETOOL", "RUBY", "RUBY_TRIAL_1", "BRAWL", "URF", "KIWI_JADE", "RUBY_TRIAL_3", "ONEFORALL", "ASSASSINATE", "ARSR", "NEXUSBLITZ", "DOOMBOTSTEEMO", "RUBY_TRIAL_2" ], "id": "SummonerDot", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/spell/SummonerDot.png", "key": 14, "name": "Ignite", "range": 600, "summoner_level": 9 }, { "cooldown": 15, "description": "Deals true damage to a monster or minion.", "game_modes": [ "DOOMBOTSTEEMO", "PRACTICETOOL", "CLASSIC", "SWIFTPLAY", "URF", "NEXUSBLITZ", "ONEFORALL", "TUTORIAL", "ARSR" ], "id": "SummonerSmite", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/spell/SummonerSmite.png", "key": 11, "name": "Smite", "range": 500, "summoner_level": 3 }, { "cooldown": 300, "description": "After a brief channel, become untargetable and travel to an allied unit. Upgrades into Unleashed Teleport, which significantly increases travel speed.", "game_modes": [ "CLASSIC", "SWIFTPLAY", "ULTBOOK", "WIPMODEWIP4", "DOOMBOTSTEEMO", "PRACTICETOOL", "ONEFORALL", "RUBY", "ARSR", "RUBY_TRIAL_2", "TUTORIAL", "ASSASSINATE", "RUBY_TRIAL_3", "RUBY_TRIAL_1" ], "id": "SummonerTeleport", "image_url": "https://ddragon.leagueoflegends.com/cdn/16.19.1/img/spell/SummonerTeleport.png", "key": 12, "name": "Teleport", "range": 25000, "summoner_level": 7 } ], "version": "16.19.1" } ``` ### List versions List the published Data Dragon versions, newest first, back to 2012. Give a version to list only the ones released after it, which is how a scheduled workflow catches every patch it missed. **Inputs** - Newer than (`newer_than`, text): Optional. Only the versions released after this one, like 16.17.1, or after this patch, like 16.17. Every version when left empty. - One version per patch (`latest_build_per_patch`, true/false): Optional. On by default, which keeps only each patch's newest build, the one Riot advises using. Turn it off to list every build. Default: `true`. - Maximum versions (`limit`, number): Optional. How many versions to return, up to 500. 20 when left empty. From 1 to 500. Default: `20`. **Outputs** - `count` (number): How many came back - `latest` (text): The newest version, like 16.19.1 - `total_count` (number): How many match in all, before the page was cut - `versions` (list): The versions, newest first **Example output** ```json { "count": 3, "latest": "16.19.1", "total_count": 316, "versions": [ { "patch": "16.19", "version": "16.19.1" }, { "patch": "16.18", "version": "16.18.1" }, { "patch": "16.17", "version": "16.17.1" } ] } ```