# Wowhead — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access comprehensive World of Warcraft game data including items, NPCs, spells, and quests, plus stay updated with the latest WoW news and in-game events. Search the complete Wowhead database and read individual news articles to keep informed about current happenings in the game.

**Category:** Entertainment | **Website:** [wowhead.com/](https://wowhead.com/) | **Docs:** [parse.bot/marketplace/dcf24c30-539c-47c6-ad80-e754dfb7e99e/wowhead-com-api](https://parse.bot/marketplace/dcf24c30-539c-47c6-ad80-e754dfb7e99e/wowhead-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-wowhead-com-api-dcf24c30/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_database_list

Retrieve a paginated list of entities from a Wowhead database category, sorted by popularity. Returns up to 50 results per page. Results vary by category: NPCs include name, level, type, location; items include id and embedded data objects.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Database category to list. |
| `page` | integer | No | Page number for pagination (50 results per page). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wowhead-com-api-dcf24c30/get_database_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### get_item

Retrieve detailed information about a World of Warcraft item by its numeric ID. Returns rich XML-sourced data including name, quality tier, item level, class/subclass, full HTML tooltip, raw JSON stats, and equip data. The XML endpoint provides the most complete item data available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | Wowhead item ID (numeric string, e.g. '19019' for Thunderfury). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wowhead-com-api-dcf24c30/get_item \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>"}'
```

### get_news

Retrieve the latest news articles from Wowhead via RSS feed. Returns up to 40 articles with title, link, publication date, category, and description summary.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | News category to filter by. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wowhead-com-api-dcf24c30/get_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### get_news_article

Retrieve the full content and metadata for a specific Wowhead news article. Returns the article title, author, and full content in raw BBCode markup. Accepts either a full Wowhead news URL or a numeric news ID.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `article_url` | string | Yes | Full Wowhead news article URL (e.g. 'https://www.wowhead.com/news=381829/...') or a numeric news ID (e.g. '381829'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wowhead-com-api-dcf24c30/get_news_article \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"article_url":"<string>"}'
```

### get_npc

Retrieve basic information about a World of Warcraft NPC by its numeric ID. Returns the NPC name, ID, and canonical Wowhead URL. Uses the XML endpoint with HTML fallback for name extraction.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `npc_id` | string | Yes | Wowhead NPC ID (numeric string, e.g. '15956' for Anub'Rekhan). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wowhead-com-api-dcf24c30/get_npc \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"npc_id":"<string>"}'
```

### get_quest

Retrieve basic information about a World of Warcraft quest by its numeric ID. Returns the quest name, ID, and canonical Wowhead URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `quest_id` | string | Yes | Wowhead quest ID (numeric string, e.g. '7787' for Rise, Thunderfury!). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wowhead-com-api-dcf24c30/get_quest \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"quest_id":"<string>"}'
```

### get_spell

Retrieve basic information about a World of Warcraft spell by its numeric ID. Returns the spell name, ID, and canonical Wowhead URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `spell_id` | string | Yes | Wowhead spell ID (numeric string, e.g. '133' for Fireball). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wowhead-com-api-dcf24c30/get_spell \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"spell_id":"<string>"}'
```

### get_today_in_wow

Retrieve current game events, raid data, and daily information (Today in WoW). Returns structured event groups for the specified game region, including Mythic+ affixes, seasonal caps, world quests, and active events.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `region` | string | No | Game region. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wowhead-com-api-dcf24c30/get_today_in_wow \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region":"<string>"}'
```

### search

Full-text search across all Wowhead database categories (Items, NPCs, Spells, Quests, etc.). Returns the query string and an object with results grouped by category. Each category key contains an array of matching entities with their metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'Thunderfury', 'Fireball'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wowhead-com-api-dcf24c30/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```