# Blick Art Materials Scraper (`crawlerbros/blick-art-materials-scraper`) Actor Scrape Blick Art Materials (dickblick.com) - a leading US arts, crafts & art-supplies retailer. Browse by category, look up products by URL, or search by keyword. Get title, price, brand, category, description, images, availability, and ratings. - **URL**: https://apify.com/crawlerbros/blick-art-materials-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, E-commerce, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Blick Art Materials Scraper Scrape **Blick Art Materials** (dickblick.com) - one of the largest US online retailers of art, craft, and hobby supplies. Browse the full category tree, search by keyword, or look up specific products by URL to get title, brand, price, category, description, images, availability, and customer ratings. No login, no cookies, no proxy required. ### What this actor does - **Three modes:** `byCategory` (browse a department/category), `search` (keyword search across the catalog), `byProductUrl` (exact product lookup) - **237 curated categories/departments** available as a dropdown, from Art Materials basics to Tattoo supplies, plus an advanced free-text category path override - **Per-SKU detail** in `byProductUrl` mode - every color/size/format variant of a product returned as its own record with its own price and image - **Filters:** brand, price range, minimum rating, on-sale only, in-stock only - **Empty fields are omitted** - a field only appears on a record when Blick actually provides a value for it ### Data source This actor scrapes **dickblick.com** (Blick Art Materials). It was originally scoped for michaels.com, but michaels.com blocks every request - including its bare homepage - with an Akamai "Access Denied" response (HTTP 403). This was confirmed from multiple independent networks and from Apify's own cloud infrastructure, with and without Apify's proxy. Because this project never uses paid residential proxy, michaels.com cannot be reliably scraped. JOANN (joann.com), which Michaels acquired, now redirects to michaels.com and is equally inaccessible. Blick Art Materials is a comparable, freely accessible US arts-and-crafts / art-supplies retailer with full product and pricing data available without login. ### Output: category browse / search results (`recordType: "productSummary"`) - `productId` - Blick's internal product-family ID - `itemId` - Blick's SKU/item code for the primary item - `title`, `brand` - `sourceUrl` / `productUrl` - the product family page - `imageUrl` - representative product image - `categoryPath` - the category page this result came from - `priceMin`, `priceMax`, `currency` - price range across all variants of this product - `onSale`, `isBestPrice`, `isOnClearance`, `isNew`, `isOverstock` - `savingStory` - Blick's own savings summary text (e.g. `SAVE 12-63%`), present when on sale - `skuCount` - number of color/size/format variants available - `rating`, `ratingCount` - `shortDescription` - `labels` - certifications/safety seals (e.g. "AP Non-Toxic") - `recordType`, `scrapedAt` ### Output: product lookup (`recordType: "product"`, mode = `byProductUrl`) One record **per SKU variant** (color/size/format): - `productId`, `itemSku` - `title`, `productName`, `variantName` - `brand` - `categoryPath[]`, `category` - full breadcrumb chain and the immediate category - `description`, `color`, `gtin` - `price`, `currency`, `availability` (`InStock` / `OutOfStock` / etc.), `inStock` - `imageUrls[]`, `imageUrl` - `sourceUrl` - exact variant URL, `productUrl` - canonical family page - `rating`, `ratingCount` - `recordType`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `byCategory` | `byCategory` / `search` / `byProductUrl` | | `categoryPath` | string (dropdown) | `/categories/painting/tempera-paint/` | Category to browse (mode=byCategory) | | `customCategoryPath` | string | - | Advanced: exact category path, overrides `categoryPath` (mode=byCategory) | | `searchQuery` | string | `yarn` | Keyword to search for (mode=search) | | `productUrls` | array | - | Product URLs or slugs to look up (mode=byProductUrl) | | `brand` | string | - | Only include products whose brand contains this text | | `minPrice` / `maxPrice` | int | - | Price range filter (USD) | | `minRating` | int | - | Minimum star rating (1-5); unrated products always pass | | `onSaleOnly` | boolean | `false` | Only include products on sale | | `inStockOnly` | boolean | `false` | Only include in-stock items (mode=byProductUrl) | | `maxItems` | int | `30` | Hard cap on emitted records (1-1000) | #### Example: browse a category ```json { "mode": "byCategory", "categoryPath": "/categories/painting/watercolor-paint/", "maxItems": 30 } ```` #### Example: keyword search with filters ```json { "mode": "search", "searchQuery": "acrylic paint", "brand": "Golden", "onSaleOnly": true, "maxItems": 50 } ``` #### Example: look up specific products (all variants + prices) ```json { "mode": "byProductUrl", "productUrls": [ "https://www.dickblick.com/products/blick-tempera-cakes/", "blick-premium-grade-tempera" ], "inStockOnly": true } ``` #### Example: drill into a narrow subcategory not in the dropdown ```json { "mode": "byCategory", "customCategoryPath": "/categories/painting/kids/watercolor/", "maxItems": 25 } ``` ### Use cases - **Price monitoring** - track price and sale status for specific art-supply SKUs over time - **Catalog research** - pull a full department's product lineup for competitive analysis - **Marketplace listing** - source structured product data (title, images, price, description) for cross-listing - **Classroom / procurement planning** - compare brand and price across an entire category before bulk-ordering - **Affiliate content** - build "best of" and buying-guide content from real, current pricing and ratings ### FAQ **Is this affiliated with Blick Art Materials or Dick Blick Holdings?** No. This is an independent, third-party actor that reads Blick's publicly accessible product pages. It is not affiliated with, endorsed by, or connected to Blick Art Materials. **Why does `byCategory` mode return at most ~30 products per category, even when a category has more?** Blick's category pages server-render only the first batch of products (Blick's own site does this too - deeper results only load via an internal client-side call that isn't exposed as a stable API). To get full coverage of a large department, browse its narrower subcategories individually (all 237 are available in the `categoryPath` dropdown, and any deeper path can be supplied via `customCategoryPath`). **How does keyword search work?** Blick's own `/search/` page is excluded from indexing (disallowed in their robots.txt) and only loads results via client-side JavaScript, so this actor implements `search` mode by scanning across Blick's category pages and matching your keyword against each product's title, brand, and description. This reliably surfaces on-catalog results without needing a browser. **Does `byCategory` / `search` mode return per-variant pricing?** Those modes return a price *range* (`priceMin`-`priceMax`) across all of a product's variants, since each category page lists product families rather than individual SKUs. For an exact price per color/size, use `byProductUrl` mode, which returns one record per SKU. **Are prices and availability live?** Yes - every run fetches current data directly from dickblick.com at request time. **Do I need a proxy or cookies?** No. This actor works with plain HTTP requests, no login and no proxy configuration required. **Why are some fields missing from a record?** Fields are only included when Blick actually supplies a value. For example, `rating` is omitted for products with no reviews yet, and `imageUrls` is omitted if a SKU has no dedicated image. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `categoryPath` (type: `string`): Department or category to browse. ## `customCategoryPath` (type: `string`): Exact category URL path, e.g. `/categories/painting/tempera-paint/kids/`. Overrides the Category dropdown above when set. Use this to reach a narrower subcategory not listed in the dropdown. ## `searchQuery` (type: `string`): Keyword to search for across Blick's product catalog (matched against product title, brand, and description). ## `productUrls` (type: `array`): Full product URLs (e.g. `https://www.dickblick.com/products/blick-tempera-cakes/`) or bare slugs (e.g. `blick-tempera-cakes`). ## `brand` (type: `string`): Only include products whose brand contains this text (case-insensitive), e.g. `Blick`, `Crayola`, `Golden`. ## `minPrice` (type: `integer`): Drop products priced below this amount. ## `maxPrice` (type: `integer`): Drop products priced above this amount. ## `minRating` (type: `integer`): Drop products rated below this (1-5 stars). Products without a rating are always included. ## `onSaleOnly` (type: `boolean`): Only include products currently on sale. ## `inStockOnly` (type: `boolean`): Only include in-stock items (mode=byProductUrl; category/search results do not expose per-SKU stock status). ## `maxItems` (type: `integer`): Hard cap on emitted records. ## Actor input object example ```json { "mode": "byCategory", "categoryPath": "/categories/painting/tempera-paint/", "searchQuery": "yarn", "productUrls": [], "onSaleOnly": false, "inStockOnly": false, "maxItems": 20 } ``` # Actor output Schema ## `products` (type: `string`): Dataset containing all scraped Blick Art Materials products. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "byCategory", "categoryPath": "/categories/painting/tempera-paint/", "searchQuery": "yarn", "productUrls": [], "onSaleOnly": false, "inStockOnly": false, "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/blick-art-materials-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "byCategory", "categoryPath": "/categories/painting/tempera-paint/", "searchQuery": "yarn", "productUrls": [], "onSaleOnly": False, "inStockOnly": False, "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/blick-art-materials-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "byCategory", "categoryPath": "/categories/painting/tempera-paint/", "searchQuery": "yarn", "productUrls": [], "onSaleOnly": false, "inStockOnly": false, "maxItems": 20 }' | apify call crawlerbros/blick-art-materials-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/blick-art-materials-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Blick Art Materials Scraper", "description": "Scrape Blick Art Materials (dickblick.com) - a leading US arts, crafts & art-supplies retailer. Browse by category, look up products by URL, or search by keyword. Get title, price, brand, category, description, images, availability, and ratings.", "version": "1.0", "x-build-id": "EHJ9GshL63FIAITNE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~blick-art-materials-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-blick-art-materials-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/crawlerbros~blick-art-materials-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-blick-art-materials-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/crawlerbros~blick-art-materials-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-blick-art-materials-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "byCategory", "search", "byProductUrl" ], "type": "string", "description": "What to fetch.", "default": "byCategory" }, "categoryPath": { "title": "Category (mode=byCategory)", "enum": [ "/categories/books/", "/categories/books/art-education/", "/categories/books/ceramics-sculpture/", "/categories/books/coffee-table/", "/categories/books/coloring/", "/categories/books/crafts/", "/categories/books/drawing/", "/categories/books/kids/", "/categories/books/painting/", "/categories/books/printmaking/", "/categories/books/subject/", "/categories/books/textile-jewelry/", "/categories/brushes/", "/categories/brushes/acrylic/", "/categories/brushes/cleaners/", "/categories/brushes/holders/", "/categories/brushes/kids/", "/categories/brushes/natural/", "/categories/brushes/oil/", "/categories/brushes/sets/", "/categories/brushes/shapes/", "/categories/brushes/specialty/", "/categories/brushes/synthetic/", "/categories/brushes/watercolor/", "/categories/canvas/", "/categories/canvas/canvas-rolls/", "/categories/canvas/panels/", "/categories/canvas/primers/", "/categories/canvas/stretched-canvas/", "/categories/canvas/stretched-canvas-by-size/", "/categories/canvas/stretcher-bars/", "/categories/canvas/stretching-tools/", "/categories/canvas/wood-painting-panels/", "/categories/ceramics-sculpture/", "/categories/ceramics-sculpture/bisque/", "/categories/ceramics-sculpture/carving/", "/categories/ceramics-sculpture/clay/", "/categories/ceramics-sculpture/equipment/", "/categories/ceramics-sculpture/glass-art/", "/categories/ceramics-sculpture/glazes/", "/categories/ceramics-sculpture/kilns/", "/categories/ceramics-sculpture/metal-sculpture/", "/categories/ceramics-sculpture/mold-making-casting/", "/categories/ceramics-sculpture/tools/", "/categories/crafts/", "/categories/crafts/adhesives/", "/categories/crafts/basics/", "/categories/crafts/candle-making/", "/categories/crafts/collage/", "/categories/crafts/cosplay/", "/categories/crafts/home-decor/", "/categories/crafts/jewelry-making/", "/categories/crafts/kids/", "/categories/crafts/kits/", "/categories/crafts/leather-crafts/", "/categories/crafts/machines/", "/categories/crafts/metal/", "/categories/crafts/model-miniature/", "/categories/crafts/mosaics/", "/categories/crafts/paint/", "/categories/crafts/party-supplies/", "/categories/crafts/sewing/", "/categories/crafts/sign-making/", "/categories/crafts/soap-making/", "/categories/crafts/stencils/", "/categories/crafts/textile-arts/", "/categories/crafts/wood/", "/categories/drawing/", "/categories/drawing/calligraphy/", "/categories/drawing/chalk/", "/categories/drawing/charcoal/", "/categories/drawing/colored-pencils/", "/categories/drawing/crayons/", "/categories/drawing/digital-art/", "/categories/drawing/drafting/", "/categories/drawing/erasers/", "/categories/drawing/fine-writing/", "/categories/drawing/inks/", "/categories/drawing/kids/", "/categories/drawing/markers/", "/categories/drawing/paper/", "/categories/drawing/pastels/", "/categories/drawing/pencils/", "/categories/drawing/pens/", "/categories/drawing/scratchboard/", "/categories/drawing/sumi-painting/", "/categories/drawing/tools/", "/categories/easels/", "/categories/easels/a-frame/", "/categories/easels/classroom/", "/categories/easels/display/", "/categories/easels/french-plein-air/", "/categories/easels/h-frame/", "/categories/easels/kids/", "/categories/easels/lights/", "/categories/easels/metal-aluminum/", "/categories/easels/studio/", "/categories/easels/tabletop/", "/categories/easels/wooden/", "/categories/framing/", "/categories/framing/boards/", "/categories/framing/canvas-frames/", "/categories/framing/frames-by-size/", "/categories/framing/frames-by-style/", "/categories/framing/gallery-frames/", "/categories/framing/metal-frames/", "/categories/framing/picture-hanging-supplies/", "/categories/framing/poster-frames/", "/categories/framing/sectional-kits/", "/categories/framing/shadow-boxes/", "/categories/framing/tabletop-frames/", "/categories/framing/tools/", "/categories/framing/wood-frames/", "/categories/furniture/", "/categories/furniture/accessories/", "/categories/furniture/art-studio/", "/categories/furniture/classroom/", "/categories/furniture/display/", "/categories/furniture/home/", "/categories/furniture/kids/", "/categories/furniture/lighting/", "/categories/furniture/outdoor-studio/", "/categories/furniture/projectors/", "/categories/furniture/retail/", "/categories/furniture/storage-carts-cabinets/", "/categories/gifts/", "/categories/gifts/25-50/", "/categories/gifts/50-100/", "/categories/gifts/animals/", "/categories/gifts/blick-gift-cards/", "/categories/gifts/by-price/", "/categories/gifts/celestial-space/", "/categories/gifts/crafts/", "/categories/gifts/drawing/", "/categories/gifts/famous-artists/", "/categories/gifts/furniture/", "/categories/gifts/interests/", "/categories/gifts/kawaii/", "/categories/gifts/kids/", "/categories/gifts/over-100/", "/categories/gifts/painting/", "/categories/gifts/plants-nature/", "/categories/gifts/potters/", "/categories/gifts/printmaking/", "/categories/gifts/retro/", "/categories/gifts/stocking-stuffers/", "/categories/gifts/textile-art/", "/categories/gifts/travel/", "/categories/gifts/under-25/", "/categories/gifts/wellness/", "/categories/gifts/wrap/", "/categories/kids/", "/categories/kids/aprons/", "/categories/kids/classroom-packs/", "/categories/kids/clay/", "/categories/kids/home-learning/", "/categories/kids/kits/", "/categories/kids/play/", "/categories/macpherson-overstock-liquidation-sale/", "/categories/macpherson-overstock-liquidation-sale/brushes-liquidation/", "/categories/macpherson-overstock-liquidation-sale/canvas-board-liquidation/", "/categories/macpherson-overstock-liquidation-sale/ceramics-sculpture-liquidation/", "/categories/macpherson-overstock-liquidation-sale/colored-watercolor-pencils-liquidation/", "/categories/macpherson-overstock-liquidation-sale/crafts-liquidation/", "/categories/macpherson-overstock-liquidation-sale/drawing-illustration-liquidation/", "/categories/macpherson-overstock-liquidation-sale/easel-furniture-liquidation/", "/categories/macpherson-overstock-liquidation-sale/frames-liquidation/", "/categories/macpherson-overstock-liquidation-sale/markers-liquidation/", "/categories/macpherson-overstock-liquidation-sale/paints-liquidation/", "/categories/macpherson-overstock-liquidation-sale/paper-board-liquidation/", "/categories/macpherson-overstock-liquidation-sale/popular-brands-liquidation/", "/categories/macpherson-overstock-liquidation-sale/printmaking-liquidation/", "/categories/macpherson-overstock-liquidation-sale/studio-office-supplies-liquidation/", "/categories/painting/", "/categories/painting/acrylic-paint/", "/categories/painting/airbrushing/", "/categories/painting/cadmium-free/", "/categories/painting/caseins/", "/categories/painting/encaustic/", "/categories/painting/fabric/", "/categories/painting/face-body/", "/categories/painting/gouache/", "/categories/painting/home-decor-paint/", "/categories/painting/kids/", "/categories/painting/mediums/", "/categories/painting/oil-paint/", "/categories/painting/palettes/", "/categories/painting/sets/", "/categories/painting/sign-painting/", "/categories/painting/spray-painting/", "/categories/painting/street-art/", "/categories/painting/tempera-paint/", "/categories/painting/tools/", "/categories/painting/watercolor-paint/", "/categories/paper/", "/categories/paper/boards/", "/categories/paper/colored-decorative/", "/categories/paper/crafts/", "/categories/paper/films/", "/categories/paper/japanese/", "/categories/paper/kids/", "/categories/paper/painting/", "/categories/paper/rolls/", "/categories/paper/watercolor-paper/", "/categories/printmaking/", "/categories/printmaking/block-printing/", "/categories/printmaking/cyanotype/", "/categories/printmaking/etching-intaglio/", "/categories/printmaking/inks/", "/categories/printmaking/lithography/", "/categories/printmaking/monotype/", "/categories/printmaking/paper/", "/categories/printmaking/plates/", "/categories/printmaking/presses/", "/categories/printmaking/screen-printing/", "/categories/printmaking/sublimation/", "/categories/printmaking/tools/", "/categories/studio/", "/categories/studio/adaptive-art-supplies/", "/categories/studio/archival/", "/categories/studio/art-storage/", "/categories/studio/art-transport/", "/categories/studio/cleaning/", "/categories/studio/cutting-tools/", "/categories/studio/glue/", "/categories/studio/hardware/", "/categories/studio/office-supplies/", "/categories/studio/photography/", "/categories/studio/safety/", "/categories/studio/tape/", "/categories/tattoo/", "/categories/tattoo/furniture/", "/categories/tattoo/inks/", "/categories/tattoo/machines/", "/categories/tattoo/medical/", "/categories/tattoo/needles/", "/categories/tattoo/stencil-studio/" ], "type": "string", "description": "Department or category to browse.", "default": "/categories/painting/tempera-paint/" }, "customCategoryPath": { "title": "Custom category path (advanced, mode=byCategory)", "type": "string", "description": "Exact category URL path, e.g. `/categories/painting/tempera-paint/kids/`. Overrides the Category dropdown above when set. Use this to reach a narrower subcategory not listed in the dropdown." }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Keyword to search for across Blick's product catalog (matched against product title, brand, and description).", "default": "yarn" }, "productUrls": { "title": "Product URLs (mode=byProductUrl)", "type": "array", "description": "Full product URLs (e.g. `https://www.dickblick.com/products/blick-tempera-cakes/`) or bare slugs (e.g. `blick-tempera-cakes`).", "default": [], "items": { "type": "string" } }, "brand": { "title": "Filter by brand", "type": "string", "description": "Only include products whose brand contains this text (case-insensitive), e.g. `Blick`, `Crayola`, `Golden`." }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Drop products priced below this amount." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Drop products priced above this amount." }, "minRating": { "title": "Min rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Drop products rated below this (1-5 stars). Products without a rating are always included." }, "onSaleOnly": { "title": "On sale only", "type": "boolean", "description": "Only include products currently on sale.", "default": false }, "inStockOnly": { "title": "In stock only", "type": "boolean", "description": "Only include in-stock items (mode=byProductUrl; category/search results do not expose per-SKU stock status).", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 30 } } }, "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 } } } } } } } } } } ```