howbazaar.gg APIhowbazaar.gg ↗
Access How Bazaar game data via API: items, skills, merchants, and monster encounters with filters by hero, tier, size, and tag.
curl -X GET 'https://api.parse.bot/scraper/399e59d8-820c-4359-9761-fe29a4de9d62/get_items?tag=Weapon&tier=Gold' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for game items with optional filters. Returns item details including tiers, tooltips, tags, enchantments, combat encounters, and image URLs. All items are returned when no filters are specified.
| Param | Type | Description |
|---|---|---|
| tag | string | Filter by item tag. Matches against tags, hiddenTags, and customTags arrays on each item (e.g., Weapon, Shield, Potion, Apparel, Food, Tool, Tech, Aquatic, Friend, Loot, Relic, Vehicle, Toy). |
| hero | string | Filter by hero name. Returns items belonging to the specified hero or to Common. Accepted values include: Vanessa, Pygmalien, Dooley, Mak, Jules, Stelle, Common. |
| size | string | Filter by item size. Accepted values: Small, Medium, Large. |
| tier | string | Filter by starting tier. Accepted values: Bronze, Silver, Gold, Diamond, Legendary. |
| query | string | Search items by name (case-insensitive substring match). |
{
"type": "object",
"fields": {
"items": "array of item objects with id, name, startingTier, tiers, tags, hiddenTags, customTags, size, heroes, enchantments, quests, unifiedTooltips, combatEncounters, image_url",
"total": "integer count of items in the filtered result"
},
"sample": {
"data": {
"items": [
{
"id": "9e5e3d9e-ad05-4340-9071-4fccecb79695",
"name": "Butterfly Swords",
"size": "Small",
"tags": [
"Weapon"
],
"tiers": {
"Gold": {
"tooltips": [
"Cooldown 6 seconds",
"Multicast 3",
"Deal 10 Damage"
]
},
"Bronze": {
"tooltips": []
},
"Silver": {
"tooltips": [
"Cooldown 7 seconds",
"Multicast 2",
"Deal 10 Damage"
]
},
"Diamond": {
"tooltips": [
"Cooldown 5 seconds",
"Multicast 4",
"Deal 10 Damage"
]
},
"Legendary": {
"tooltips": []
}
},
"heroes": [
"Vanessa"
],
"quests": [],
"image_url": "https://howbazaar-images.b-cdn.net/images/items/9e5e3d9e-ad05-4340-9071-4fccecb79695.avif",
"customTags": [],
"hiddenTags": [
"Damage"
],
"enchantments": [
{
"type": "Golden",
"tooltips": [
"This has double value."
]
},
{
"type": "Heavy",
"tooltips": [
"Slow an item for 1 second(s)"
]
},
{
"type": "Icy",
"tooltips": [
"Freeze an item for 0.5 second(s)"
]
}
],
"startingTier": "Silver",
"unifiedTooltips": [
"Cooldown (7/6/5) seconds",
"Multicast (2/3/4)",
"Deal 10 Damage"
],
"combatEncounters": [
{
"cardId": "338f3c4b-9238-41d2-a0e0-0d825cded307",
"cardName": "Elite Duelist"
}
]
}
],
"total": 7
},
"status": "success"
}
}About the howbazaar.gg API
The How Bazaar API provides 4 endpoints covering the full game database at howbazaar.gg, including items, skills, merchants, and monster encounters. The get_items endpoint alone returns structured data across fields like startingTier, tiers, tags, hiddenTags, customTags, enchantments, quests, and image URLs, with optional filters by hero, size, tier, and tag. This makes it straightforward to query any slice of the game's content catalog programmatically.
Items and Skills
The get_items endpoint returns an array of item objects with fields including id, name, startingTier, tiers, tags, hiddenTags, customTags, size, heroes, enchantments, quests, and unifiedTooltips. You can filter by tag (matched against all three tag arrays), hero, size (Small, Medium, Large), tier (Bronze through Legendary), or a case-insensitive substring query on the item name. Calling it without any filters returns every item in the database along with a total count.
The get_skills endpoint mirrors this structure for skills, returning objects with id, name, startingTier, tiers, tags, hiddenTags, customTags, size, heroes, artKey, unifiedTooltips, and combat encounter data. It accepts the same hero, tier, and query filters. Both endpoints include image URLs, making them suitable for building visual reference tools.
Merchants and Monsters
The get_merchants endpoint takes no inputs and returns all in-game merchants with fields id, name, heroes, description, filters, and image_url. The filters field describes each merchant's sale configuration — which items or categories they deal in — making it useful for building shop-lookup tools or hero-specific merchant guides.
The get_monsters endpoint returns encounter data organized by game day. Each entry in the days array includes a day number and a groups array of monster encounters. Each encounter carries cardId, cardName, health, items, skills, and image_url. This structure lets you reconstruct the full encounter progression for a given run or display what a player can expect to face on any specific day.
- Build an item browser filtered by hero and tier for min-maxing build planning
- Generate a merchant directory showing which merchants serve each hero and what their sale filters cover
- Create a monster encounter timeline by consuming the
daysarray fromget_monsters - Display skill tooltips and artwork in a fan wiki or companion app using
unifiedTooltipsand image URLs - Cross-reference item enchantments with skills to identify synergies for a given hero
- Power a search-as-you-type item or skill lookup using the case-insensitive
queryparameter - Filter all Bronze-tier weapons for a specific hero to produce new-player gear guides
| 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 How Bazaar have an official developer API?+
How does hero filtering work across `get_items` and `get_skills`?+
hero string parameter. When set, results include items or skills that belong to the specified hero as well as those tagged as Common, since Common items are available to all heroes. Omitting the parameter returns data across all heroes.Does the API return player account data, run history, or leaderboard stats?+
Are there pagination controls for large result sets from `get_items`?+
total count alongside the full results array. There are no pagination parameters like page or limit in the current implementation — all matching records are returned in a single response. You can fork the API on Parse and revise it to add offset-based or cursor-based pagination.What does the `tiers` field on an item contain versus `startingTier`?+
startingTier is the base rarity tier at which an item enters the game (e.g., Bronze, Silver). The tiers field is an array containing the tier-specific variants of the item, each with its own tooltip and stat data, representing the item's full upgrade path.