1stDibs Scraper

Extract item listings from 1stDibs — the leading online marketplace for antique, vintage, and contemporary furniture, jewelry & watches, fine art, and fashion, curated from thousands of trusted dealers worldwide. Search by keyword or browse by category and retrieve price, seller, condition/period, designer, country, and images for every item. No login, proxy, or CAPTCHA required.

What this actor does

• Search by keyword across all categories, or browse by category — 11 supported categories including Furniture, Jewelry & Watches, Art, and Fashion
• Rich filtering — price range and currency, period/era, style, material, place of origin, item location, gender, color, on-sale, returnable, top-seller, customizable, and Strategic Partner listings
• Sort results by best match, newest, or price (low-to-high / high-to-low)
• Optional extended item details — full description, condition, materials, place of origin, reference number, full photo gallery, and category-specific specs from each item's own product page
• Automatic pagination up to your chosen item limit
• Empty fields are omitted from each record — no null, empty string, or empty array fields

Output per item

Each record represents one 1stDibs item.

Field	Type	Description
itemId	string	1stDibs internal item ID
title	string	Item title / description
price	number	Listed price, converted to the requested currency (falls back to USD if that item has no conversion on file)
currency	string	Currency the price field is denominated in
discountPercent	integer	Percent markdown off the original price, when the item is on sale (e.g. Saturday Sale, or scattered markdowns on regular listings) — omitted for full-price items
category	string	Item sub-category (e.g. "Chairs", "Wrist Watches")
categoryCode	string	1stDibs internal category code
vertical	string	Top-level vertical (furniture, jewelry, art, fashion)
creator	string	Designer / manufacturer / brand, when documented
period	string	Era or creation date (e.g. "1960s", "Contemporary")
sellerName	string	Dealer / gallery name
country	string	Seller's country
isSold	boolean	Whether the item has already sold
hasVideo	boolean	Whether the listing includes a seller-uploaded video walkthrough
dimensions	string	Height/width/depth, when the dealer documents them — populated on every run, no includeItemDetails required (overwritten by a richer imperial+metric string when includeItemDetails is enabled)
imageUrl	string	Primary item image URL
itemUrl	string	Direct link to the item on 1stDibs
images	array	Full photo gallery for the item, in the dealer's own display order (only with includeItemDetails: true)
description	string	Full item description (only with includeItemDetails: true)
condition	string	Condition summary, e.g. "Good; Repaired. Wear consistent with age and use." (only with includeItemDetails: true)
materials	string	Materials and techniques, e.g. "Bentwood" (only with includeItemDetails: true)
placeOfOrigin	string	Country/region the item was made in (only with includeItemDetails: true)
referenceNumber	string	1stDibs reference number (only with includeItemDetails: true)
specifications	object	Category-specific attributes the item documents — e.g. ringSize, metal, stone, stoneCut for jewelry, or medium, movementAndStyle for art (only with includeItemDetails: true, only present when the item documents such specs)

Example record

{
  "itemId": "f_45324912",
  "title": "Vintage Thonet Bentwood Oak Chair With Original Label, Czechoslovakia, 1920s",
  "price": 722.87,
  "currency": "USD",
  "category": "Chairs",
  "categoryCode": "F_SEA_CHA",
  "vertical": "furniture",
  "creator": "Thonet",
  "period": "1920s",
  "sellerName": "Designoza",
  "country": "Slovakia",
  "isSold": false,
  "imageUrl": "https://a.1stdibscdn.com/vintage-thonet-bentwood-oak-chair-with-original-label-czechoslovakia-1920s-for-sale/f_66252/f_453249121749125900002/f_45324912_1749125900305_bg_processed.jpg",
  "itemUrl": "https://www.1stdibs.com/furniture/seating/chairs/vintage-thonet-bentwood-oak-chair-original-label-czechoslovakia-1920s/id-f_45324912/"
}

Input

Field	Type	Default	Description
mode	select	search	search (keyword) or browseCategory
keyword	string	rolex watch	Search term (mode=search) — e.g. rolex watch, mid century chair, oil painting
category	select	jewelry-watches	Category to browse (mode=browseCategory) — see Supported categories
period	select	–	Filter by era (mode=browseCategory only — see Supported periods). Ignored for New Arrivals and Saturday Sale
location	select	–	Filter by seller/item location (mode=browseCategory only — see Supported locations). Not supported for New Arrivals or Saturday Sale
style	select	–	Filter by design style (mode=browseCategory only — see Supported styles). Only applies to Furniture, Jewelry & Watches, and Art categories
material	select	–	Filter by material (mode=browseCategory only — see Supported materials). Only applies to Furniture and Art
origin	select	–	Filter by place of origin (search and browseCategory modes — see Supported origins). In browseCategory mode only applies to Furniture and Fashion
gender	select	–	Filter by gender — mens / womens (mode=browseCategory only). Only applies to Jewelry, Jewelry & Watches, Fashion, and Fashion — Handbags
color	select	–	Filter by item color — see Supported colors. Works in both modes
onSaleOnly	boolean	false	Only return items with a live markdown
returnableOnly	boolean	false	Only return items eligible for free returns
topSellerOnly	boolean	false	Only return items from 1stDibs-designated Top Seller storefronts
customizableOnly	boolean	false	Only return items available made-to-order or customizable on request
strategicPartnerOnly	boolean	false	Only return items from 1stDibs-designated Strategic Partner storefronts
sortBy	select	relevance	relevance / newest / price-low / price-high
minPrice	integer	–	Minimum item price, in the selected currency
maxPrice	integer	–	Maximum item price, in the selected currency
currency	select	USD	Currency to report prices in — USD / EUR / GBP / CAD / AUD / CHF / MXN / DKK / SEK / NOK
maxItems	integer	60	Maximum number of items to return (1–5000)
includeItemDetails	boolean	false	Fetch each item's product page for extended fields (description, condition, materials, place of origin, reference number, full photo gallery, specifications). Roughly doubles requests and run time

Filter combination notes: period, style, material, location, origin, and gender are each 1stDibs facets exposed as URL path segments in Browse by category mode, and the site only supports one such segment at a time — when more than one is set, this actor applies gender first (if set), otherwise period, then style, then material, then origin, then location, and ignores the rest, rather than silently return results that don't honor every requested filter. color, onSaleOnly, returnableOnly, topSellerOnly, customizableOnly, and strategicPartnerOnly are plain query filters and freely combine with everything and each other. Each select-type filter is also only supported for certain categories (see the tables below) — an unsupported combination is ignored rather than silently broadening the result set.

Supported categories

Value	Label
new-arrivals	New Arrivals
furniture	Furniture
furniture-seating	Furniture — Seating
furniture-lighting	Furniture — Lighting
furniture-tables	Furniture — Tables
art	Art
jewelry	Jewelry
jewelry-watches	Jewelry — Watches
fashion	Fashion
fashion-handbags	Fashion — Handbags
sale	Saturday Sale

Supported periods

Value	Label
18th-century-and-earlier	18th Century and Earlier
18th-century	18th Century
19th-century	19th Century
early-1900s	Early 1900s
early-20th-century	Early 20th Century
1910s – 1990s	1910s, 1920s, ..., 1990s
mid-20th-century	Mid-20th Century
late-20th-century	Late 20th Century
20th-century	20th Century
21st-century-and-contemporary	21st Century and Contemporary

Supported styles

Applies to Furniture (and its Seating/Lighting/Tables subcategories), Jewelry & Watches (and Jewelry), and Art. Each category only supports a subset of the full list below.

Category group	Supported styles
Furniture	Art Deco, Art Nouveau, Arts and Crafts, Baroque, Empire, Folk Art, Georgian, Hollywood Regency, Industrial, Louis XV, Louis XVI, Mid-Century Modern, Minimalist, Modern, Neoclassical, Regency, Rococo, Rustic, Scandinavian Modern, Victorian
Jewelry & Watches	Art Deco, Art Nouveau, Artisan, Baroque, Contemporary, Edwardian, Modern, Native American, Retro, Revival, Victorian
Art	Abstract, Abstract Expressionist, Art Deco, Color Field, Contemporary, Expressionist, Impressionist, Minimalist, Modern, Old Masters, Photorealist, Pop Art, Post-Impressionist, Post-War, Realist, Street Art, Surrealist

Supported locations

Value	Label
europe	Europe
usa-north-america	USA
canada-north-america	Canada
asia	Asia
australia	Australia
united-kingdom-europe	United Kingdom
france-europe	France
italy-europe	Italy
germany-europe	Germany
spain-europe	Spain
switzerland-europe	Switzerland
netherlands-europe	Netherlands
belgium-europe	Belgium
denmark-europe	Denmark
sweden-europe	Sweden

Supported materials

Applies to Furniture (and its Seating/Lighting/Tables subcategories) and Art. Each category only supports a subset of the full list below.

Category group	Supported materials
Furniture	Acrylic, Animal Skin, Bamboo, Brass, Bronze, Ceramic, Chrome, Cotton, Crystal, Fabric, Glass, Gold, Hardwood, Iron, Leather, Linen, Marble, Metal, Plastic, Porcelain, Rattan, Silk, Silver, Steel, Stone, Velvet, Wicker, Wood
Art	Bronze, Canvas, Ceramic, Fabric, Ink, Marble, Oil Paint, Paint, Paper, Photography, Print, Watercolor, Wood

Supported origins

Works in search mode (any category) and, in browseCategory mode, applies to Furniture (and its Seating/Lighting/Tables subcategories) and Fashion (and Fashion — Handbags).

Value	Label
european	Europe
italian	Italy
asian	Asia
north-american	North America
french	France
american	United States
scandinavian	Scandinavia
danish	Denmark

Supported colors

Works in search mode (any category) and, in browseCategory mode, applies to Furniture (and its Seating/Lighting/Tables subcategories), Art, and Fashion (and Fashion — Handbags).

Beige, Black, Blue, Brown, Gold, Gray, Green, Orange, Pink, Purple, Red, Silver, White, Yellow

Example: search for Rolex watches

{
  "mode": "search",
  "keyword": "rolex watch",
  "maxItems": 60
}

Example: browse mid-century furniture, newest first, under $5,000

{
  "mode": "browseCategory",
  "category": "furniture-seating",
  "sortBy": "newest",
  "maxPrice": 5000,
  "maxItems": 100
}

Example: browse Art Deco furniture with extended details

{
  "mode": "browseCategory",
  "category": "furniture",
  "style": "art-deco",
  "includeItemDetails": true,
  "maxItems": 60
}

Example: search for blue chairs priced in Euros

{
  "mode": "search",
  "keyword": "chair",
  "color": "blue",
  "currency": "EUR",
  "maxPrice": 5000,
  "maxItems": 60
}

Use cases

• Antique & vintage dealers — track competitor pricing and inventory across furniture, jewelry, art, and fashion
• Interior designers — source period-accurate furniture and decor filtered by style, era, and material
• Price monitoring & market research — build price benchmarks for a category or designer over time
• E-commerce catalog enrichment — pull structured listing data (price, dimensions, condition, images) into your own catalog
• Collectors & appraisers — research comparable sales for watches, jewelry, and fine art
• Trend analysis — spot which styles, periods, or materials are trending by sale volume and pricing

FAQ

How many items are available on 1stDibs? 1stDibs lists millions of items across furniture, jewelry & watches, art, and fashion from thousands of vetted dealers worldwide. A single category like Furniture can return over a million items.

Do I need an account or API key? No. The scraper accesses publicly available search and category pages without authentication, proxy, or cookies.

What currency are prices in? USD by default. Set currency to EUR, GBP, CAD, AUD, CHF, MXN, DKK, SEK, or NOK to get prices in that currency instead, using 1stDibs' own server-computed conversion for each item.

What is the price range filter for? Use minPrice and maxPrice to focus on items within your budget, in the currency you selected.

Why isn't every field always present? Not every item is documented with a creator, period, or seller country by the dealer. Only fields with real, verified data are included in each record — never blank placeholders.

What does includeItemDetails add? It fetches each item's own product page for a fuller description, condition report, materials, place of origin, reference number, complete photo gallery, and category-specific specifications (e.g. ring size for jewelry, medium for art). This is optional because it roughly doubles the number of requests and the run time.

Can I combine multiple category filters like period, style, and location at once? Some can — color and the on-sale/returnable/top-seller/customizable/Strategic-Partner toggles freely combine with everything. period, style, material, location, origin, and gender, however, are mutually exclusive facets on 1stDibs' own category pages, so only one of them is applied per run; see the Input table above for the precedence order.

Are sold items included? Yes, sold items can appear in results and are flagged with isSold: true so you can filter them out downstream if you only want active listings.

Is this an official 1stDibs product? No, this is a third-party actor that reads 1stDibs' publicly available search and category pages.