Genshin Player Info API

Dokumentasi resmi Genshin Player Info API dari Maelyn API untuk detail akun Genshin Impact (player, showcase karakter, weapon, artefak) beserta URL gambar

Base Information

  • BASE_URL_API: https://api.maelyn.eu/api
  • Path / Endpoint: /game/genshin/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 akun HoYoverse via Enka.Network: profil, achievement, abyss, dan showcase karakter lengkap (nama, rarity, elemen, level, friendship, constellation, stat, weapon + refinement, artefak + set) beserta URL gambar yang sudah diproxy (/game/assets/..., source asli disembunyikan).

Example Request

GET /game/genshin/player?uid=812345678

Parameters

NameTypeRequiredDescription
uidstringYesUID Genshin (9 digit). Alias: userId

Example Usage

GET /game/genshin/player?uid=812345678

Success Response

{
  "success": true,
  "data": {
    "game": "genshin_impact",
    "user_id": "812345678",
    "region": "ASIA",
    "valid": true,
    "nickname": "TravelerID",
    "signature": "Ad astra abyssosque",
    "level": 60,
    "world_level": 9,
    "achievements": 500,
    "abyss": { "floor": 10, "chamber": 3, "stars": 18 },
    "images": {
      "namecard": "https://api.maelyn.eu/game/assets/gi/UI_NameCardPic_Yae1_P.png",
      "profile_picture": "https://api.maelyn.eu/game/assets/gi/UI_AvatarIcon_Ganyu.png"
    },
    "profile_showcase": [
      { "id": 10000002, "name": "Kamisato Ayaka", "level": 90, "image": "https://api.maelyn.eu/game/assets/gi/UI_AvatarIcon_Side_Ayaka.png" }
    ],
    "showcase_count": 12,
    "showcase": [
      {
        "id": 10000002,
        "name": "Kamisato Ayaka",
        "element": "Ice",
        "rarity": 5,
        "level": 90,
        "friendship": 10,
        "constellation": 0,
        "images": {
          "icon": "https://api.maelyn.eu/game/assets/gi/UI_AvatarIcon_Side_Ayaka.png",
          "gacha": "https://api.maelyn.eu/game/assets/gi/UI_Gacha_AvatarImg_Ayaka.png"
        },
        "stats": { "hp": 19245.0, "atk": 2458.0, "crit_rate": 0.51, "crit_dmg": 1.88 },
        "weapon": {
          "id": 11509,
          "name": "Mistsplitter Reforged",
          "rarity": 5,
          "level": 90,
          "refinement": 1,
          "image": "https://api.maelyn.eu/game/assets/gi/UI_EquipIcon_Sword_Blunt_Awaken.png"
        },
        "artifacts": [
          {
            "name": "Blizzard Strayer (Flower)",
            "set_name": "Blizzard Strayer",
            "slot": "Flower",
            "level": 20,
            "main_stat": { "stat": "HP", "value": 4780 },
            "sub_stats": [{ "stat": "CRIT DMG", "value": 13.2 }],
            "image": "https://api.maelyn.eu/game/assets/gi/UI_RelicIcon_14001_4.png"
          }
        ]
      }
    ],
    "checked_at": "2026-09-26T13:00:00.000Z"
  }
}

Error Response

Invalid UID

{
  "success": false,
  "error": "INVALID_UID_FORMAT",
  "message": "Format UID tidak valid (9 digit angka)."
}

Playground