Spirit Halloween
The licensed Halloween costume specialist — category browse and per-size, per-color live stock for the lines it carries (today: KPop Demon Hunters).
Domain: spirithalloween.com
Also known as: Spirit Halloween, spirithalloween.com, Spirit Halloween Superstores
Prefer the capability
bowmark.costume_size_check covers this provider and routes around it when it is having a bad day. Reach for this page when you need spirithalloween.com specifically.
Call it directly
bowmark.providers.spirithalloween.search(args: { query: string; limit?: number }): Promise<SpiritHalloweenSearchResults>
bowmark.providers.spirithalloween.getProduct(args: { url: string }): Promise<SpiritHalloweenProduct>Functions
| Function | What it does |
|---|---|
search | Browses Spirit Halloween's category listing for a query resolved against a small internal directory of mapped categories (today: "KPop Demon Hunters" and its characters — rumi, mira, zoey,… |
getProduct | Reads one product page's full live size/color matrix — every real variant this product sells in, each with its own price and in-stock signal — for a product URL returned by search. |
Types
interface SpiritHalloweenSearchResult {
productId: string
sku: string
name: string
url: string
image: string | null
price: number | null
currency: "USD"
listedSize: string | null // the ONE size this listing row is indexed under
listedSizeStock: number | null // that size's stock only — not the full range
}
interface SpiritHalloweenSearchResults {
query: string
category: string
results: SpiritHalloweenSearchResult[]
totalMatches: number | null
}
interface SpiritHalloweenSizeVariant {
color: string
size: string // the site's own size label, e.g. "CHILD MEDIUM"
price: number
inStock: boolean
shipStockQuantity: number
variantId: string
}
interface SpiritHalloweenProduct {
productId: string
name: string
url: string
sizes: SpiritHalloweenSizeVariant[] // every real color/size combination, each with its own live stock
}Related
costume_size_check | Check one costume character's stock at one size, across Target, Walmart, and Spirit Halloween — the capability this provider backs. |
target | Also backs the same capability. |
walmart | Also backs the same capability. |