Documentación Valorant API

Bienvenido a la documentación oficial de LosPerris Valorant API. Integra datos de rangos, historial de partidas y estadísticas detalladas en tus aplicaciones o bots de chat (Nightbot, StreamElements).

Obtener Rango (MMR)

Devuelve el rango actual, ELO y puntuación de un jugador. Ideal para comandos !rank.

GET /api/valorant/rank/:region/:name/:tag

Parámetros

Parámetro	Tipo	Descripción
`region`	String	na, eu, ap, kr, latam, br
`name`	String	Riot ID del jugador
`tag`	String	Tagline del jugador
`type`	Number	(Opcional) 1: Solo Rango, 2: +Puntos, 3: +ELO

Ejemplos de Uso

curl -X GET "/api/valorant/rank/na/PonssLoveless/8882"

fetch("/api/valorant/rank/na/PonssLoveless/8882")
  .then(res => res.json())
  .then(data => console.log(data));

import requests
res = requests.get("/api/valorant/rank/na/PonssLoveless/8882")
print(res.json())

Copia esto en tu Nightbot o StreamElements:

$(urlfetch /api/valorant/rank/na/PonssLoveless/8882?format=text)

Respuesta

{
                            "status": 200,
                            "data": {
                            "puuid": "a1b2c3d4-...",
                            "region": "na",
                            "account_level": 250,
                            "name": "PonssLoveless",
                            "tag": "8882",
                            "card": {
                            "small": "https://media.valorant-api.com/playercards/.../smallart.png",
                            "large": "https://media.valorant-api.com/playercards/.../largeart.png",
                            "wide": "https://media.valorant-api.com/playercards/.../wideart.png"
                            },
                            "last_update": "Less than a minute
                                ago",
                            "current_tier_patched": "Ascendant
                                2",
                            "ranking_in_tier": 50,
                            "mmr_change_to_last_game": 18,
                            "elo": 1650,
                            "rank_image": "https://media.valorant-api.com/competitivetiers/.../largeicon.png"
                            }
                            }
                        

                        Ascendant 2 - 50RR
                    

Última Partida

Obtiene estadísticas detalladas de la última partida competitiva jugada.

GET /api/valorant/match/last/:region/:name/:tag

                        curl -X GET "/api/valorant/match/last/na/PonssLoveless/8882"
                    
                        $(urlfetch /api/valorant/match/last/na/PonssLoveless/8882?format=text)

Respuesta

{
                            "status": 200,
                            "data": {
                            "metadata": {
                            "map": "Ascent",
                            "mode": "Competitive",
                            "matchid": "a1b2-...",
                            "region": "na"
                            },
                            "players": {
                            "all_players": [
                            {
                            "name": "PonssLoveless",
                            "character": "Jett",
                            "stats": {
                            "kills": 24,
                            "deaths": 12,
                            "assists": 5
                            }
                            }
                            ]
                            },
                            "teams": {
                            "blue": { "has_won": true, "rounds_won": 13 }
                            },
                            "derived": {
                            "hs_percent": 25.5
                            }
                            }
                            }
                        

                        Ascent - VICTORY - 24/12/5
                    

Resumen de Perfil

Endpoint "Todo en Uno". Devuelve cuenta, rango, última partida e historial en una sola llamada.

GET /api/valorant/summary/:region/:name/:tag

{ "status": 200, "data": { "rank": { /* Datos completos del endpoint /rank */ "current_tier_patched": "Ascendant 2", "elo": 1650, ... }, "match": { /* Datos completos del endpoint /match/last */ "metadata": { ... }, "players": { ... }, ... }, "history": [ { "match_id": "...", "tier": "Gold 1", "map": "Haven", "elo": 1235, "date": "..." }, ... ] } }

Códigos de Error

Código	Significado	Descripción
400	Bad Request	Faltan parámetros o la región es inválida.
404	Not Found	El jugador no existe o perfil privado.
500	Server Error	Error del servidor o de Riot API.