Referencia API
Documentación Valorant API
Bienvenido a la documentación de LosPerris Valorant API. Integra rangos, partidas y estadísticas en tus apps o bots de chat (Nightbot, StreamElements, Fossabot).
Base URLhttps://vlr.losperris.dev
Devuelve el rango actual, ELO y puntuación de un jugador. Ideal para comandos !rank.
GET/api/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 "https://vlr.losperris.dev/api/rank/na/PonssLoveless/8882"
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"
}
}
Obtiene estadísticas detalladas de la última partida competitiva jugada.
GET/api/match/last/:region/:name/:tag
curl -X GET "https://vlr.losperris.dev/api/match/last/na/PonssLoveless/8882"
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
}
}
}
Obtiene el resumen de las partidas competitivas jugadas en las últimas 24 horas.
GET/api/today/:region/:name/:tag
Parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
type | Number | (Opcional) 1: Básico, 2: +Partidas Jugadas, 3: +Winrate |
Ejemplos de Uso
curl -X GET "https://vlr.losperris.dev/api/today/na/PonssLoveless/8882"
Respuesta
{
"status": 200,
"data": {
"matches_played": 4,
"wins": 3,
"losses": 1,
"draws": 0,
"rr_change": 42
}
}
Obtiene las estadísticas de rendimiento de las últimas 10 partidas competitivas (Winrate, Agente favorito, HS%).
GET/api/stats/:region/:name/:tag
Parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
type | Number | (Opcional) 1: Compacto, 2: Básico, 3: Descriptivo |
Ejemplos de Uso
curl -X GET "https://vlr.losperris.dev/api/stats/na/PonssLoveless/8882"
Respuesta
{
"status": 200,
"data": {
"matches_analyzed": 10,
"winrate": 58,
"favorite_agent": "Jett",
"hs_percent": "25.5"
}
}
| 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. |