You can utilize some wrappers made by other people, or use the API directly. It's very simple, so it is not hard at all to hand-roll your own data logic based on the responses. The biggest challenge is navigating the datamined game data and attaching it to the data returned in the right way.
See Wrappers for the language of your choice.
A couple of rules on using the API:
-
Please don't try to enumerate UIDs or try to do massive query jobs in an effort to fill a database. There are hundreds of millions of UIDs and you simply won't be able to do this through this API. I may provide batch data at a later point.
-
Please set a custom
User-Agentheader with your requests so I can track them better and help you if needed. -
There are dynamic ratelimits on UID endpoints - if you're requesting too fast, you'll run into slower response times and eventually a 429 return code. This mean you either need to slow down or contact me to see if it's possible to increase the ratelimits for you. In most cases it's not needed and is a result of unoptimized code.
-
On this note, all UID requests return a
ttlfield - this field is "seconds until the next Showcase request will be made for this UID". Until it runs out, the endpoint will return cached data, but you will still consume your ratelimit if you repeatedly hit it. Try to either cache the data with a timeout ofttlupon request, or prevent requests to the UID until itsttlruns out. I recommend Redis for this.
If you have difficulties working with the data, hop on the Discord server for help.
The response will contain playerInfo and avatarInfoList. playerInfo is the basic data about the game account. If avatarInfoList is missing, that means the Showcase of this account is either closed or not populated with characters.
By attaching ?info to the request, you are requesting only playerInfo. The main request always tries to get avatarInfoList as well; if you only need playerInfo, please use this endpoint - it will be much faster than getting the full data.
In addition, both responses will contain an owner object if:
- The user has an account on the site
- The user added their UID to the profile
- The user verified it
- The user set its visibility to "public"
More info on user accounts below.
Please make sure to handle these in your app appropriately.
400 = Wrong UID format
404 = Player does not exist (MHY server said that)
424 = Game maintenance / everything is broken after the game update
429 = Rate-limited (either by my server or by MHY server)
500 = General server error
503 = I screwed up massively
It is possible to create an account (profile) on the website and attach several game accounts to it. The users are then required to verify that the account belongs to them via a verification code placed in their signature - this way we can ensure the account belongs to them.
Users can "snapshot" builds under custom names, referred as "saved builds".
Gets the user info.
Gets a list of "hoyos" - Genshin accounts and their metadata. This only returns accounts that are verified and public (users can hide accounts; unverified accounts are hidden by default). Each key in the response is a unique identifier of a hoyo which you need to use for the subsequent requests to actually get the characters/builds information.
Returns metadata for a single hoyo.
https://enka.network/api/profile/Algoinde/hoyos/4Wjv2e/builds/
Returns saved builds for a given hoyo. This is an object of arrays, where the key is avatarId of the character, and objects in arrays are different builds for a given character, in no particular order (but they do have an order field you need to order by for display).
If a build has a live: true field, that means it's not a "saved" build, but simply what was fetched from their showcase when they clicked "refresh". When refreshed, all old live builds are gone and new ones are created. Only the user decides when to perform this refresh - this data will NOT be up-to-date.
As outlined in UID endpoints, when you make a UID request, you could get an owner object. You can construct the URL using these fields in the object:
https://enka.network/api/profile/{owner.username}/hoyos/{owner.hash}/builds/
| Name | Description |
|---|---|
| playerInfo | Profile Info |
| avatarInfoList | List of detailed information for every character from showcase |
For basic data of characters by ID, go to store/characters.json.
For any additional info, check the Characters Data.
| Name | Description |
|---|---|
| nickname | Player Nickname |
| signature | Profile Signature |
| worldLevel | Player World Level |
| namecardId | Profile Namecard ID |
| finishAchievementNum | Number of Completed Achievements |
| towerFloorIndex | Abyss Floor |
| towerLevelIndex | Abyss Floor's Chamber |
| showAvatarInfoList | List of Character IDs and Levels |
| showNameCardIdList | List of Namecard IDs |
| profilePicture.avatarId | Character ID of Profile Picture |
| Name | Description |
|---|---|
| avatarId | Character ID |
| level | Character Level |
| costumeId | ID of character's skin. Check "Costumes" in store/characters.json |
For basic data of characters by ID, go to store/characters.json.
For any additional info, check the Characters Data.
| Name | Description |
|---|---|
| avatarID | Character ID |
| talentIdList | List of Constellation IDs There is no data if 0 Constellation |
| propMap | Character Info Properties List |
fightPropMap -> {id: value} |
Map of Character's Combat Properties. Check the Definitions for IDs |
| skillDepotId | Character Skill Set ID Skills Data -> "id" |
| inherentProudSkillList | List of Unlocked Skill Ids Skills Data -> "inherentProudSkillOpens" |
skillLevelMap -> {skill_id: level} |
Map of Skill Levels Skills Data -> "inherentProudSkillOpens" |
| equipList | List of Equipments: Weapon, Ariftacts |
| fetterInfo.expLevel | Character Friendship Level |
| Name | Description |
|---|---|
| type | ID of Property Type, Check the Definitions for IDs |
| ival | Ignore it |
| val | Value of Property |
| Name | Description |
|---|---|
| itemId | Equipment ID Artifacts Data -> "id" Weapons Data -> "id" |
weapon [Weapon Only] |
Weapon Base Info |
reliquary [Artifact Only] |
Artifact Base Info |
| flat | Detailed Info of Equipment |
For any additional info about weapons, check the Weapons Data
| Name | Description |
|---|---|
| level | Weapon Level |
| promoteLevel | Weapon Ascension Level |
| affixMap | Weapon Refinement Level [0-4] |
For any additional info about artifacts, check the Artifacts Data
| Name | Description |
|---|---|
| level | Artifact Level [1-21] |
| mainPropId | Artifact Main Stat ID MainProps Data |
| appendPropIdList | List of IDs of the artifact substats AppendProp Data |
| Name | Description |
|---|---|
| nameTextHashMap | Hash for Equipment Name Check Localizations |
setNameTextHashMap [Artifact Only] |
Hash for Artifact Set Name Check Localizations |
| rankLevel | Rarity Level of Equipment |
reliquaryMainstat [Artifact Only] |
Artifact Main Stat |
reliquarySubstats [Artifact Only] |
List of Artifact Substats |
weaponStats [Weapon Only] |
List of Weapon Stat: Base ATK, Substat |
| itemType | Equipment Type: Weapon or Artifact |
| icon | Equipment Icon Name Icon name usage |
equipType [Artifact Only] |
Artifact Type |
| Name | Description |
|---|---|
| mainPropId / appendPropID | Equipment Append Property Name. Check the Definitions for Names |
| propValue | Property Value |
| Type | Description |
|---|---|
| 1001 | XP |
| 1002 | Ascension |
| 4001 | Level |
| Type | Description |
|---|---|
| 1 | Base HP |
| 2 | HP |
| 3 | HP% |
| 4 | Base ATK |
| 5 | ATK |
| 6 | ATK% |
| 7 | Base DEF |
| 8 | DEF |
| 9 | DEF% |
| 10 | Base SPD |
| 11 | SPD% |
| 20 | CRIT Rate |
| 22 | CRIT DMG |
| 23 | Energy Recharge |
| 26 | Healing Bonus |
| 27 | Incoming Healing Bonus |
| 28 | Elemental Mastery |
| 29 | Physical RES |
| 30 | Physical DMG Bonus |
| 40 | Pyro DMG Bonus |
| 41 | Electro DMG Bonus |
| 42 | Hydro DMG Bonus |
| 43 | Dendro DMG Bonus |
| 44 | Anemo DMG Bonus |
| 45 | Geo DMG Bonus |
| 46 | Cryo DMG Bonus |
| 50 | Pyro RES |
| 51 | Electro RES |
| 52 | Hydro RES |
| 53 | Dendro RES |
| 54 | Anemo RES |
| 55 | Geo RES |
| 56 | Cryo RES |
| 70 | Pyro Enegry Cost |
| 71 | Electro Energy Cost |
| 72 | Hydro Energy Cost |
| 73 | Dendro Energy Cost |
| 74 | Anemo Energy Cost |
| 75 | Cryo Energy Cost |
| 76 | Geo Energy Cost |
| 80 | Cooldown reduction |
| 81 | Shield Strength |
| 1000 | Current Pyro Energy |
| 1001 | Current Electro Energy |
| 1002 | Current Hydro Energy |
| 1003 | Current Dendro Energy |
| 1004 | Current Anemo Energy |
| 1005 | Current Cryo Energy |
| 1006 | Current Geo Energy |
| 1010 | Current HP |
| 2000 | Max HP |
| 2001 | ATK |
| 2002 | DEF |
| 2003 | SPD |
| 3025 | Elemental reaction CRIT Rate |
| 3026 | Elemental reaction CRIT DMG |
| 3027 | Elemental reaction (Overloaded) CRIT Rate |
| 3028 | Elemental reaction (Overloaded) CRIT DMG |
| 3029 | Elemental reaction (Swirl) CRIT Rate |
| 3030 | Elemental reaction (Swirl) CRIT DMG |
| 3031 | Elemental reaction (Electro-Charged) CRIT Rate |
| 3032 | Elemental reaction (Electro-Charged) CRIT DMG |
| 3033 | Elemental reaction (Superconduct) CRIT Rate |
| 3034 | Elemental reaction (Superconduct) CRIT DMG |
| 3035 | Elemental reaction (Burn) CRIT Rate |
| 3036 | Elemental reaction (Burn) CRIT DMG |
| 3037 | Elemental reaction (Frozen (Shattered)) CRIT Rate |
| 3038 | Elemental reaction (Frozen (Shattered)) CRIT DMG |
| 3039 | Elemental reaction (Bloom) CRIT Rate |
| 3040 | Elemental reaction (Bloom) CRIT DMG |
| 3041 | Elemental reaction (Burgeon) CRIT Rate |
| 3042 | Elemental reaction (Burgeon) CRIT DMG |
| 3043 | Elemental reaction (Hyperbloom) CRIT Rate |
| 3044 | Elemental reaction (Hyperbloom) CRIT DMG |
| 3045 | Base Elemental reaction CRIT Rate |
| 3046 | Base Elemental reaction CRIT DMG |
| Name | Description |
|---|---|
| ITEM_WEAPON | Weapon |
| ITEM_RELIQUARY | Artifact |
| Name | Description |
|---|---|
| EQUIP_BRACER | Flower |
| EQUIP_NECKLACE | Feather |
| EQUIP_SHOES | Sands |
| EQUIP_RING | Goblet |
| EQUIP_DRESS | Circlet |
| Name | Description |
|---|---|
FIGHT_PROP_BASE_ATTACK [Weapon] |
Base ATK |
| FIGHT_PROP_HP | Flat HP |
| FIGHT_PROP_ATTACK | Flat ATK |
| FIGHT_PROP_DEFENSE | Flat DEF |
| FIGHT_PROP_HP_PERCENT | HP% |
| FIGHT_PROP_ATTACK_PERCENT | ATK% |
| FIGHT_PROP_DEFENSE_PERCENT | DEF% |
| FIGHT_PROP_CRITICAL | Crit RATE |
| FIGHT_PROP_CRITICAL_HURT | Crit DMG |
| FIGHT_PROP_CHARGE_EFFICIENCY | Energy Recharge |
| FIGHT_PROP_HEAL_ADD | Healing Bonus |
| FIGHT_PROP_ELEMENT_MASTERY | Elemental Mastery |
| FIGHT_PROP_PHYSICAL_ADD_HURT | Physical DMG Bonus |
| FIGHT_PROP_FIRE_ADD_HURT | Pyro DMG Bonus |
| FIGHT_PROP_ELEC_ADD_HURT | Electro DMG Bonus |
| FIGHT_PROP_WATER_ADD_HURT | Hydro DMG Bonus |
| FIGHT_PROP_WIND_ADD_HURT | Anemo DMG Bonus |
| FIGHT_PROP_ICE_ADD_HURT | Cryo DMG Bonus |
| FIGHT_PROP_ROCK_ADD_HURT | Geo DMG Bonus |
| FIGHT_PROP_GRASS_ADD_HURT | Dendro DMG Bonus |
You can get icons of characters, weapons and artifacts via Enka, by URL https://enka.network/ui/[icon_name].png.
Usually icon name starts with "UI_" or "Skill_" for characters talents.
For example https://enka.network/ui/UI_AvatarIcon_Side_Ambor.png.
Go to flat and look for icon.
Go to store/characters.json and look for anything related to "UI_XXXXXX" or "Skill_XXXXXX" by character ID.
You may notice "NameTextMapHash" in store/characters.json, "nameTextHashMap" and "setNameTextHashMap" at flat that could be used as a key to get basic localization data of characters, weapons and artifacts from store/loc.json.
Also you can get localization data of AppendProp by using property name as a key - "FIGHT_PROP_HP", "FIGHT_PROP_HEAL_ADD" etc.
For any additional info about names, descriptions and etc, check the TextMap Data, only includes languages supported by game.
TS/JS - https://www.npmjs.com/package/enkanetwork.js - Jelosus1
TS/JS - https://github.com/yuko1101/enka-network-api - yuko1101
Rust - https://github.com/eratou/enkanetwork-rs - eratou
Python - https://github.com/mrwan200/enkanetwork.py - mrwan200
Python - https://github.com/seriaati/enka-py - seriaati