Chairish Furniture Scraper

Scrape vintage, antique and designer furniture and home-decor listings from chairish.com — the curated marketplace for one-of-a-kind furniture, art, lighting and decor. Browse any category, search by keyword, or fetch exact product/collection URLs. Returns price, condition, dimensions, material, color, seller and images. HTTP-only via the site's public schema.org structured data. No auth, no proxy, no cookies required.

What this actor does

• Four modes: collection (category browse), search (keyword), byUrls (exact URL lookup), bySeller (browse one seller's shop)
• Filters: min/max price (server-side facet), condition (New / Used server-side facet, Refurbished client-side), color (server-side facet, 17 swatches), design style (server-side facet, 49 styles), sets/pieces (server-side facet: single item / a pair / a set of 3+), on-sale-only (server-side facet), free-shipping-only (server-side facet), shipping-under-$50-only (server-side facet), availability (server-side facet: hide sold out / ready to ship), featured collection (server-side facet: new arrivals / A-List curated picks), item location (server-side facet: US / Europe, now applied server-side on both collection and search), min/max width, depth, and height in inches (server-side per-category dimension facet)
• Sort order: Curated, Newest, Price low-to-high, Price high-to-low, Most Favorited (mode=collection, search)
• Rich listing detail: dimensions (depth/height/width in inches), material, color, brand, category, seller name and region
• Multiple images per listing, capped at 10
• Empty fields are omitted — no null/blank/sentinel values in the output

Output per listing

• productId, title, productUrl, sourceUrl
• description
• price, currency, priceValidUntil, availability
• condition — New / Used / Refurbished
• category — Chairish's full taxonomy path (e.g. Furniture > Chairs > Arm Chairs, Recliners & Sleeper Chairs)
• color, material, brand
• depthIn, heightIn, widthIn — dimensions in inches
• sellerName, sellerImageUrl, sellerRegion, sellerLocality, sellerCountry
• sellerSlug — the Chairish shop slug queried; present only on mode=bySeller records
• sellerRating, sellerReviewCount — seller's aggregate rating (1-5 scale); only present on individual product-detail fetches (mode=byUrls, or when a listing/search result is opened for detail), not on collection/search listing pages
• discountPercentage, onSale — present when Chairish is currently running a markdown on the listing (scraped from the same results page, not a separate fetch); onSaleOnly filters to these
• taxonomyPath[] — Chairish's own internal category breadcrumb (e.g. ["Decor", "Room Accents & Accessories", "Candles & Home Fragrance", "Candle Holders", "Candelabras"]), more granular than category
• isLocalPickupAvailable, isMadeToOrder, isNewlyMade, isPromotedListing — real-time listing flags scraped from the same page (no extra fetch)
• imageUrl, imageUrls[]
• recordType: "product", scrapedAt

Input

Field	Type	Default	Description
mode	string	collection	collection / search / byUrls
collectionHandle	string	sofas	Category to browse (mode=collection) — fixed dropdown of curated Chairish collection slugs (only listed values are accepted; use byUrls for a collection slug not in the list)
searchQuery	string	mid century credenza	Keyword query (mode=search)
productUrls	array	–	Exact product or collection URLs (mode=byUrls)
sellerSlug	string	–	Seller/dealer shop slug or full /shop/<slug> URL (mode=bySeller)
minPrice / maxPrice	int	–	Price range in USD — applied server-side on collection/search via Chairish's own price facet, plus a post-filter safety net
condition	string	–	New / Used (applied server-side via Chairish's item_type facet) / Refurbished (client-side post-filter)
color	string	–	One of 17 Chairish color-swatch facets (e.g. Blue, Brown) — applied server-side on collection/search via Chairish's colors facet, plus a substring post-filter in every mode
style	string	–	Design style facet (e.g. Art Deco, Mid-Century Modern) — applied server-side on collection/search
setSize	string	–	1 (single item) / 2 (a pair) / 3P (a set of 3+) — applied server-side via Chairish's own "Sets/Pieces" facet on collection/search
onSaleOnly	boolean	false	Restrict to marked-down items — applied server-side on collection/search
freeShippingOnly	boolean	false	Restrict to items with free shipping — applied server-side on collection/search via Chairish's shipping_options facet
underFiftyShippingOnly	boolean	false	Restrict to items with shipping cost under $50 — applied server-side on collection/search via Chairish's shipping_options facet; ignored if freeShippingOnly is also on
availability	string	–	hideSoldOut / readyToShip — applied server-side on collection/search via Chairish's own misc_availability facet
featured	string	–	newArrivals / aList — applied server-side on collection/search via Chairish's own misc_featured facet
itemLocation	string	–	USA / Europe — applied server-side on collection/search via Chairish's own pickup_bloc_codes facet, plus a post-filter safety net against the listing's sellerCountry
minWidthIn / maxWidthIn	int	–	Width range in inches — applied server-side on collection/search/bySeller via Chairish's own per-category dimension facet, plus a post-filter safety net; listings without a published width always pass
minDepthIn / maxDepthIn	int	–	Depth range in inches — applied server-side on collection/search/bySeller via Chairish's own per-category dimension facet, plus a post-filter safety net; listings without a published depth always pass
minHeightIn / maxHeightIn	int	–	Height range in inches — applied server-side on collection/search/bySeller via Chairish's own per-category dimension facet, plus a post-filter safety net; listings without a published height always pass
sortBy	string	–	Curated / Newest / Price: Low to High / Price: High to Low / Most Favorited — collection/search
maxItems	int	30	Hard cap (1–500)

Example: browse vintage sofas under $3000

{
  "mode": "collection",
  "collectionHandle": "sofas",
  "maxPrice": 3000,
  "condition": "Used",
  "maxItems": 50
}

Example: search for a specific style

{
  "mode": "search",
  "searchQuery": "art deco mirror",
  "maxItems": 20
}

Example: browse a seller's shop

{
  "mode": "bySeller",
  "sellerSlug": "schumacher",
  "sortBy": "price",
  "maxItems": 50
}

Example: look up specific listings

{
  "mode": "byUrls",
  "productUrls": ["https://www.chairish.com/product/36569681/antique-rug-wingback-chair"]
}

Use cases

• Interior designers & stylists — source one-of-a-kind vintage and antique pieces by category, style, and dimensions for client projects.
• Vintage/antique resellers — monitor a competitor's or supplier's Chairish shop (bySeller) for new inventory and pricing.
• Price/market research — track pricing trends for a design style or category (e.g. Mid-Century Modern credenzas) over time.
• Home decor aggregators — pull curated collections of furniture and decor for a shopping or inspiration site.
• Deal hunting — filter for onSaleOnly or discounted listings across a category or seller's shop.

FAQ

Do I need a proxy or login? No. The actor reads chairish.com's public product pages directly — no cookies, no API key, no residential proxy.

Is this new or used furniture? Both — Chairish is a marketplace for vintage, antique, and new designer pieces from individual sellers and dealers; use the condition filter to narrow results.

How current is the data? Every run fetches live data at request time; nothing is cached. Sold/removed listings simply won't appear.

Can keyword search return exact matches? Chairish's search resolves a query to the closest matching category or filtered view (e.g. walnut credenza → the Credenzas category filtered to walnut); this mirrors the site's own search behavior.

Can I browse a specific seller's shop? Yes — use mode=bySeller with the seller's shop slug (e.g. schumacher) or full /shop/<slug> URL to get that seller's full catalog with the same filters as category/search browsing.

Are prices in USD? Yes — Chairish is a US-focused marketplace and all prices are listed in USD, regardless of seller location.

Why do some listings have fewer fields than others (e.g. no sellerRating)? Some fields, like seller rating/review count, are only present on individual product-detail pages, not on collection/search listing cards. Use mode=byUrls on a specific listing to get the fullest field set.

Does condition=Refurbished narrow results the same way as New/Used? Not quite — New and Used map to a real Chairish server-side facet, while Refurbished is applied as a post-filter on the scraped results since Chairish has no dedicated server-side facet for it.

Limitations

• Chairish is a US-focused marketplace; prices are in USD and sellers are predominantly US-based.
• collectionHandle accepts a curated list of the most common furniture/decor categories plus free-text override; the site has 190+ collections (including jewelry, books and seasonal collections outside furniture/decor scope).
• Individual seller shipping cost and lead time are not part of the structured listing data and are not included.