op.gg APIop.gg ↗
Fetch LoL summoner profiles, match history, champion stats, mastery, and leaderboards from OP.GG via 8 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/a11058bd-d7ba-443d-b6b0-d28a13c48742/search_summoner?query=Faker®ion=kr' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for summoners by name and region. Returns matching summoner profiles with basic info like game name, tagline, rank, and thumbnail.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (summoner name or partial name) |
| region | string | Region code: na, kr, euw, eune, jp, oce, br, lan, las |
{
"type": "object",
"fields": {
"summoners": "array of summoner objects with gameName, tagline, href, ranked, thumbnail, and teamInfo fields"
},
"sample": {
"data": {
"summoners": [
{
"href": "/lol/summoners/kr/Faker-KR1",
"ranked": {
"lp": 1200,
"tierIcon": "challenger"
},
"tagline": "KR1",
"gameName": "Faker",
"thumbnail": "https://opgg-static.akamaized.net/meta/images/profile_icons/profileIcon6672.jpg"
}
]
},
"status": "success"
}
}About the op.gg API
The OP.GG API exposes 8 endpoints covering League of Legends summoner data, from ranked stats and match history to champion mastery and regional leaderboards. The get_summoner_match_history endpoint returns up to 20 recent matches per request with per-game fields including champion, KDA, items, runes, team compositions, and OP score. Every endpoint accepts a region parameter to target any of the major LoL regions including na, kr, euw, and more.
Summoner Lookup and Profiles
The search_summoner endpoint accepts a query string and optional region code and returns an array of matching summoner objects, each containing gameName, tagline, href, ranked, thumbnail, and teamInfo. To load a full profile, pass name, tag, and region to get_summoner_profile, which returns the summoner's level, puuid, rank_summary, win_loss_summary, and a champions_summary string listing top champions with win rates. get_summoner_ranked_stats returns the same shape and is useful when you want only ranked-specific context without pulling full match history.
Match History and Champion Statistics
get_summoner_match_history accepts name, tag, region, an optional champion filter, a game_type filter (TOTAL, SOLORANKED, FLEXRANKED, NORMAL, ARAM), and an ended_at ISO timestamp cursor for paginating to older games. Each match object includes id, created_at, game_length, game_result, game_type, champion, position, and a stats block with KDA, CS, and OP score. get_summoner_champion_stats returns season-level aggregates per champion — play count, win_rate, and a kda object — but only for ranked games in the current season; summoners without current-season ranked play return an empty array.
Mastery and Leaderboards
get_summoner_mastery returns per-champion mastery data: champion_id, champion_name, champion_image_url, level, points, tokens_earned, milestone_grades, and a last-played timestamp. get_leaderboard scopes to tier values of challenger, grandmaster, or master and a region, returning a count integer and a summoners array with name and tag per entry. Use get_summoner_season_history to discover which season IDs a summoner has historical data for before querying older records.
- Build a summoner lookup tool that surfaces rank, level, and top champions from
get_summoner_profile - Track a player's win rate across champions using
get_summoner_champion_statsaggregates - Display recent game performance with champion, KDA, and OP score via
get_summoner_match_history - Filter match history by queue type (ARAM, SOLORANKED) to analyze performance per game mode
- Generate regional Challenger/Grandmaster leaderboards using
get_leaderboardwith a region and tier input - Show a player's champion mastery levels and points using
get_summoner_mastery - Paginate a summoner's full game history using the
ended_atcursor parameter
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does OP.GG have an official developer API?+
What does `get_summoner_match_history` return and how do I page through older games?+
created_at value from the last match in the current response and pass it as the ended_at parameter on your next request. You can also filter by champion name or game_type (SOLORANKED, ARAM, FLEXRANKED, NORMAL, TOTAL) to narrow results.Does `get_summoner_champion_stats` cover all game modes?+
Is TFT (Teamfight Tactics) data available through this API?+
What regions are supported, and is there anything to know about the `region` parameter?+
region parameter accepts codes such as na, kr, euw, eune, jp, oce, br, lan, and las across all summoner and leaderboard endpoints. The parameter is optional on most endpoints; omitting it may default to a global or unspecified region depending on the summoner's profile. For leaderboard queries, specifying both tier and region produces the most precise results.