{ "openapi": "3.0.1", "info": { "title": "Wayfair Product Scraper", "description": "Scrape Wayfair products from keywords, SKUs or URLs for search, category and brand pages. Get product names, brands, SKUs, ratings, availability, images and selected options, with optional page-level dimensions, weight, descriptions and specifications. Supports three regional Wayfair stores.", "version": "1.0", "x-build-id": "qIpj7b0U7BtK3d1Hv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axiomworks~wayfair-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axiomworks-wayfair-product-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/axiomworks~wayfair-product-scraper/runs": { "post": { "operationId": "runs-sync-axiomworks-wayfair-product-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/axiomworks~wayfair-product-scraper/run-sync": { "post": { "operationId": "run-sync-axiomworks-wayfair-product-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 keywords", "type": "array", "description": "Keywords as typed in the Wayfair search box, e.g. 'boucle swivel accent chair'. One search per entry. A Wayfair SKU such as 'W100576387' also works and returns that product. Leave empty if you supply startUrls.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Wayfair search (keyword.php?keyword=...), category (/sb0/, /sb1/, /cat/), brand (/brand/bnd/...) or product (/pdp/...) URLs on wayfair.com, wayfair.ca or wayfair.co.uk. Filters and sort in the query string are kept. Bare SKUs are accepted too.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "store": { "title": "Store for keywords and SKUs", "enum": [ "wayfair.com", "wayfair.ca", "wayfair.co.uk" ], "type": "string", "description": "Wayfair store used for searchQueries and bare SKUs: wayfair.com (USD), wayfair.ca (CAD) or wayfair.co.uk (GBP). URLs keep their own store. Default wayfair.com.", "default": "wayfair.com" }, "maxItems": { "title": "Max products", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of product records in total, 1-5000. Default 50. The run stops as soon as this many are saved.", "default": 50 }, "maxPagesPerQuery": { "title": "Max pages per query", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum listing pages per search, category or brand URL, 1-100. Default 10. A search page holds about 30 products, a category or brand page about 48.", "default": 10 }, "includeDetails": { "title": "Include product page details", "type": "boolean", "description": "If true (default), open each product page to add dimensions, weight, specifications, description and category path (one extra request per product). Set false for fast, cheaper price tracking from listing cards only.", "default": true }, "includeSponsored": { "title": "Include sponsored products", "type": "boolean", "description": "If true (default), keep sponsored ad cards, which are always flagged sponsored=true. Set false to return organic results only.", "default": true }, "minPrice": { "title": "Minimum price", "type": "number", "description": "Only return products priced at or above this amount in the store's currency, e.g. 100. Applied to listing cards; products without a price are skipped when a price filter is set. Default none." }, "maxPrice": { "title": "Maximum price", "type": "number", "description": "Only return products priced at or below this amount in the store's currency, e.g. 500. Applied to listing cards before product pages are opened, so it saves requests. Default none." }, "minRating": { "title": "Minimum rating", "type": "number", "description": "Only return products with an average rating of at least this value, 0-5, e.g. 4.5. Unrated products are skipped when set. Default none." }, "onlyOnSale": { "title": "Only products on sale", "type": "boolean", "description": "If true, return only products with a sale or reduced price (listPrice above price). Default false.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy settings. Wayfair blocks datacenter IPs, so a residential proxy is required and is enforced if missing. The country defaults to the store's country (US, CA, GB).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }