{ "openapi": "3.0.1", "info": { "title": "Wescover Artist & Product Scraper", "description": "Scrape Wescover.com functional/decorative art and design products (materials, price range, and the real venue each piece is installed at) and maker/creator profiles, with built-in delta mode. No login required.", "version": "0.1", "x-build-id": "JDvzE3SxJ3Jm3mrGM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/artsiom_k~wescover-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-artsiom_k-wescover-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/artsiom_k~wescover-scraper/runs": { "post": { "operationId": "runs-sync-artsiom_k-wescover-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/artsiom_k~wescover-scraper/run-sync": { "post": { "operationId": "run-sync-artsiom_k-wescover-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": { "entityType": { "title": "Entity type", "enum": [ "artworks", "artists" ], "type": "string", "description": "Scrape products (functional/decorative art and design pieces, with materials, price range, and the real venue they're installed at) or maker/creator profiles (bio, tags, category footprint, and a complete product list — no extra fan-out cost). See dataset_schema.json for the field set of each.", "default": "artworks" }, "categories": { "title": "Categories to include", "type": "array", "description": "Optional: only push items whose real category matches one of these. This is a push-time filter, not a discovery scope — the full site is still walked either way (wescover.com's own category-browse pages carry a much stricter rate limit than product/maker pages, so this actor deliberately never uses them for discovery). Leave empty to include everything.", "items": { "type": "string", "enum": [ "art-wall-decor", "floral-garden", "furniture", "lighting", "other", "public-art", "tableware", "textiles", "tiles" ], "enumTitles": [ "Art & Wall Decor", "Floral & Garden", "Furniture", "Lighting", "Other", "Public Art", "Tableware", "Textiles", "Tiles" ] } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional list of specific Wescover product (https://www.wescover.com/p/{slug}--{sid}) or maker (https://www.wescover.com/creator/{slug}) URLs to scrape directly, instead of discovering via the full sitemap — use whichever kind matches entityType. Overrides \"Categories to include\". A startUrls-scoped run cannot detect delistings or update the incremental baseline.", "items": { "type": "string" } }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Stop after pushing this many dataset items. Defaults to 50 — a fast, cheap preview, and what keeps an unconfigured run within Apify's automated 5-minute QA check. The full site has ~60,000 products across ~6,300 makers. Raise this or clear it (set to null) for a full run, or narrow \"Categories to include\" instead.", "default": 50 }, "mode": { "title": "Incremental mode", "enum": [ "auto", "full", "incremental" ], "type": "string", "description": "\"auto\" (recommended): full scan on the first run for a given entityType/scope, incremental (new/changed only) afterwards. \"full\": always push every item and refresh the baseline — schedule this periodically to catch delistings and price changes. \"incremental\": always push only new/changed items. Only a plain, unscoped run (no startUrls, and the same \"Categories to include\" every time) can detect delistings or update the baseline.", "default": "auto" }, "concurrency": { "title": "Concurrency", "minimum": 1, "type": "integer", "description": "How many product/maker detail pages to fetch in parallel. Defaults to 5 — deliberately conservative: a real rate-limit incident was hit while building this actor at higher concurrency (a burst at 30 got HTTP 429s, and retrying immediately at 10 made it much worse). Detail pages (unlike this site's category-browse pages) tested clean at concurrency 8 after a cooldown, but 5 is kept as a safety margin. Raise cautiously.", "default": 5 }, "impersonate": { "title": "TLS impersonation target", "type": "string", "description": "curl_cffi browser TLS-impersonation target. Defaults to \"chrome\" internally." } } }, "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 } } } } } } } } } }