wynncraft.com APIwynncraft.com ↗
Access Wynncraft game data via 8 endpoints: item database, player stats, character details, guild rosters, and global search results.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/5adcf1d6-306a-494c-a4ba-0443cbd08b74/get_item_metadata' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns metadata for item filters and identifications. Includes possible values for types, tiers, attack speeds, and identification stat names.
No input parameters required.
{
"type": "object",
"fields": {
"static": "object mapping identification/type names to numeric IDs",
"filters": "object containing type arrays, tier lists, identification names, major IDs, and level ranges"
},
"sample": {
"data": {
"static": {
"all": 1,
"armour": 4,
"legendary": 300,
"chestplate": 2
},
"filters": {
"tier": {
"items": [
"common",
"unique",
"rare"
],
"ingredients": [
"TIER_0",
"TIER_1",
"TIER_2"
]
},
"type": [
"weapon",
"armour",
"accessory"
],
"advanced": {
"armour": [
"helmet",
"chestplate",
"leggings"
],
"weapon": [
"bow",
"relik",
"wand"
],
"attackSpeed": [
"superSlow",
"verySlow",
"slow"
]
},
"majorIds": [
"hurricane'sEye",
"napalm",
"meteorCrash"
],
"levelRange": {
"items": 120,
"ingredients": 120
},
"identifications": [
"baseHealth",
"baseEarthDefence",
"healthRegen"
]
}
},
"status": "success"
}
}About the wynncraft.com API
The Wynncraft API covers 8 endpoints that expose live game data from wynncraft.com, including a paginated item database with full identification stats, per-player global data, and guild rosters. The get_player_stats endpoint returns playtime, wars, mobs killed, chests found, dungeons, raids, and PvP stats for any player by username. Whether you're building a gear comparison tool or tracking guild activity, the API returns structured JSON ready to use.
Item Data
The get_item_metadata endpoint returns filter metadata — type arrays, tier lists, identification stat names, major IDs, and level ranges — useful for building filter UIs or validating query inputs before hitting search_items. The get_item_database_paginated endpoint returns 20 items per page; check controller.pages to know how many pages exist and controller.next to iterate. Each item object includes displayName, type, subType, tier, identifications, and base stats. If you need the full catalog at once, get_item_database_full iterates all pages automatically, though it may take up to 60 seconds to resolve.
Player and Character Endpoints
get_player_stats accepts a case-insensitive username and returns online, server, playtime, guild membership (name, prefix, rank), and a globalData object covering wars, total level, mobs killed, chests found, dungeon and raid completions, and PvP stats. get_player_characters returns an object keyed by character UUID, with each value holding the character's type (WARRIOR, ARCHER, MAGE, ASSASSIN, or SHAMAN), level, xp, xpPercent, totalLevel, gamemode, reskin, and optional nickname.
Guild and Search Endpoints
get_guild_stats accepts a case-insensitive guild_name and returns level, wars, territories, prefix, and a members object that breaks the roster into ranked tiers: owner, chief, strategist, captain, recruiter, and recruit. The global_search endpoint accepts a free-text query and returns matching players (UUID-to-username map), guilds and guildsPrefix (UUID-to-name-and-prefix maps), and matching items. Note that search_items supports structured filtering by type, tier, and other criteria via a JSON filters string, and returns a 404 if no items match the supplied criteria.
- Build a gear comparison tool using item
identificationsandtierfields from the item database. - Track a player's progression over time using
playtime,totalLevel, andglobalDatadungeon/raid counts. - Display a guild's roster organized by rank using the
membersobject fromget_guild_stats. - Power an autocomplete search bar using
global_searchresults across players, guilds, and items. - Filter the item database by type and tier using
search_itemsto show class-specific gear recommendations. - Show a player's character roster with class types, levels, and gamemodes using
get_player_characters. - Monitor territory holdings and war counts for competing guilds using
territoriesandwarsfrom guild stats.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Wynncraft have an official developer API?+
What does `search_items` return when no items match the filter criteria?+
Does `get_player_stats` return inventory or equipped item data?+
get_player_stats covers online status, server, playtime, guild membership, and aggregate globalData stats like mobs killed and chests found. Per-character inventory and equipped items are not currently exposed. You can fork this API on Parse and revise it to add an endpoint covering character inventory if that data is available from the source.How does pagination work in the item database endpoints?+
get_item_database_paginated returns 20 items per page. The controller object in the response includes pages (total page count), count (total items), current_count (items on this page), and prev/next page numbers. Pass the page integer parameter (1-indexed) to move through results. If you need all items at once, use get_item_database_full instead, but expect up to 60 seconds for it to complete.