{ "openapi": "3.0.1", "info": { "title": "Blick Art Materials Scraper", "description": "Browse Blick product families by category or keyword, or look up product variants from public URLs. Get titles, prices, brands, categories, images, ratings, availability, and source links when Blick publishes them.", "version": "0.0", "x-build-id": "HXvAZi5bB6rjONzwC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~dickblick/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-dickblick", "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/maximedupre~dickblick/runs": { "post": { "operationId": "runs-sync-maximedupre-dickblick", "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/maximedupre~dickblick/run-sync": { "post": { "operationId": "run-sync-maximedupre-dickblick", "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", "required": [ "resultType" ], "properties": { "resultType": { "title": "Result type", "enum": [ "product_families", "product_variants" ], "type": "string", "description": "Choose family summaries for category or keyword searches, or variant details for product URL lookups." }, "familySearch": { "title": "Find product families by", "required": [ "discoveryMethod" ], "type": "object", "description": "For Product family summaries, choose Browse a category or Search by keyword, then fill only the matching field. This section is ignored for Product variant details.", "properties": { "discoveryMethod": { "title": "Find product families by", "type": "string", "description": "Choose a public category URL or one keyword to find product families.", "editor": "select", "enum": [ "category", "keyword" ], "enumTitles": [ "Browse a category", "Search by keyword" ], "prefill": "category" }, "categoryUrl": { "title": "Category URL", "type": "string", "description": "Enter one public Blick category or subcategory URL. A narrower public subcategory can focus the run.", "editor": "textfield", "pattern": "^https://(?:www\\.)?dickblick\\.com/.+", "prefill": "https://www.dickblick.com/categories/painting/" }, "keyword": { "title": "Keyword", "type": "string", "description": "Enter one keyword to search Blick product families. Use this field when Search by keyword is selected.", "editor": "textfield", "minLength": 1 } } }, "productUrls": { "title": "Product URLs", "minItems": 1, "type": "array", "description": "Add one or more public Blick product URLs. Each accepted URL can return variant-level details.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "brand": { "title": "Brand", "type": "string", "description": "For Product variant details, enter a brand to keep only matching results. Leave it blank to allow all brands." }, "priceRange": { "title": "Price range", "type": "object", "description": "For Product variant details, enter a minimum price, a maximum price, or both. Values use the source currency.", "properties": { "min": { "title": "Minimum price", "type": "number", "description": "Keep variant results at or above this price in the source currency.", "minimum": 0 }, "max": { "title": "Maximum price", "type": "number", "description": "Keep variant results at or below this price in the source currency.", "minimum": 0 } } }, "minimumRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "For Product variant details, keep variants with this source rating or higher. Use a value from 0 to 5." }, "saleOnly": { "title": "On sale only", "type": "boolean", "description": "For Product variant details, keep only products that Blick marks with a sale or clearance price. Leave it off to allow all results." }, "inStockOnly": { "title": "In stock only", "type": "boolean", "description": "For Product variant details, keep only products that Blick marks as in stock. Leave it off to allow all results." }, "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "For Product family summaries, stop after this many family rows from a category or keyword search. Leave it empty to return all available results until the source is exhausted." } } }, "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 } } } } } } } } } }