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

Request
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

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

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

Related Tags

Similar APIs

View All →