TL;DR
Data Dragon is Riot Games' official static data distribution system for League of Legends. It provides CDN-hosted JSON files containing all champion stats, item descriptions, rune data, summoner spells, and profile icons, plus the actual image assets (splash art, champion portraits, item icons). Data is versioned by patch number and available in multiple languages. No API key is needed — everything is served as static files from a CDN.
Quick start: https://ddragon.leagueoflegends.com/cdn/14.3.1/data/en_US/champion.json
No API key needed — just make a request!
How to Use This API
1. List All Champions
https://ddragon.leagueoflegends.com/cdn/14.3.1/data/en_US/champion.json
Returns every champion with ID, name, title, blurb, tags (roles), stats, and image info.
2. Get Specific Champion — Ahri
https://ddragon.leagueoflegends.com/cdn/14.3.1/data/en_US/champion/Ahri.json
3. Get All Items
https://ddragon.leagueoflegends.com/cdn/14.3.1/data/en_US/item.json
4. Champion Splash Art URL Pattern
https://ddragon.leagueoflegends.com/cdn/img/champion/splash/Ahri_0.jpg
5. JavaScript — Find Mage Champions
fetch('https://ddragon.leagueoflegends.com/cdn/14.3.1/data/en_US/champion.json')
.then(r => r.json())
.then(data => {
const champs = Object.values(data.data);
const mages = champs.filter(c => c.tags.includes('Mage'));
mages.forEach(c => console.log(`${c.name} — ${c.title}`));
});
6. Python — Compare Stats
import requests
data = requests.get(
'https://ddragon.leagueoflegends.com/cdn/14.3.1/data/en_US/champion.json'
).json()
champs = data['data'].values()
top_hp = sorted(champs, key=lambda c: c['stats']['hp'], reverse=True)[:5]
for c in top_hp:
print(f"{c['name']}: {c['stats']['hp']} HP")
https://ddragon.leagueoflegends.com/cdn/14.3.1/data/en_US/champion.json
Frequently Asked Questions
- How do I find the latest version?
- Check
https://ddragon.leagueoflegends.com/api/versions.json— this returns an array of available CDN versions, with the first entry being the latest. - What languages are supported?
- Data is available in many languages: en_US, de_DE, es_ES, fr_FR, it_IT, ja_JP, ko_KR, pl_PL, pt_BR, ru_RU, zh_CN, zh_TW, and more. Replace en_US in the URL path.
- What data categories exist?
- Per version:
champion.json,item.json,summoner.json,rune.json,profileicon.json,map.json, andlanguage.json. - How do I access champion images?
- Champion loading screen:
/cdn/img/champion/loading/{name}_0.jpg, splash art:/cdn/img/champion/splash/{name}_0.jpg, and icon:/cdn/{version}/img/champion/{name}.png. - How often does Data Dragon update?
- Data Dragon is updated with each League of Legends patch (roughly every two weeks). The version number corresponds to the patch number (e.g., 14.3.1).
- What format does the data use?
- All data is in JSON format. The champion data includes stats, spells, passive, skins, and recommended item builds for ARAM and classic modes.
API Details
- API URL
https://ddragon.leagueoflegends.com/cdn- Documentation
- developer.riotgames.com/docs/lol
- Category
- Entertainment
- Authentication
- Not Required
- Geographic Coverage
- Global
What You Can Build
- Champion guide browser with stats, spells, and recommended builds
- Team composition analyzer showing role tags and synergy
- Item build path visualizer for different champion matchups
- Patch notes companion that highlights stat changes between versions
- LoL wiki or database site with splash art and ability descriptions