Valorant Player Info API

Dokumentasi resmi Valorant Player Info API dari Maelyn API untuk detail Riot ID (profil, rank MMR, riwayat RR, match terakhir) beserta URL gambar

Base Information

  • BASE_URL_API: https://api.maelyn.eu/api
  • Path / Endpoint: /game/valorant/player
  • Method: GET
  • Credit Usage: 3

Authentication

Gunakan header berikut pada setiap request:

x-maelyn-auth: YOUR_API_KEY

Query Parameters

Endpoint ini mengambil detail Riot ID via HenrikDev: profil (level, region, player card), rank MMR + peak + leaderboard, 10 riwayat RR terakhir, dan 5 match terakhir (map, hasil, KDA, agent + gambar yang sudah diproxy).

Example Request

GET /game/valorant/player?name=PlayerOne&tag=1234

Parameters

NameTypeRequiredDescription
namestringYesGame name Riot ID (3-16 karakter). Alias: username
tagstringYesTagline Riot ID (3-5 karakter).

Example Usage

GET /game/valorant/player?name=PlayerOne&tag=1234

Success Response

{
  "success": true,
  "data": {
    "game": "valorant",
    "valid": true,
    "name": "PlayerOne",
    "tag": "1234",
    "puuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "region": "ap",
    "account_level": 312,
    "images": {
      "card_small": "https://api.maelyn.eu/game/assets/valo/playercards/xxx/small.png",
      "card_wide": "https://api.maelyn.eu/game/assets/valo/playercards/xxx/wide.png"
    },
    "rank": {
      "current": "Immortal 1",
      "rr": 45,
      "elo": 2145,
      "last_change": 18,
      "games": 87,
      "peak": "Immortal 3",
      "leaderboard": 1234
    },
    "rr_history": [
      { "rank": "Immortal 1", "rr_change": 18, "rr_in_tier": 45, "elo": 2145, "date": "2026-09-26" }
    ],
    "recent_matches": [
      {
        "map": "Ascent",
        "mode": "Competitive",
        "result": "WIN",
        "score": "13-9",
        "agent": "Jett",
        "agent_image": "https://api.maelyn.eu/game/assets/valo/agents/xxx/displayicon.png",
        "kills": 21,
        "deaths": 14,
        "assists": 5,
        "kda": "21/14/5",
        "kda_ratio": 1.86
      }
    ],
    "recent_form": { "played": 5, "wins": 3 },
    "checked_at": "2026-09-26T13:00:00.000Z"
  }
}

Error Response

Riot ID Tidak Ditemukan

{
  "success": true,
  "data": {
    "game": "valorant",
    "name": "Nope",
    "tag": "ZZZ9",
    "valid": false,
    "reason": "Riot ID tidak ditemukan."
  }
}

Invalid Format

{
  "success": false,
  "error": "INVALID_RIOT_ID",
  "message": "Format Riot ID tidak valid (name 3-16 karakter, tag 3-5 karakter)."
}

Playground