lolexport

Exports League of Legends Match History metadata using the RiotGames API

I don't play league of legends that often anymore, this is to export my entire match history so I can do some analysis as part of HPI. Like:

>>> from my.games.league import history
>>> import pprint, collections
>>> league_game_history = list(history())
# whats my winrate?
>>> collections.Counter(map(lambda g: g.won, league_game_history))
Counter({True: 265, False: 241})
# most common champions?
>>> pprint.pprint(collections.Counter(map(lambda g: g.champion_name, league_game_history)).most_common(10))
[('Lee Sin', 114),
 ('Yasuo', 29),
 ('Master Yi', 25),
 ('Riven', 20),
 ('Gragas', 19),
 ('Thresh', 13),
 ('Lux', 12),
 ('Twisted Fate', 12),
 ('Rengar', 11),
 ('Bard', 11)]

Though, more interesting to me is that this tells me when/how long every match was, which means I can graph my activity.

I'm not sure how far back the match history goes. I've been playing on and off since 2015 but the history only goes back to 2018. May be a ~2/3 year limit, or that might just be when this API Version was supported/standardized.

Get an API key from here and put it in a JSON file, with the same format as ./api_key_example.json

Combines the results from https://developer.riotgames.com/apis#match-v4/GET_getMatchlist and https://developer.riotgames.com/apis#match-v4/GET_getMatch, and dumps all the info to a JSON file.

Installation

Requires at least python3.6

To install with pip, run:

pip install lolexport

This is accessible as lolexport and using python3 -m lolexport

Usage

Theres 2 commands here, export (which does the majority of the work, exporting info from your matches to a JSON file) and then parse which takes that as input and extracts (what I consider to be) useful data from it.

Export

python3 -m lolexport export --help
Usage: lolexport export [OPTIONS]

  Download all of your match history

Options:
  -t, --to PATH            JSON file to dump export to  [required]
  -k, --api-key-file PATH  json file with api key  [required]
  -u, --username TEXT      league of legends summoner name  [required]
  -r, --region TEXT        league of legends region name  [required]
  --help                   Show this message and exit.

$ python3 -m lolexport --to data.json --api-key-file ./api_key_example.json --username yourSummonnerName --region na1
[D 200901 21:27:41 export:32] Getting encrypted account id...
[D 200901 21:27:43 export:17] Got 100 matches from offset 100...
[D 200901 21:27:44 export:17] Got 100 matches from offset 200...
[D 200901 21:27:46 export:17] Got 100 matches from offset 300...
[D 200901 21:27:47 export:17] Got 100 matches from offset 400...
[D 200901 21:27:49 export:17] Got 100 matches from offset 500...
[D 200901 21:27:54 export:17] Got 6 matches from offset 600...
[D 200901 21:27:55 export:17] Got 0 matches from offset 700...
[D 200901 21:27:56 export:42] [1/506] Requesting match_id => 3517403685
[D 200901 21:27:57 export:42] [2/506] Requesting match_id => 3517420654
[D 200901 21:27:58 export:42] [3/506] Requesting match_id => 3517369763
[D 200901 21:28:00 export:42] [4/506] Requesting match_id => 3517356497
......
$ head -c 1000 data.json
[{"platformId": "NA1", "gameId": 3517403685, "champion": 33, "queue": 1300, "season": 13, "timestamp": 1596305310886, "role": "DUO_SUPPORT", "lane": "NONE", "matchData": {"gameId": 3517403685, "platformId": "NA1", "gameCreation": 1596305310886, "gameDuration": 1026, "queueId": 1300, "mapId": 21, "seasonId": 13, "gameVersion": "10.15.330.344", "gameMode": "NEXUSBLITZ", "gameType": "MATCHED_GAME", "teams": [{"teamId": 100, "win": "Win", "firstBlood": false, "firstTower": true, "firstInhibitor": true, "firstBaron": false, "firstDragon": false, "firstRiftHerald": true, "towerKills": 3, "inhibitorKills": 1, "baronKills": 0, "dragonKills": 0, "vilemawKills": 0, "riftHeraldKills": 1, "dominionVictoryScore": 0, "bans": [{"championId": 157, "pickTurn": 1}, {"championId": 350, "pickTurn": 2}, {"championId": 64, "pickTurn": 3}, {"championId": 7, "pickTurn": 4}, {"championId": 875, "pickTurn": 5}]}, {"teamId": 200, "win": "Fail", "firstBlood": true, "firstTower": false, "firstInhibitor": false, "f
$ du -h data.json
16M	data.json

See here for region codes.

Parsing

The export above saves all the data, but I'm not interested in tons of the specifics, so lolexport.parse is what I'd use, you're free to parse the data however.

python3 -m lolexport parse --help
Usage: lolexport parse [OPTIONS]

  Parses the exported data to attach additional metadata

  Prints results to STDOUT

Options:
  -f, --from PATH  exported JSON file to process  [required]
  --help           Show this message and exit.

It prints the parsed data to STDOUT, so you can do:

python3 -m lolexport parse --from ./data.json > parsed.json

That removes some of the fields I'm not interested in, and replaces champion/map/queue IDs with their names.