[FEATURE-REQUEST] Fetch VALORANT Ranked Rating by RSO linked PUUID

[aidenwallis]

Problem Description

I maintain a large community chatbot used by many VALORANT Twitch creators, and one common command they use (through our "customapi" functionality, allowing them to pull data from bespoke HTTP GET requests from other sources) is a command to return their ranked rating on VALORANT. This is, as far as I know, not possible for all users when using the official API.

I have for some time kept a cache of the VALORANT leaderboards in each region to satisfy the RSO linked user story of "what is my ranked rating/rank". However, given that not all users are on ranked leaderboards, this solution does not cover everyone.

I would love for an official, supported method for obtaining a users' ranked rating by an RSO connected users' PUUID. Doing so provides 3 benefits:

1. I do not need to iterate through the entire leaderboard to find a subset of my users' RR. This exposes me to far more user data than I'd ideally like to consume, including for users that I do not have an existing authorization with (though, I do not cache these users).
2. It provides coverage for all users on third party surfaces using official sources, even those not on the VALORANT leaderboard.
3. It negates the need for users to resort to unsupported solutions for obtaining the same data, better safeguarding user data and bringing what appears to be a common query pattern into the official VALORANT developer ecosystem.

Developer Impact

• Frequency: I have received at least 1-2 feature requests for this daily for the past week, whether it be directly, through support emails, through Discord servers, etc.
• Severity: I receive feature requests when users are unable to pull their ranked rating based on my docs, as they are not appearing on the VALORANT leaderboard, thus we cannot pull their RR using the official API.
• Cost: Requires me to run an extra background ticker to refresh my leaderboard cache every 10 minutes in my worker scheduling service.
• Efficiency: Requires me to iterate over every leaderboard in every region, just to cache ranked ratings for a subset of my users, which is horribly inefficient.
• User emails: I get frequent contacts from users asking me about this issue.

Player Impact

• Frequency: A subset of Twitch creators (ie, those who are not on the ranked leaderboards) are unable to show their Ranked Rating in chat through any official, "supported by Riot" method.
• Severity: When this bug happens, users are unable to receive their ranked rating through chat, and often result to using "unofficial" methods, which is bad for VALORANT broadcaster experience, VALORANT viewer experience (viewers are no longer able to view their broadcasters stats, despite the broadcaster trying to offer methods to do so), data privacy, our chatbot, and importantly, Riot: having to chase down those using unofficial methods.
• Region: This affects players in all regions.

Issue Comments

I understand that this may have been intentionally not provided by Riot in their official API historically, however, given that users have been contacting me asking for a "native chatbot workaround" given that their solutions for obtaining this data unofficially have broken, now feels like a good time to request a seemingly popular query pattern from Riot's official developer ecosystem, allowing us all to better serve the VALORANT community.

[TristanWiley]

Huge +1 to this! I've worked with the Riot API when working on Pro City for tarik. One of the problems we ran into was getting the rank of players for verification on their application. We weren't able to use the Riot API for this due to the limitations.

I also ran into this when trying to make a rank command for streamers (tarik, ShahZaM, s0m). The only solutions was scraping the public leaderboard. Adding this endpoint would greatly help the Valorant community!

[SputNikPlop]

+1 This would greatly especially for efficiency on mobile for an iOS widget