Fetching only parsed ranked games

[batukav]

Hi all,

I was wondering if there's a simple way to fetch the parsed ranked games, similar to the parsedMatches endpoint.

My current solution is to use GET /parsedMatches to get last parsed 100 game ids, use GET /matches/{match_id} to get the games by id, and then filter out by the game mode. However, after the filtering I generally end up with only a few ranked games and this feels like a wasteful way to find data only for the ranked games.

Cheers

[howardchung]

We don't currently support filters on the parsed match list unfortunately

[batukav]

Thanks for the quick reply. I could work on a pull request that does this, would you be open to that?

…

On 3. Feb 2025, at 22:37, Howard Chung ***@***.***> wrote: We don't currently support filters on the parsed match list unfortunately — Reply to this email directly, view it on GitHub <#2840 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AB47SNKNM3V7RBUGHGTB6WD2N7OQDAVCNFSM6AAAAABWNCXQHWVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDMMZSGEZTANBTGM>. You are receiving this because you authored the thread.

[howardchung]

Yes, happy to discuss potential implementations! Quick possiblity would probably be a new column in parsed_matches that has the game_mode and then insert the game_mode when we populate the field + add a query param to filter on game mode.

An alternative would be to gather your list of ranked match IDs separately and then request parses for those matches.

[batukav]

Great! I had something similar to your first suggestion in mind. You can assign this issue to me, if you want. I should have time in the upcoming days to create the pull request.

An alternative would be to gather your list of ranked match IDs separately and then request parses for those matches.

That'd work but how do I get the ranked match IDs separately using the API? I'm interested in analysing at least a few thousand games so manually creating a list out of option for me.

[howardchung]

The publicMatches endpoint does have a rank filter so you could probably use that

[howardchung]

Correction to my above comment--this just filters on the average rank of the match, but not whether it was a ranked game or not (this is based on the game's lobby_type). We store that field but don't have an index on it so it's not currently filterable.