# 1stDibs Listings Scraper (`automation-lab/1stdibs-listings-scraper`) Actor Scrape public 1stDibs furniture, art, jewelry, fashion, and decor listings with prices, sellers, creators, materials, dimensions, and images. - **URL**: https://apify.com/automation-lab/1stdibs-listings-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 1stDibs Listings Scraper Scrape public luxury furniture, art, jewelry, fashion, and decor listings from 1stDibs search, category, and product pages. Export titles, prices, dealers, locations, creators, materials, dimensions, condition notes, period, style, descriptions, and images for market research. ### What does 1stDibs Listings Scraper do? 1stDibs Listings Scraper turns public 1stdibs.com pages into a structured dataset. Give it search URLs, category URLs, detail URLs, or simple keywords, and it collects listing records that are ready for CSV, Excel, JSON, API, or database workflows. It is designed for public marketplace intelligence. The actor does not require a 1stDibs account and does not access private buyer, seller, or checkout data. ### Who is it for? - ๐Ÿ›‹๏ธ **Vintage furniture dealers** tracking competing chairs, tables, lighting, and decor. - ๐Ÿ–ผ๏ธ **Art and antiques researchers** comparing public asking prices and listing descriptions. - ๐Ÿ’Ž **Jewelry resellers** monitoring luxury and designer inventory. - ๐Ÿงพ **Appraisers** collecting comparable public listings for valuation notes. - ๐Ÿท๏ธ **Pricing analysts** building historical snapshots of high-end marketplace supply. - ๐Ÿ  **Interior design sourcing teams** exporting candidate pieces for client mood boards. ### Why use this actor? Manual 1stDibs research is slow because each listing can contain rich attributes: price, creator, material, period, place of origin, dimensions, condition, seller, and image assets. This actor automates the repetitive collection step so your team can focus on analysis. ### What data can you extract from 1stDibs? | Field | Description | | --- | --- | | `listingUrl` | Canonical public listing URL | | `listingId` | 1stDibs listing identifier when present | | `title` | Listing title | | `priceUsd` | USD price when visible in structured offer data | | `prices` | Currency-to-price map when multi-currency offers are present | | `seller` | Dealer, seller, creator, or maker text when visible | | `location` | Dealer/listing location | | `creator` | Designer, creator, manufacturer, or maker | | `category` | Listing category text | | `materials` | Materials and techniques | | `dimensions` | Dimensions text | | `condition` | Condition notes | | `period` | Period field | | `style` | Style field | | `placeOfOrigin` | Place of origin | | `dateOfManufacture` | Date of manufacture | | `description` | Public description | | `imageUrls` | Listing image URLs | | `sourceUrl` | Search, category, or detail URL that produced the row | ### How much does it cost to scrape 1stDibs listings? This actor uses pay-per-event pricing: a small $0.005 start event plus a formula-derived per-listing event. BRONZE users pay $0.000063448 per extracted listing, with lower per-listing prices on higher Apify tiers. A 1,000-listing BRONZE run is about $0.068 before any platform-side free allowances or tier differences. ### Input options You can use any combination of these inputs: - `startUrls` โ€” public 1stDibs search, category, or listing URLs. - `keywords` โ€” search terms such as `chair`, `Italian mirror`, or `Cartier bracelet`. - `category` โ€” choose all departments, furniture, art, jewelry, or fashion for keyword searches. - `maxItems` โ€” maximum listing rows to save. - `maxPages` โ€” maximum pagination pages per search/category URL. - `includeDetails` โ€” open each listing page for richer price and specification fields. ### Example input ```json { "keywords": ["chair"], "category": "furniture", "maxItems": 25, "maxPages": 2, "includeDetails": true } ```` ### Search URL examples ```json { "startUrls": [ { "url": "https://www.1stdibs.com/search/furniture/?q=chair" }, { "url": "https://www.1stdibs.com/furniture/seating/chairs/" } ], "maxItems": 50, "maxPages": 3, "includeDetails": true } ``` ### Detail URL example ```json { "startUrls": [ { "url": "https://www.1stdibs.com/furniture/seating/chairs/superb-antique-morris-chair-sikes-chair-co/id-f_43016952/" } ], "maxItems": 1, "includeDetails": true } ``` ### Output example ```json { "listingUrl": "https://www.1stdibs.com/furniture/seating/chairs/example/id-f_123456/", "listingId": "f_123456", "title": "Example Vintage Lounge Chair", "priceUsd": 4200, "priceCurrency": "USD", "seller": "Example Dealer", "location": "New York, NY", "creator": "Example Designer", "category": "Mid-20th Century Chairs", "materials": ["Leather", "Walnut"], "dimensions": "Height: 32 in Width: 28 in Depth: 30 in", "condition": "Good", "period": "Mid-20th Century", "style": "Mid-Century Modern", "placeOfOrigin": "United States", "description": "Public listing description...", "mainImageUrl": "https://a.1stdibscdn.com/example.jpg", "sourceType": "search", "searchQuery": "chair", "scrapedAt": "2026-06-09T00:00:00.000Z" } ``` ### How to scrape 1stDibs in 5 steps 1. Open the actor on Apify. 2. Add a 1stDibs search URL or enter one or more keywords. 3. Choose a category and set a small `maxItems` value for your first run. 4. Keep `includeDetails` enabled if you need prices, dimensions, and condition notes. 5. Start the run and download the dataset as CSV, Excel, JSON, or XML. ### Tips for better results - Use specific keywords like `Italian brass lamp` instead of only `lamp`. - Use category URLs when you want broad inventory monitoring. - Use detail URLs when you need a small set of known listings enriched. - Increase `maxPages` gradually for large research jobs. - Turn off `includeDetails` for faster lightweight discovery runs. ### Common use cases - ๐Ÿงฎ Build price comparison sheets for luxury furniture. - ๐Ÿ“ˆ Monitor new supply in a category over time. - ๐Ÿง‘โ€โš–๏ธ Collect comparable listings for appraisal research. - ๐Ÿ–ผ๏ธ Analyze material, period, and style language in art and antiques listings. - ๐Ÿ”” Feed listing URLs into alerting or enrichment workflows. ### Integrations Use the dataset with: - Google Sheets or Excel for manual review. - BI dashboards for price and category monitoring. - Internal appraisal tools for comparable listing libraries. - CRM workflows for sourcing and dealer research. - Apify integrations such as webhooks, Make, Zapier, and scheduled runs. ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/1stdibs-listings-scraper').call({ keywords: ['chair'], category: 'furniture', maxItems: 25, includeDetails: true, }); console.log(run.defaultDatasetId); ``` ### API usage with Python ```python from apify_client import ApifyClient import os client = ApifyClient(os.environ['APIFY_TOKEN']) run = client.actor('automation-lab/1stdibs-listings-scraper').call(run_input={ 'keywords': ['chair'], 'category': 'furniture', 'maxItems': 25, 'includeDetails': True, }) print(run['defaultDatasetId']) ``` ### API usage with cURL ```bash curl -X POST "https://api.apify.com/v2/acts/automation-lab~1stdibs-listings-scraper/runs?token=$APIFY_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"keywords":["chair"],"category":"furniture","maxItems":25,"includeDetails":true}' ``` ### MCP usage Connect this actor to Claude Desktop or Claude Code through Apify MCP: ```bash claude mcp add apify-1stdibs "https://mcp.apify.com/?tools=automation-lab/1stdibs-listings-scraper" ``` Claude Desktop JSON configuration: ```json { "mcpServers": { "apify-1stdibs": { "url": "https://mcp.apify.com/?tools=automation-lab/1stdibs-listings-scraper" } } } ``` Direct MCP URL: ```text https://mcp.apify.com/?tools=automation-lab/1stdibs-listings-scraper ``` Example prompts: - "Scrape 25 1stDibs furniture listings for Italian chairs and summarize price ranges." - "Collect public 1stDibs detail data for these listing URLs and make a comparison table." - "Find common materials and periods in the exported 1stDibs dataset." ### Scheduling For monitoring workflows, schedule the actor daily, weekly, or monthly. Keep the same keyword/category inputs and compare new datasets over time to spot new inventory, removed listings, or price changes. ### Data quality notes 1stDibs may hide prices for some listings or show "price upon request" style pages. In those cases, `priceUsd` can be `null`. Detail enrichment usually improves field coverage because listing pages expose more structured product data than search cards. ### Performance notes The actor is HTTP-only and does not launch a browser. Runs with detail enrichment make one extra request per listing. If you only need URLs and titles, disable `includeDetails` for faster runs. ### Limits and caveats - Only public pages are scraped. - Availability and price can change after a run. - Some seller/contact fields may be absent from public HTML. - Images are public CDN URLs and may include transformed sizes. - Website markup can change; report issues if important fields disappear. ### Legality This actor collects publicly available listing information. You should use the data responsibly, respect applicable laws and 1stDibs terms, avoid personal-data misuse, and consult legal counsel for regulated or high-risk use cases. ### FAQ and troubleshooting #### Why are some prices missing? Some 1stDibs listings do not expose a public price or only show price information in certain contexts. Keep `includeDetails` enabled to maximize price extraction. #### Why did I receive fewer items than requested? The source page may have fewer public listings than your limit, or duplicate listings may appear across pages and get de-duplicated by URL. #### Why is my run slower with detail enrichment? Detail enrichment opens each listing page to capture richer data. Disable `includeDetails` when you only need search-card discovery. ### Related scrapers Explore other marketplace and ecommerce scrapers from Automation Lab: - https://apify.com/automation-lab/etsy-scraper - https://apify.com/automation-lab/ebay-sold-listings-scraper - https://apify.com/automation-lab/chairish-scraper - https://apify.com/automation-lab/poshmark-sold-listings-scraper ### Changelog - 0.1.0 โ€” Initial public-listing scraper for 1stDibs search, category, keyword, and detail URLs. # Actor input Schema ## `startUrls` (type: `array`): Optional 1stDibs search, category, or listing detail URLs. Examples: search pages, /furniture/ category pages, or URLs ending in /id-f\_123/. ## `keywords` (type: `array`): Optional search terms. Each keyword is converted into a public 1stDibs category search URL. ## `category` (type: `string`): 1stDibs department used for keyword searches. ## `maxItems` (type: `integer`): Maximum number of listing records to save. ## `maxPages` (type: `integer`): How many pagination pages to visit for each search or category URL. ## `includeDetails` (type: `boolean`): Visit each listing page to enrich card data with prices, dimensions, condition, period, style, and more. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.1stdibs.com/search/furniture/?q=chair" } ], "keywords": [ "chair" ], "category": "furniture", "maxItems": 10, "maxPages": 3, "includeDetails": true } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.1stdibs.com/search/furniture/?q=chair" } ], "keywords": [ "chair" ] }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/1stdibs-listings-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.1stdibs.com/search/furniture/?q=chair" }], "keywords": ["chair"], } # Run the Actor and wait for it to finish run = client.actor("automation-lab/1stdibs-listings-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.1stdibs.com/search/furniture/?q=chair" } ], "keywords": [ "chair" ] }' | apify call automation-lab/1stdibs-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/1stdibs-listings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "1stDibs Listings Scraper", "description": "Scrape public 1stDibs furniture, art, jewelry, fashion, and decor listings with prices, sellers, creators, materials, dimensions, and images.", "version": "0.1", "x-build-id": "oS04bwv4kvX9BftM3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~1stdibs-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-1stdibs-listings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/automation-lab~1stdibs-listings-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-1stdibs-listings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/automation-lab~1stdibs-listings-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-1stdibs-listings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startUrls": { "title": "1stDibs URLs", "type": "array", "description": "Optional 1stDibs search, category, or listing detail URLs. Examples: search pages, /furniture/ category pages, or URLs ending in /id-f_123/.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "keywords": { "title": "Search keywords", "type": "array", "description": "Optional search terms. Each keyword is converted into a public 1stDibs category search URL.", "items": { "type": "string" } }, "category": { "title": "Keyword category", "enum": [ "all", "furniture", "art", "jewelry", "fashion" ], "type": "string", "description": "1stDibs department used for keyword searches.", "default": "furniture" }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of listing records to save.", "default": 10 }, "maxPages": { "title": "Maximum pages per search URL", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many pagination pages to visit for each search or category URL.", "default": 3 }, "includeDetails": { "title": "Open detail pages", "type": "boolean", "description": "Visit each listing page to enrich card data with prices, dimensions, condition, period, style, and more.", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```