{
"openapi": "3.0.1",
"info": {
"title": "1stDibs Scraper - Luxury Items, Prices & Dealer Leads",
"description": "Scrape 1stDibs luxury furniture, art, jewelry & watches: prices (10 currencies), designer, period, materials, dimensions, condition, photos & full dealer profiles. Search by keyword, category or URL, emit dealer leads, and monitor price drops & new listings.",
"version": "0.1",
"x-build-id": "6Z1dFOG0gcWrYTYUT"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~1stdibs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-1stdibs-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/scrapesage~1stdibs-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-1stdibs-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/scrapesage~1stdibs-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-1stdibs-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": {
"searchQueries": {
"title": "Search queries",
"type": "array",
"description": "Keywords to search on 1stDibs, e.g. eames chair, rolex datejust, art deco ring. Each query is run as a 1stDibs search and paginated.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "Direct 1stDibs URLs: category / browse pages (e.g. https://www.1stdibs.com/furniture/seating/chairs/), search result pages (/search/?q=...), creator pages (/creators/...), or individual item pages (/.../id-f_12345678/). Paste a filtered/sorted browse URL straight from your browser to reuse its filters.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"itemUrls": {
"title": "Item URLs",
"type": "array",
"description": "Direct 1stDibs item (PDP) URLs to scrape in full detail. Used in addition to searches.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "Max items",
"minimum": 1,
"type": "integer",
"description": "Maximum number of items to scrape across all queries and URLs.",
"default": 100
},
"maxPagesPerSearch": {
"title": "Max pages per search",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "Maximum result pages to paginate per search/category URL (60 items per page).",
"default": 5
},
"minPrice": {
"title": "Min price (USD)",
"minimum": 0,
"type": "integer",
"description": "Only include items priced at or above this amount (USD). Items with price-on-request are kept unless you also enable \"Available items only\"."
},
"maxPrice": {
"title": "Max price (USD)",
"minimum": 0,
"type": "integer",
"description": "Only include items priced at or below this amount (USD)."
},
"availableOnly": {
"title": "Available items only",
"type": "boolean",
"description": "Skip items that are sold or on hold.",
"default": false
},
"includeItemDetails": {
"title": "Include full item details",
"type": "boolean",
"description": "Fetch each item's page for the richest record: full description, condition, period, style, place of origin, all materials, every dimension, all photos, listing views and the seller's full dealer profile (location, years in business, tier, rating). One extra request per item. Turn OFF for fast, cheap listing-only rows.",
"default": true
},
"includeDealerLeads": {
"title": "Emit dealer lead records",
"type": "boolean",
"description": "In addition to item records, push one deduplicated lead record per unique dealer/gallery (type = \"dealer\") with company, location, years in business, 1stDibs tier, rating, inventory size seen and a 0–100 lead score. Best with \"Include full item details\" on.",
"default": false
},
"deduplicateItems": {
"title": "Deduplicate items",
"type": "boolean",
"description": "Drop duplicate items (same item appearing in multiple searches/pages) within a run.",
"default": true
},
"monitorMode": {
"title": "Monitor mode (only new / changed)",
"type": "boolean",
"description": "Remember items across runs in a named key-value store and only output items that are NEW or whose price/availability CHANGED since the last run (adds a changeType field: new, price_drop, price_rise, sold). Pair with Apify Schedules to track a city, category or dealer. Works alongside the built-in scheduler — the schedule decides WHEN to run, monitor decides WHAT is new.",
"default": false
},
"monitorKey": {
"title": "Monitor key",
"type": "string",
"description": "Optional name to separate monitor states for different searches (e.g. warsaw-rings). Reuse the same key across scheduled runs to keep one continuous history."
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 30,
"type": "integer",
"description": "Maximum number of parallel requests.",
"default": 8
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxies to use. Datacenter proxies (the default) work well with 1stDibs and are the cheapest. If you ever hit blocks during very large runs, switch to Residential proxies.",
"default": {
"useApifyProxy": 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
}
}
}
}
}
}
}
}
}
}