Miniature Market Scraper

Scrape Miniature Market — a major U.S. tabletop-game retailer with 30,000+ SKUs across board games, miniatures, trading card games, RPGs, and hobby accessories. Search by product/game name or browse any of 85 real store categories and sub-categories (by game system, publisher line, age range, or deals section), then filter by price range, stock status, and manufacturer. HTTP-only — no login, no cookies, no paid proxy required.

What this actor does

• Two modes: search (free-text query) and category (browse the site's real navigation taxonomy)
• 85 categories — top-level departments (Board Games, Miniatures Games, Trading Card Games, Role Playing Games, Collectible Miniatures, Accessories, Family Friendly Games, Deals) plus real sub-categories by game system (Warhammer, Magic: The Gathering, Pokémon, Dungeons & Dragons, Pathfinder, Battletech, and more), by age range, and by deal type (clearance, last chance, daily deal)
• Filters: price range (min/max), in-stock-only (excludes preorders), manufacturer/brand substring match, and 8 sort orders
• Pricing detail: current price, original list price, and computed discount percentage when the item is on sale
• Empty fields are omitted — every record only contains fields Miniature Market actually published for that product

Output per product

• title — product name
• productUrl / sourceUrl — canonical product page URL
• imageUrl — product photo
• price — current selling price (USD)
• listPrice — original/retail price, only present when the item is discounted
• discountPercent — percentage off list price, only present when discounted
• currency — always USD
• sku — Miniature Market's product/order number
• brand — manufacturer/publisher (e.g. Games Workshop, Wizards of the Coast)
• category — the category the product was found under
• availability — In Stock or Preorder
• inStock — boolean form of availability
• productId — Miniature Market's internal product identifier
• recordType: "product", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search or category
searchQuery	string	Catan	Free-text query (mode=search)
category	string	–	One of 85 category/sub-category values (mode=category)
sortBy	string	bestResult	bestResult / nameAsc / nameDesc / priceAsc / priceDesc / topseller / newItems / newlyListed
minPrice	number	–	Drop products cheaper than this (USD)
maxPrice	number	–	Drop products more expensive than this (USD)
inStockOnly	boolean	false	Exclude preorder items
manufacturerContains	string	–	Case-insensitive substring match on brand/manufacturer
maxItems	int	50	Hard cap (1–5000)

Example: search for a popular game

{
  "mode": "search",
  "searchQuery": "Catan",
  "maxItems": 25
}

Example: browse Warhammer miniatures, in stock only, sorted by price

{
  "mode": "category",
  "category": "miniaturesWarhammer",
  "inStockOnly": true,
  "sortBy": "priceAsc",
  "maxItems": 50
}

Example: browse clearance deals under $30

{
  "mode": "category",
  "category": "dealsClearance",
  "maxPrice": 30,
  "maxItems": 100
}

Example: search filtered by manufacturer and price range

{
  "mode": "search",
  "searchQuery": "starter deck",
  "manufacturerContains": "Wizards of the Coast",
  "minPrice": 10,
  "maxPrice": 50
}

Use cases

• Price monitoring — track a game's current price and discount over time
• Inventory research — check stock/preorder status across a publisher's catalog
• Market research — compare hobby-retail pricing for a game system (Warhammer, Magic, Pokémon, D&D)
• Deal hunting — bulk-export the clearance and last-chance sections
• Catalog enrichment — feed product images, SKUs, and brand data into an internal catalog

FAQ

What is the data source? Miniature Market's public storefront (miniaturemarket.com). No account, login, or API key is used.

Is this affiliated with Miniature Market? No — this is an independent third-party actor that reads publicly available storefront pages.

Why do some products have no listPrice or discountPercent? Those fields only appear when Miniature Market shows a separate "was" price — i.e. the item is currently marked down. Full-price items only have price.

What does availability: "Preorder" mean? The product is a confirmed pre-order (not yet shipping). Set inStockOnly: true to exclude these.

Are there rate limits? The actor makes plain page requests with polite delays between pages; no login or special access is required. Very large maxItems values on a broad, unfiltered browse may take longer since pagination is sequential.

Why is category a fixed list instead of free text? Miniature Market's category URLs are stable, human-readable slugs, so every reliably working category and sub-category is enumerated directly — no risk of typos returning zero results.

Can I filter by manufacturer directly as a dropdown? Miniature Market lists hundreds of manufacturers with no stable public ID scheme, so manufacturerContains is a substring filter applied to the brand name returned with each product instead of a fixed list.

Data Source / Limitations

• Prices and stock are the retailer's live listing-page values, refreshed the moment a page is requested.
• manufacturer/brand filtering is a substring match on the brand name shown per product listing, not a curated dropdown of every publisher (the site does not expose a small, stable manufacturer list).
• Only products that appear in a search or category listing page are returned; the site does not publicly list fully sold-out (zero-stock, non-preorder) items in these views.