1stDibs Luxury Antiques Scraper

Scrape luxury antiques, vintage furniture, jewelry, art, and fashion from 1stDibs — the world's largest online marketplace for premium vintage and antique items. Search by keyword, browse by category, designer/creator, or seller/dealer, or pull full specs for individual listings by URL — with pricing, materials, period, condition, dimensions, and seller information.

What this actor does

• Five modes: search, byCategory, byDesigner, bySeller, productDetails
• 25 curated categories across furniture, jewelry, art, and fashion (with sub-categories such as chairs, sofas, rings, paintings, etc.)
• Sort order: recommended, newest, price high-low, price low-high, popular
• Price filters: min/max price in USD
• Period, style, and item-location filters for search/byCategory — narrow results to an era (e.g. "1950s", "19th-century"), a design style (e.g. "mid-century-modern", "art-deco", "victorian"), or a region (USA & North America / Europe)
• Rich item data: designer/creator, price, category, style, materials, origin, period, condition, dimensions, seller rating and tier, reference numbers, images, and (where available) a video
• Empty fields are omitted — no null values in output

Output per item

Field	Description	Available in
itemId	1stDibs item ID	all modes
title	Item title	all modes
designer	Designer/creator name	all modes
designerRole	Creator's role, e.g. "Artist"	productDetails
designerUrl	Designer/creator page URL	all modes
price	Price (numeric)	all modes
currency	Currency code (USD/EUR/GBP/JPY)	all modes
category	Item category (full breadcrumb in productDetails)	all modes
style	Design style, e.g. "Mid-Century Modern"	productDetails
materials	Materials list	all modes
origin	Country/place of origin	productDetails
period	Historical period	productDetails
dateOfManufacture	Manufacture date/decade	productDetails
condition	Item condition	productDetails
conditionDetails	Condition detail description	productDetails
dimensions	Height/width/depth	productDetails
sellerLocation	Seller city/region	all modes
sellerRating	Seller star rating	productDetails
sellerReviewCount	Seller review count	productDetails
sellerTier	Seller tier badge, e.g. "Gold Seller"	productDetails
sellerEstablishedYear	Year the seller's business was established	productDetails
sellerSince	Year the seller joined 1stDibs	productDetails
sellerSalesCount	Total sales on 1stDibs	productDetails
sellerResponseTime	Typical seller response time	productDetails
sellerReferenceNumber	Seller's own SKU/reference	productDetails
listingReferenceNumber	1stDibs' own reference number	productDetails
description	Item description	all modes
imageUrl	Primary image URL	all modes
images	Full image URL array	productDetails
videoUrl	Item video URL (if the listing has one)	productDetails
productUrl	1stDibs product URL	all modes
recordType	Always "item"	all modes
scrapedAt	ISO 8601 timestamp	all modes

Input

Field	Type	Default	Description
mode	string	search	search / productDetails / byCategory / byDesigner / bySeller
keyword	string	mid-century chair	Search keyword (mode=search)
category	string	furniture	Category/browse path — used by byCategory, byDesigner (sub-category) and search (vertical)
designer	string	—	Designer/creator name, e.g. "Charles Eames" (mode=byDesigner)
sellerSlug	string	—	Seller/dealer storefront slug, e.g. "giorgio-collection" (mode=bySeller)
productUrls	array	—	Full 1stDibs product page URLs (mode=productDetails)
sortBy	string	recommended	recommended / newest / price-high / price-low / popular
priceMin	integer	—	Min price in USD
priceMax	integer	—	Max price in USD
period	string	—	Historical period/era, e.g. "1950s", "19th-century" (mode=search/byCategory only)
style	string	—	Design style, e.g. "mid-century-modern", "art-deco" (mode=search/byCategory only)
itemLocation	string	"" (anywhere)	usa-north-america / europe (mode=search/byCategory only)
maxItems	integer	20	Max items (1–300)

Example: search mid-century furniture

{
  "mode": "search",
  "keyword": "mid-century chair",
  "priceMax": 10000,
  "sortBy": "newest",
  "maxItems": 20
}

Example: search a specific period and style

{
  "mode": "search",
  "keyword": "chair",
  "period": "1950s",
  "maxItems": 20
}

{
  "mode": "byCategory",
  "category": "furniture/seating/chairs",
  "style": "art-deco",
  "maxItems": 20
}

Example: browse a designer's jewelry

{
  "mode": "byDesigner",
  "designer": "Cartier",
  "category": "jewelry",
  "maxItems": 30
}

Example: full specs for specific listings

{
  "mode": "productDetails",
  "productUrls": [
    "https://www.1stdibs.com/furniture/decorative-objects/sculptures/abstract-sculptures/1980s-pedro-friedeberg-miniature-hand-foot-chair-sculpture-latin-american/id-f_30479102/"
  ]
}

Use cases

• Interior design & staging — source vintage furniture and decorative objects by style, period, or price range for client projects
• Antiques dealers & resellers — monitor new listings by category or track a specific designer's catalog for arbitrage opportunities
• Jewelry & watch appraisal — pull comparable listings by designer (e.g. Cartier, Van Cleef & Arpels) to benchmark pricing
• Art market research — track paintings, sculptures, and photography listings by period and style across sellers
• Competitive intelligence for dealers — monitor a specific seller's storefront (bySeller) for new inventory and pricing changes
• Provenance & cataloging — pull full specs (materials, dimensions, condition, period) for individual listings by URL

Frequently Asked Questions

Does this require a 1stDibs account? No. This scraper uses 1stDibs' public website — no login, cookies, or API key needed.

What categories are available? 25 curated categories spanning Furniture (seating, tables, storage, lighting, decorative objects, rugs, silver, ceramics, porcelain), Jewelry (rings, necklaces, earrings, bracelets, watches), Art (paintings, sculptures, photography), and Fashion (clothing). See the category dropdown for the full list.

Are prices in USD? Prices are shown in the seller's listed currency (USD, EUR, GBP, JPY). The currency field indicates which.

Why does a listing sometimes have no price? Some sellers mark items "Contact for Price" rather than listing a fixed price; the actor omits the field rather than fabricating a value.

Limitations

• period, style, and itemLocation are mutually exclusive — only one applies per run. 1stDibs' own clean-URL routing supports only one browse facet beyond the base category at a time (confirmed live: combining any two, e.g. period + style or itemLocation + period, 404s). If more than one is set, itemLocation wins, then style, then period. They also only apply to mode=search and mode=byCategory — 1stDibs' byDesigner/bySeller URL routing does not support combining a facet with a creator/dealer storefront path.
• Price is not searchable server-side. 1stDibs does not expose a URL query parameter for price filtering, so priceMin/priceMax are applied client-side after each page is fetched — pages are still fetched fully and filtered in-actor, which is reliable but means very narrow price ranges scan more pages before filling maxItems.
• bySeller mode requires the exact dealer slug from the seller's own 1stDibs URL (e.g. 1stdibs.com/dealers/giorgio-collection/ → giorgio-collection), not a free-text business name.
• Seller display name is not exposed on listing pages or product pages by 1stDibs itself (only seller location, rating, and tier are shown there) — get the seller's name from the URL slug or by visiting their /dealers/{slug}/ storefront directly.
• imageUrl coverage in list modes (search/byCategory/byDesigner/bySeller) is best-effort, not 100%. 1stDibs virtualizes its tile grid — a tile's image only loads once it has genuinely scrolled into view, and the actor scrolls each tile into view before extracting to maximize coverage — but under the grid's own virtualization timing a portion of tiles per page (commonly a third to half) may still have no image by the time of extraction, while title/price/category/materials/sellerLocation/description are consistently 100% populated. For guaranteed image coverage on specific items, follow up with mode=productDetails on their productUrl — the product page's own gallery is not virtualized and always returns the full images array.