wowhead.com APIwowhead.com ↗
Access Wowhead data via API: search items, NPCs, spells, and quests by ID, browse paginated database lists, and fetch WoW news and live game events.
curl -X GET 'https://api.parse.bot/scraper/93b56483-7fc6-48da-bd9f-1310e3bca1c3/search?query=Fireball' \ -H 'X-API-Key: $PARSE_API_KEY'
Search across all Wowhead database categories (Items, NPCs, Spells, Quests, etc.). Returns results grouped by category.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g. 'Thunderfury'). |
{
"type": "object",
"fields": {
"data": "array containing the search query string and an object with category-grouped results (e.g. items, npcs)"
},
"sample": {
"data": [
"Thunderfury",
{
"items": [
{
"id": 128507,
"icon": "inv_sword_39",
"name": "Inflatable Thunderfury, Blessed Blade of the Windseeker",
"level": 1,
"quality": 3
}
]
}
],
"status": "success"
}
}About the wowhead.com API
This API exposes 9 endpoints covering the Wowhead World of Warcraft database, including item detail lookup via get_item, paginated database browsing via get_database_list, and live game event schedules via get_today_in_wow. Item responses include 10 structured fields such as quality tier, item level, subclass, icon identifier, and raw equip stats JSON. NPC, spell, and quest endpoints return name and canonical URL by numeric ID.
Item, NPC, Spell, and Quest Lookups
The get_item endpoint accepts a Wowhead item ID and returns 10 fields: id, name, icon, link, class, subclass, level, quality, json, and jsonEquip. The quality field maps to tier names like Legendary or Epic; jsonEquip contains raw stat data suitable for parsing into numeric attributes. By contrast, get_npc, get_spell, and get_quest each return only id, name, and url — useful for resolving a numeric ID to a display name and canonical page link.
Database List and Search
The get_database_list endpoint accepts a category parameter (items, npcs, spells, or quests) and an optional page integer, returning up to 50 results sorted by popularity. The response includes a count field and a results array whose shape varies by category — NPC entries include level, while item entries include a raw data blob. The search endpoint accepts a free-text query and returns results grouped into category buckets (items, npcs, etc.), making it suitable for autocomplete or cross-entity lookup.
News and Events
get_news fetches up to 40 articles per request from the Wowhead RSS feed. The optional category parameter accepts values like retail, classic, classic-era, classic-seasonal, diablo, and diablo-4, defaulting to all. Each article in the items array includes title, link, pubDate, category, and description. For full article body, get_news_article accepts a full article URL or news ID and returns title, author, and content_raw in BBCode markup.
Today in WoW Events
get_today_in_wow accepts a region parameter (US or EU) and returns an array of event group objects. Each object includes id, name, regionId, and a groups array with detailed event information. The response also includes a timestamp field in ISO 8601 UTC indicating when the data was fetched, useful for cache invalidation in applications tracking daily reset content.
- Build a WoW item comparison tool using
get_itemquality, level, class, subclass, and equip stats fields. - Populate an autocomplete search bar for WoW entities using the
searchendpoint's category-grouped results. - Track current WoW daily events and raid availability by polling
get_today_in_wowfor US and EU regions. - Aggregate WoW news feeds by game version (retail, classic, classic-era) using
get_newswith the category filter. - Resolve NPC or spell IDs from combat log data to display names using
get_npcandget_spell. - Build a WoW news reader that fetches article summaries via
get_newsand full BBCode content viaget_news_article. - Paginate through the most popular items or NPCs in a category using
get_database_listfor bulk data collection.
| 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 Wowhead have an official public developer API?+
What does `get_item` return beyond a name and icon?+
name and icon, get_item returns class (e.g. Weapons), subclass (e.g. One-Handed Swords), level (item level), quality (tier name such as Legendary or Epic), json (raw item data JSON), jsonEquip (raw equip stat JSON), and a link pointing to the canonical Wowhead item page.Does the API return tooltip HTML or stat breakdowns for spells, quests, and NPCs the way it does for items?+
get_item. The get_npc, get_spell, and get_quest endpoints each return only id, name, and url. You can fork the API on Parse and revise it to add richer detail endpoints for those entity types.How fresh is the data returned by `get_today_in_wow`?+
get_today_in_wow response includes a timestamp field in ISO 8601 UTC indicating when the event data was fetched. You can compare this against the current time to determine data age. WoW daily resets vary by region — US and EU have different reset times — which is why the endpoint accepts a region parameter.Can I retrieve item or NPC data for WoW Classic separately from retail?+
get_news endpoint supports Classic-specific categories (classic, classic-era, classic-seasonal), but the item, NPC, spell, and quest lookup endpoints do not currently accept a game-version parameter — they target the main Wowhead database. You can fork the API on Parse and revise it to point lookups at the Wowhead Classic subdomain for Classic-specific entity data.