Item module
This module manages:
- GET Item database
- POST Item search
- GET Item quick search
- GET Item metadata
It is located at https://web-api.wynncraft.com/api/item
Item database
GET .../item/database 1 hour TTL
TIP
Pagination can be bypassed by adding a query parameter: ?fullResult=True to your request.
{
"controller": {
"count": int,
"pages": int,
"previous": None or str,
"current": int,
"next": int,
"links": {
"previous": None or str,
"next": None or str
}
},
"results": {
"Item Name": {
"material": str, # Minecraft Legacy ID e.g. 269:16
"tier": str,
"powderSlots": int,
"type": str,
"lore": str,
"dropRestriction": str,
"attackSpeed": str,
"base": {
"waterDamage": {
"min": int,
"max": int
},
"averageDPS": int
},
"requirements": {
"level": int,
"strength": int,
"dexterity": int,
"intelligence": int,
"defense": int,
"agility": int
},
"identifications": {
"rawIdentification": int,
"identification": {
"min": int,
"max": int
},
# [...]
}
}
}
}
{
"controller": {
"count": 1,
"pages": 1,
"previous": null,
"current": 1,
"next": null,
"links": {
"previous": null,
"next": null
}
},
"results": {
"Abandoned Tunic": {
"tier": "unique",
"powderSlots": 1,
"type": "chestplate",
"dropRestriction": "normal",
"armorColor": "160,101,64",
"armorType": "leather",
"base": {
"health": 22
},
"requirements": {
"level": 6
},
"identifications": {
"spellDamage": {
"min": 2,
"max": 8
},
"lootBonus": {
"min": 2,
"max": 6
}
}
}
}
}
{
"Item Name": {
"material": str, # Minecraft Legacy ID e.g. 269:16
"tier": str,
"powderSlots": int,
"type": str,
"lore": str,
"dropRestriction": str,
"attackSpeed": str,
"base": {
"waterDamage": {
"min": int,
"max": int
},
"averageDPS": int
},
"requirements": {
"level": int,
"strength": int,
"dexterity": int,
"intelligence": int,
"defense": int,
"agility": int
},
"identifications": {
"rawIdentification": int,
"identification": {
"min": int,
"max": int
},
# [...]
}
},
# [...]
}
{
"Chestplate of Ineptitude": {
"tier": "rare",
"powderSlots": 3,
"type": "chestplate",
"dropRestriction": "normal",
"armorColor": "160,101,64",
"armorType": "diamond",
"base": {
"health": 3375
},
"requirements": {
"level": 98
},
"identifications": {
"rawStrength": -3,
"rawDexterity": -3,
"rawIntelligence": -3,
"rawDefence": -3,
"rawAgility": -3,
"mainAttackDamage": {
"min": 3,
"max": 13
},
"rawMainAttackDamage": {
"min": 42,
"max": 182
},
"spellDamage": {
"min": -13,
"max": -7
},
"rawSpellDamage": {
"min": -143,
"max": -77
},
"rawAttackSpeed": 1
}
},
"Nephilim": {
"tier": "rare",
"powderSlots": 2,
"type": "helmet",
"dropRestriction": "normal",
"armorColor": "160,101,64",
"armorType": "diamond",
"base": {
"health": 2075
},
"requirements": {
"level": 88,
"dexterity": 45,
"agility": 55
},
"identifications": {
"rawDexterity": 8,
"rawAgility": 7,
"lifeSteal": {
"min": 54,
"max": 234
},
"manaSteal": {
"min": 2,
"max": 10
},
"reflection": {
"min": 6,
"max": 26
},
"rawAttackSpeed": 1,
"walkSpeed": {
"min": 6,
"max": 26
},
"sprint": {
"min": 5,
"max": 21
},
"thunderDamage": {
"min": 4,
"max": 20
},
"airDamage": {
"min": 4,
"max": 20
}
}
},
"Nepta Floodbringer": {
"material": "269:16",
"tier": "legendary",
"powderSlots": 2,
"type": "wand",
"lore": "combined power of inscribed uth runes and immense wisdom meld to create a commanding aura, as this weapon is merely a spiritual extension of the user's desire for dominion over all.",
"dropRestriction": "normal",
"attackSpeed": "super_fast",
"base": {
"waterDamage": {
"min": 70,
"max": 90
},
"averageDPS": 344
},
"requirements": {
"level": 93,
"intelligence": 80
},
"identifications": {
"rawIntelligence": 13,
"spellDamage": {
"min": 6,
"max": 26
},
"rawHealth": {
"min": -2275,
"max": -1225
},
"manaRegen": {
"min": 2,
"max": 8
},
"thunderDamage": {
"min": -130,
"max": -70
},
"waterDamage": {
"min": 4,
"max": 20
},
"thunderDefence": {
"min": -39,
"max": -21
}
}
}
}
Examples results have been truncated to a small amount of items
Item search
POST .../item/search
TIP
Pagination can be bypassed by adding a query parameter: ?fullResult=True to your request.
Example of bypassing it can be seen in database
{
"query": [str],
"type": [str, list],
"tier": [int, list, str],
"attackSpeed": [str, list],
"levelRange": [int, list],
"professions": [str, list],
"identifications": [str, list],
"majorIds": [str, list],
}
{
"query": "Nep",
"type": "wand",
"tier": "legendary",
"attackSpeed": "super_fast",
"levelRange": [0, 94],
"identifications": "spellDamage"
}
{
"controller": {
"count": 1,
"pages": 1,
"previous": null,
"current": 1,
"next": null,
"links": {
"previous": null,
"next": null
},
"payload": {
"query": "Nep",
"type": "wand",
"tier": "legendary",
"attackSpeed": "super_fast",
"levelRange": [
0,
94
],
"identifications": "spellDamage"
}
},
"results": {
"Nepta Floodbringer": {
"material": "269:16",
"tier": "legendary",
"powderSlots": 2,
"type": "wand",
"lore": "combined power of inscribed uth runes and immense wisdom meld to create a commanding aura, as this weapon is merely a spiritual extension of the user's desire for dominion over all.",
"dropRestriction": "normal",
"attackSpeed": "super_fast",
"base": {
"waterDamage": {
"min": 70,
"max": 90
},
"averageDPS": 344
},
"requirements": {
"level": 93,
"intelligence": 80
},
"identifications": {
"rawIntelligence": 13,
"spellDamage": {
"min": 6,
"max": 26
},
"rawHealth": {
"min": -2275,
"max": -1225
},
"manaRegen": {
"min": 2,
"max": 8
},
"thunderDamage": {
"min": -130,
"max": -70
},
"waterDamage": {
"min": 4,
"max": 20
},
"thunderDefence": {
"min": -39,
"max": -21
}
}
}
}
}
Filters can be empty and don't need to always be in the payload, if you wanna experiment with this endpoint and understand it better, try out the official wynncraft item guide while monitoring your devtools network tab.
Item quick search
GET .../item/search/<str:query> 1 minute TTL
{
"Item Name": {
"material": str, # Minecraft Legacy ID e.g. 269:16
"tier": str,
"powderSlots": int,
"type": str,
"lore": str,
"dropRestriction": str,
"attackSpeed": str,
"base": {
"waterDamage": {
"min": int,
"max": int
},
"averageDPS": int
},
"requirements": {
"level": int,
"strength": int,
"dexterity": int,
"intelligence": int,
"defense": int,
"agility": int
},
"identifications": {
"rawIdentification": int,
"identification": {
"min": int,
"max": int
},
# [...]
}
},
# [...]
}
{
"Chestplate of Ineptitude": {
"tier": "rare",
"powderSlots": 3,
"type": "chestplate",
"dropRestriction": "normal",
"armorColor": "160,101,64",
"armorType": "diamond",
"base": {
"health": 3375
},
"requirements": {
"level": 98
},
"identifications": {
"rawStrength": -3,
"rawDexterity": -3,
"rawIntelligence": -3,
"rawDefence": -3,
"rawAgility": -3,
"mainAttackDamage": {
"min": 3,
"max": 13
},
"rawMainAttackDamage": {
"min": 42,
"max": 182
},
"spellDamage": {
"min": -13,
"max": -7
},
"rawSpellDamage": {
"min": -143,
"max": -77
},
"rawAttackSpeed": 1
}
},
"Nephilim": {
"tier": "rare",
"powderSlots": 2,
"type": "helmet",
"dropRestriction": "normal",
"armorColor": "160,101,64",
"armorType": "diamond",
"base": {
"health": 2075
},
"requirements": {
"level": 88,
"dexterity": 45,
"agility": 55
},
"identifications": {
"rawDexterity": 8,
"rawAgility": 7,
"lifeSteal": {
"min": 54,
"max": 234
},
"manaSteal": {
"min": 2,
"max": 10
},
"reflection": {
"min": 6,
"max": 26
},
"rawAttackSpeed": 1,
"walkSpeed": {
"min": 6,
"max": 26
},
"sprint": {
"min": 5,
"max": 21
},
"thunderDamage": {
"min": 4,
"max": 20
},
"airDamage": {
"min": 4,
"max": 20
}
}
},
"Nepta Floodbringer": {
"material": "269:16",
"tier": "legendary",
"powderSlots": 2,
"type": "wand",
"lore": "combined power of inscribed uth runes and immense wisdom meld to create a commanding aura, as this weapon is merely a spiritual extension of the user's desire for dominion over all.",
"dropRestriction": "normal",
"attackSpeed": "super_fast",
"base": {
"waterDamage": {
"min": 70,
"max": 90
},
"averageDPS": 344
},
"requirements": {
"level": 93,
"intelligence": 80
},
"identifications": {
"rawIntelligence": 13,
"spellDamage": {
"min": 6,
"max": 26
},
"rawHealth": {
"min": -2275,
"max": -1225
},
"manaRegen": {
"min": 2,
"max": 8
},
"thunderDamage": {
"min": -130,
"max": -70
},
"waterDamage": {
"min": 4,
"max": 20
},
"thunderDefence": {
"min": -39,
"max": -21
}
}
}
}
Item metadata
GET .../item/metadata 1 hour TTL
TIP
All available filters for advanced search are returned by this endpoint, if you search a precise filter it will be here.
{
"identifications": [
"spellDamage",
# [..]
],
"majorIds": [
"Divine Honor",
# [..]
],
"filters": {
"type": [
"weapons",
# [..]
],
"advanced": { # Subtypes for main filters
"attackSpeed": [
"super_slow",
# [..]
],
"weapons": [
"bow",
# [..]
],
"armour": [
"helmet",
# [..]
],
"accessories": [
"necklace",
# [..]
],
"tomes": [
"weaponTome",
# [..]
],
"tools": [
"axe",
# [...]
],
"crafting": [
"alchemism",
# [...]
],
"gathering": [
"mining",
# [...]
]
},
"tier": {
"items": [
"common",
# [...]
],
"ingredients": [
0,
# [...]
]
},
"levelRange": {
"items": int,
"ingredients": int
}
}
}
{
"identifications": [
"spellDamage",
"lootBonus",
"rawStrength",
"rawDefence",
"mainAttackDamage",
"healthRegenRaw",
"lifeSteal",
"manaSteal",
"thorns",
"reflection",
"manaRegen",
"xpBonus",
"rawDexterity",
"poison",
"exploding",
"soulPointRegen",
"earthDamage",
"rawAgility",
"rawAttackSpeed",
"walkSpeed",
"thunderDamage",
"airDamage",
"rawHealth",
"fireDamage",
"rawIntelligence",
"rawMainAttackDamage",
"rawSpellDamage",
"earthDefence",
"waterDefence",
"fireDefence",
"healthRegen",
"waterDamage",
"airDefence",
"thunderDefence",
"raw1stSpellCost",
"stealing",
"raw3rdSpellCost",
"raw4thSpellCost",
"sprintRegen",
"1stSpellCost",
"2ndSpellCost",
"3rdSpellCost",
"raw2ndSpellCost",
"4thSpellCost",
"jumpHeight",
"sprint",
"rawWaterSpellDamage",
"rawAirSpellDamage",
"earthSpellDamage",
"rawEarthSpellDamage",
"thunderMainAttackDamage",
"rawThunderMainAttackDamage",
"rawElementalSpellDamage",
"rawThunderSpellDamage",
"rawFireSpellDamage",
"waterSpellDamage",
"rawAirMainAttackDamage",
"airMainAttackDamage",
"bonusElementalDefense",
"elementalDamage",
"rawThunderDamage",
"rawWaterDamage",
"rawFireMainAttackDamage",
"rawElementalDamage",
"knockback",
"weakenEnemy",
"fireSpellDamage",
"slowEnemy",
"elementalDefense",
"rawElementalMainAttackDamage",
"earthMainAttackDamage",
"healingEfficiency",
"airSpellDamage",
"elementalSpellDamage",
"rawNeutralSpellDamage",
"rawFireDamage",
"rawAirDamage",
"rawEarthDamage",
"rawNeutralDamage",
"lootQuality",
"rawWaterMainAttackDamage",
"gatherXpBonus",
"gatherSpeed"
],
"majorIds": [
"Divine Honor",
"Greed",
"Magnet",
"Plague",
"Saviour’s Sacrifice",
"Sorcery",
"Soul Eater",
"Fission",
"Guardian",
"Overwhelm",
"Rally",
"Temblor",
"Cavalryman",
"Entropy",
"Escape Route",
"Lightweight",
"Snowy Steps",
"Taunt",
"Flashfreeze",
"Forest's Blessing",
"Hawkeye",
"Heart of the Pack",
"Cherry Bombs",
"Gentle Glow",
"Peaceful Effigy",
"Reckless Abandon",
"Furious Effigy",
"Geocentrism",
"Strings of Fate",
"Freerunner",
"Madness",
"Alter Ego",
"Explosive Impact",
"Festive Spirit",
"Gravity Well",
"Perfect Recall",
"Juggle",
"Roving Assassin",
"Transcendence"
],
"filters": {
"type": [
"weapons",
"armour",
"accessories",
"tomes",
"charms",
"tools",
"ingredients",
"materials"
],
"advanced": {
"attackSpeed": [
"super_slow",
"very_slow",
"slow",
"normal",
"fast",
"very_fast",
"super_fast"
],
"weapons": [
"bow",
"relik",
"wand",
"dagger",
"spear"
],
"armour": [
"helmet",
"chestplate",
"leggings",
"boots"
],
"accessories": [
"necklace",
"ring",
"bracelet"
],
"tomes": [
"weaponTome",
"armourTome",
"slayingTome",
"dungeonTome",
"gatheringTome",
"guildTome"
],
"tools": [
"axe",
"pickaxe",
"rod",
"scythe"
],
"crafting": [
"alchemism",
"armouring",
"cooking",
"jeweling",
"scribing",
"tailoring",
"weaponsmithing",
"woodworking"
],
"gathering": [
"mining",
"fishing",
"farming",
"woodcutting"
]
},
"tier": {
"items": [
"common",
"fabled",
"legendary",
"mythic",
"rare",
"set",
"unique"
],
"ingredients": [
0,
1,
2,
3
]
},
"levelRange": {
"items": 110,
"ingredients": 105
}
}
}