API QueryAuctionItems

Main Menu
WoW API Lua API FrameXML util Widget API Widget scripts XML schema Events CVars Macro commands Combat Log Escape sequences Hyperlinks API changes HOWTOs wowuidev

Will return information about items in the auction house. There must be a delay of about 3 second between queries. Use CanSendAuctionQuery() to determine if a query can be done.

QueryAuctionItems("name", "minLevel", "maxLevel", 
  invTypeIndex, classIndex, subclassIndex, 
  page, isUsable, qualityIndex, getAll
)

Arguments

(string type, string type, string type, index value, )

name

A part of the item's name (or the complete name) or "" for no retrenchment.

minLevel

Items below this level won't be returned. Either a number or "" for no restrictions.

maxLevel

Items above this level won't be returned. Either a number or "" for no restrictions.

invtypeIndex

Character's slotposition in which the item can be placed in. Can be one of the following values:

1 - Head slot (INVTYPE_HEAD)

2 - Neck slot (INVTYPE_NECK)

3 - Shoulder slot (INVTYPE_SHOULDER)

4 - Shirt slot (INVTYPE_BODY)

5 - Chest slot (INVTYPE_CHEST)

6 - Waist slot (INVTYPE_WAIST)

7 - Leg slot (INVTYPE_LEGS)

8 - Feet slot (INVTYPE_FEET)

9 - Wrist slot (INVTYPE_WRIST)

10 - Hand slot (INVTYPE_HAND)

11 - Finger slot (INVTYPE_FINGER)

12 - Trinket slot (INVTYPE_TRINKET)

13 - Back slot (INVTYPE_CLOAK)

14 - Weapon offhand slot (INVTYPE_HOLDABLE)

15 - Weapon mainhand slot (INVTYPE_WEAPONMAINHAND)

16 - Robe slot (INVTYPE_ROBE)

17 - Tabard slot (INVTYPE_TABARD)

18 - Container slot (INVTYPE_BAG)

19 - 2handed weapon (takes two slots) (INVTYPE_2HWEAPON)

20 - Ranged weapon slot (INVTYPE_RANGED)

21 - Shield slot (INVTYPE_SHIELD)

22 - Both weapon slots (INVTYPE_WEAPON)

0 or nil - no restrictions

classIndex

Items not in this class won't be returned. Index corresponds to the index returned by GetAuctionItemClasses() or nil for no restrictions.

subclassIndex

Items not in this subclass won't be returned. Index corresponds to the index used in GetAuctionItemSubClasses(index) or nil for no restrictions.

page

What page in the auctionhouse this shows up. Note that pages start at 0.

isUsable

Is useable by the player (nil = no restrictions)

qualityIndex

The items' quality (nil = no restrictions)

getAll

Download the ENTIRE auction house as one single page. Only allowed when CanSendAuctionQuery() returns true as its second return (~every 15 minutes). May disconnect people with low bandwidth. Also see notes on client-to-server traffic in GetAuctionItemInfo() (Added in 2.3) While this has been 'added', it is marked as **DISABLED UNTIL A FUTURE PATCH** and does appear to do nothing.

Example

QueryAuctionItems("",10, 19, nil, 2, nil, 0, nil, 3)

Result

Finds twink gear! (blue armor between lvl 10 and 19)

also, the First page is page (0) zero

Notes

It is unclear whether any invTypeIndex values work past 14.