{"openapi":"3.1.0","info":{"title":"ggez.gg Public API","version":"1.0.0","description":"Read-only League of Legends data. Cheap, cached endpoints only. For full live summoner data use the MCP server at https://ggez.gg/mcp. All endpoints are rate-limited per IP.","contact":{"url":"https://ggez.gg"}},"servers":[{"url":"https://ggez.gg"}],"paths":{"/api/summoners/search":{"get":{"operationId":"searchSummoners","summary":"Search players (summoners) by name","description":"Returns matching Riot IDs with region and level from the indexed player database. Cached at the edge.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2},"description":"Name or partial name, optionally \"Name#TAG\"."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":8,"maximum":8}}],"x-ratelimit":"120/min/IP (edge-cached)","responses":{"200":{"description":"Matching summoners","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"game_name":{"type":"string"},"tag_line":{"type":"string"},"region":{"type":"string"},"summoner_level":{"type":"integer"},"profile_icon_id":{"type":"integer"}}}}}}}}},"429":{"description":"Rate limit exceeded"}}}},"/api/tier-list":{"get":{"operationId":"getTierList","summary":"Champion tier list (meta snapshot)","description":"Win/pick/ban rate and tier (S/A/B/C/D) per champion. Local data, no external cost, hard edge-cached.","parameters":[{"name":"tier","in":"query","required":false,"schema":{"type":"string","enum":["S","A","B","C","D"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":170,"maximum":170}}],"x-ratelimit":"120/min/IP (edge-cached)","responses":{"200":{"description":"Tier list","content":{"application/json":{"schema":{"type":"object","properties":{"patch":{"type":"string"},"sample":{"type":"string"},"count":{"type":"integer"},"champions":{"type":"array","items":{"type":"object","properties":{"champion":{"type":"string"},"tier":{"type":"string"},"winRate":{"type":"number"},"pickRate":{"type":"number"},"banRate":{"type":"number"},"games":{"type":["integer","null"]}}}}}}}}},"429":{"description":"Rate limit exceeded"}}}}},"x-mcp":{"description":"For live summoner profiles and richer tools, connect the MCP server.","endpoint":"https://ggez.gg/mcp","transport":"streamable-http","tools":["search_summoner","get_summoner_profile","get_tier_list","get_champion_meta","get_champion_build","get_leaderboard","get_pro_player","get_live_game"]}}