Sam Ash Music Scraper

Scrape Sam Ash Music — search or browse musical instruments and gear by keyword, category, brand, price, stock status and sale/new-arrival badges, or look up exact products by SKU / model number. No login, no cookies, no paid proxy required.

What this actor does

• Two modes: search (keyword and/or category/brand browse) and bySkus (exact SKU/model-number lookup)
• Full department coverage: Guitars, Bass Guitars, Drums & Percussion, Live Sound & Lighting, Microphones & Wireless, Recording, Band & Orchestra, Pianos & Keyboards, Cables, DJ & Production, Music Education & Gifts, Used Instruments, Sale, and more
• 300+ brand filter: exact-match dropdown covering every brand carried by Sam Ash, from Yamaha and Gibson down to boutique pedal and accessory makers
• 6 sort orders: best match, most popular, price (both directions), newest, best sellers
• Price, stock, sale, new-arrival, and condition filters — including condition (New / Used / Open Box / B-Stock / Demo) for gear-marketplace and secondhand-inventory use cases
• Empty fields are omitted — every record only contains data that was actually found

Output per product

• sku — Sam Ash SKU
• productId — internal product ID
• title — product name
• brand
• price — current selling price (USD)
• msrp — list price, only included when it reflects a genuine discount
• inStock — boolean
• onSale — boolean
• isNewArrival — boolean
• isPriceDrop — boolean, true when the product carries a recent price-drop flag (distinct from onSale)
• hasPromotion — boolean, true when the product is eligible for an additional merchandising promotion
• badges[] — merchandising badges (e.g. financing offers)
• description — cleaned plain-text description (only when the catalog carries real copy)
• imageUrl — product photo (800×800)
• productType
• condition — New / Used / Open Box / B-Stock / Demo, only included when the catalog listing declares one (most regular new-stock items don't carry this facet)
• department — top-level category
• categoryPath[] — full category breadcrumb
• sourceUrl — canonical Sam Ash product page
• recordType: "product", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / bySkus
searchQuery	string	–	Free-text keyword search (mode=search)
category	string (select)	–	Top-level department filter
brand	string (select)	–	Exact brand/manufacturer filter (300+ options)
condition	string (select)	–	Exact condition filter: New / Used / Open Box / B-Stock / Demo (mode=search)
sortBy	string (select)	relevance	relevance / popularity / priceLowToHigh / priceHighToLow / newest / bestSelling
minPrice	integer	–	Drop products priced below this (USD)
maxPrice	integer	–	Drop products priced above this (USD)
inStockOnly	boolean	false	Only in-stock products
onSaleOnly	boolean	false	Only on-sale products
newArrivalsOnly	boolean	false	Only new-arrival products
priceDropOnly	boolean	false	Only products with a recent price-drop flag (distinct from onSaleOnly)
skus	array	–	Exact SKUs / model numbers (mode=bySkus)
maxItems	integer	50	Hard cap on emitted records (1–500)

Example: keyword search with filters

{
  "mode": "search",
  "searchQuery": "electric guitar",
  "brand": "Fender",
  "minPrice": 200,
  "maxPrice": 1500,
  "inStockOnly": true,
  "sortBy": "priceLowToHigh",
  "maxItems": 100
}

Example: browse a category without a keyword

{
  "mode": "search",
  "category": "Drums & Percussion",
  "onSaleOnly": true,
  "sortBy": "bestSelling",
  "maxItems": 50
}

Example: exact SKU lookup

{
  "mode": "bySkus",
  "skus": ["GES35500N", "TM80VTGXX"]
}

Use cases

• Price monitoring — track prices and sale status for specific gear over time
• Inventory intelligence — check stock availability across brands/categories
• Competitive research — benchmark musical-instrument retail pricing
• Catalog enrichment — pull structured product data (brand, category, images) for a list of SKUs
• Deal discovery — surface on-sale or new-arrival products in a category

FAQ

Is a login or cookie required? No. The actor uses Sam Ash's public product-search API and requires no account, cookies, or paid proxy.

Why is msrp sometimes missing? It's only included when it's genuinely higher than the current price (i.e., a real discount). When msrp equals price, it's omitted to avoid a redundant field.

Why is description missing on some products? Some catalog entries only reference an internal content block rather than carrying real descriptive text; those are omitted rather than emitting placeholder markup.

Can I combine category and brand and keyword search together? Yes — searchQuery, category, brand, and condition all combine (AND) in search mode, along with any of the price/stock/sale/new-arrival filters.

How is condition different from the "Used Musical Instruments" category? category: "Used Musical Instruments" is a merchandising department that groups a curated set of secondhand listings. condition is a per-product attribute (New / Used / Open Box / B-Stock / Demo) that appears across many departments — e.g. an open-box guitar amp still lives under "Live Sound & Lighting", not "Used Musical Instruments". Use condition when you want every non-new listing regardless of department; only a minority of catalog items carry this attribute at all (most standard new-stock products omit it, and the field is omitted from their output records).

What if a SKU in bySkus doesn't exist? It's skipped silently; the actor still returns any SKUs that do match.

Are product page URLs (sourceUrl) safe to open? Yes — they're the real, canonical Sam Ash product pages and resolve with a normal 200 response for any visitor or link-checker.

How fresh is the data? Prices and stock status reflect Sam Ash's live product-search index at the time the actor runs.