Tool Nut Scraper

Scrape Tool Nut's power-tool, hand-tool, and hardware catalog. Search by keyword, browse a category, browse the entire catalog, or look products up directly by handle/URL. Get real brand, price, stock status, images, and specifications for every product. HTTP-only via Tool Nut's public storefront endpoints. No auth, no cookies, no proxy required.

What this actor does

• Five modes: search, browseCollection, browseAll, byProductHandles, listCollections
• Filters: brand/vendor, product type, price range, in-stock only
• Category discovery: enumerate every category (collection) Tool Nut publishes, with product counts
• Empty fields are omitted

Output per product

• productId, handle, title, url
• vendor — brand (e.g. Milwaukee, DeWALT, Bosch, Makita)
• productType, tags[]
• description — plain-text (HTML stripped)
• priceMin, priceMax, currency
• inStock, sku, variantsCount
• imageUrl, images[]
• createdAt, updatedAt
• sourceCollection (when found via browseCollection), matchedQuery (when found via search)
• recordType: "product", scrapedAt

Output per category (mode=listCollections)

• collectionId, handle, title, url
• description, productsCount, imageUrl, updatedAt
• recordType: "collection", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / browseCollection / browseAll / byProductHandles / listCollections
searchQuery	string	cordless drill	Free-text query (mode=search)
collectionHandle	select	hand-tools	Curated category (mode=browseCollection)
customCollectionHandle	string	–	Override with any category handle/URL
productHandles	array	–	Product handles or URLs (mode=byProductHandles)
vendor	string	–	Filter to an exact brand name
productType	string	–	Filter to product types containing this text
priceMin	number	–	Drop products priced below this
priceMax	number	–	Drop products priced above this
inStockOnly	bool	false	Only emit in-stock products
maxItems	int	25	Hard cap (1–500)

Example: search with brand + price filter

{
  "mode": "search",
  "searchQuery": "impact driver",
  "vendor": "Milwaukee",
  "priceMax": 300,
  "maxItems": 40
}

Example: browse a category

{
  "mode": "browseCollection",
  "collectionHandle": "circular-saw-blades",
  "inStockOnly": true,
  "maxItems": 100
}

Example: lookup specific products

{
  "mode": "byProductHandles",
  "productHandles": [
    "milwaukee-2505-22-m12-fuel-brushless-installation-4-in-1-drill-driver-2-0ah-kit",
    "https://www.toolnut.com/products/bosch-11335k-jack-35-lb-breaker-hammer"
  ]
}

Example: discover categories

{
  "mode": "listCollections",
  "maxItems": 200
}

Use cases

• Price monitoring — track power-tool pricing across brands over time
• Assortment analysis — see how many SKUs a category/brand carries and their stock status
• Competitive research — compare a supplier's catalog against Tool Nut's listings
• Procurement — bulk-pull SKUs and specs for a shopping list of product handles
• Content/affiliate sites — pull real product images, descriptions, and prices for tool roundups

FAQ

What's Tool Nut? An online retailer of power tools, hand tools, saw blades, and shop consumables from brands like Milwaukee, DeWALT, Bosch, Makita, Festool, and Klein. See toolnut.com.

Is there a rate limit? No documented hard cap for normal use; the actor paces requests with small delays and bounded concurrency to stay polite.

Why is search capped at ~10 results per query? search mode uses Tool Nut's predictive-search JSON endpoint, which Shopify hard-caps at 10 matches regardless of the requested limit — but it returns full product data (brand, type, price, stock, description) in a single reliable request. For more than 10 results on a topic, use browseCollection (pick the closest matching category) or browseAll with a productType/vendor filter instead.

What's the difference between collectionHandle and customCollectionHandle? collectionHandle is a curated dropdown of common categories. customCollectionHandle accepts any category handle or full URL — useful for the 400+ categories not in the dropdown (pick other in the dropdown and set this field).

Are prices per-variant or per-product? priceMin/priceMax reflect the lowest/highest priced variant on the product (most products have one variant; some tool kits offer multiple bundle options).

How fresh is the data? Real-time — every request hits Tool Nut's live storefront, so prices and stock status reflect the current catalog.