Riot Games API

Games & Comics / API Key Intermediate HTTPS
Varies by plan (check documentation)

Overview

The Riot Games API gives developers access to League of Legends player data, match history, champion stats, and ranked information. You need a developer API key from the Riot Developer Portal, and free development keys have a strict rate limit of 20 requests per second. It is best suited for building stat trackers, match history viewers, or LoL companion apps.

💡

Beginner Tip

Development API keys expire every 24 hours and are rate-limited. For a public app, apply for a production key from the Riot Developer Portal to get higher and stable limits.

Available Data

match scores and results
team standings
player statistics
schedule and fixtures

Example Response

JSON Response
{
  "match_id": 4521,
  "home_team": "Team A",
  "away_team": "Team B",
  "score": {
    "home": 2,
    "away": 1
  },
  "status": "Full Time",
  "date": "2025-01-15",
  "league": "Premier League"
}

Field Reference

id Encrypted summoner ID used for other API calls
accountId Encrypted account ID unique to the summoner
puuid Encrypted PUUID (Player Universally Unique ID) used across Riot games
name Display name of the summoner
summonerLevel Current level of the summoner account

Implementation Example

const url = "https://developer.riotgames.com/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

403 Forbidden API key has expired — development keys expire every 24 hours
Regenerate your development key at developer.riotgames.com or apply for a production key
429 Rate Limit Exceeded Exceeded 20 requests per second or 100 requests per 2 minutes for dev keys
Add delays between requests and implement exponential backoff when you receive 429 responses
404 Not Found for summoner Summoner name not found in that region
Make sure you are querying the correct regional endpoint (na1, euw1, kr, etc.) matching the player region

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 5/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category Games & Comics
Difficulty Intermediate
Verified: 2026-04-04

Similar APIs

View All →