{ "openapi": "3.0.1", "info": { "title": "World Market Scraper - Home Decor & Furniture Prices", "description": "World Market scraper: category pages, ids or search terms to one row per product with USD price and price range, markdown, Sale and Clearance flags, in-stock status, rating and reviews, sku, link and photo. For home decor and furniture price, clearance and stock watching.", "version": "0.1", "x-build-id": "7JSwdu8SMCqNchHk0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/superslowsloth~worldmarket-products/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-superslowsloth-worldmarket-products", "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/superslowsloth~worldmarket-products/runs": { "post": { "operationId": "runs-sync-superslowsloth-worldmarket-products", "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/superslowsloth~worldmarket-products/run-sync": { "post": { "operationId": "run-sync-superslowsloth-worldmarket-products", "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": { "categories": { "title": "Categories", "type": "array", "description": "World Market category pages to list, one per line: the page address (for example https://www.worldmarket.com/c/furniture/ or https://www.worldmarket.com/c/bath/bath-sale/) or the category id from it (116715 for furniture, sale-bath). A department page such as /c/furniture/ lists every product in the department. A search page address (https://www.worldmarket.com/search?q=candle) is read as that search. Leave empty if you only use search terms.", "items": { "type": "string" } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "What you would type into the World Market search box, one term per line (for example wine glass, dining chair or velvet pillow). Each term is read separately. A term the site does not match returns nothing and costs nothing. Terms containing < or > are refused by the site's firewall and rejected here. A product that two sources both find is returned once, under the first.", "items": { "type": "string" } }, "maxItems": { "title": "Max products per category or search term", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Read at most this many products for each category and each search term. World Market lists 96 per request here, so 250 reads three pages. Up to 10,000 are accepted.", "default": 100 }, "sort": { "title": "Sort order", "enum": [ "default", "top-sellers", "new-arrivals", "rating", "price-low-to-high", "price-high-to-low" ], "type": "string", "description": "The order the site lists products in, which decides which ones a Max products cut-off keeps. Default is the site's own order. The price sorts put the cheapest or dearest first (by the site's own price index, so roughly rather than strictly in order); New arrivals puts the newest first.", "default": "default" }, "onlyOnSale": { "title": "Only products on sale or clearance", "type": "boolean", "description": "Return only products that are marked down (on_sale: the price is below the struck-through price) or labelled Sale or Clearance by the site. Other products are read but not returned and not charged, and do not count toward Max products. A category with few markdowns reads many pages to find them.", "default": false }, "onlyInStock": { "title": "Only products in stock", "type": "boolean", "description": "Return only products the site marks 'in stock' (in_stock is true). Out of stock and in-store-only products are read but not returned and not charged, and do not count toward Max products.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify's automatic datacenter proxy (the default). worldmarket.com answered Apify datacenter and residential addresses alike with HTTP 200 when this actor was built (2 of 2 each); the datacenter group is cheaper and was enough. A refused request is retried from a fresh address.", "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 }, "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 } } } } } } } } } }