# Uline Product Catalog Scraper (`automation-lab/uline-product-catalog-scraper`) Actor Scrape public Uline catalog products, SKUs, prices, pack data, image URLs, and product links for procurement and ecommerce monitoring. - **URL**: https://apify.com/automation-lab/uline-product-catalog-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## Uline Product Catalog Scraper Scrape public Uline catalog pages for product SKUs, names, prices, quantity price breaks, dimensions, product URLs, images, and visible availability signals. ### What does Uline Product Catalog Scraper do? Uline Product Catalog Scraper turns public Uline catalog and product pages into structured rows you can export to JSON, CSV, Excel, Google Sheets, or any Apify integration. It is designed for procurement, sourcing, ecommerce, and catalog-monitoring workflows that need repeatable access to public Uline product data. ### Who is it for? - ๐Ÿงพ Procurement teams monitoring industrial supply prices - ๐Ÿ“ฆ Ecommerce analysts comparing packaging and shipping supply catalogs - ๐Ÿท๏ธ Pricing teams tracking SKU-level price changes - ๐Ÿงฐ Operations teams building internal supplier reference tables - ๐Ÿ“Š Data teams feeding BI dashboards with public catalog data ### Why scrape Uline catalog data? Uline is a large industrial and shipping supply catalog. Manual copy/paste from product tables is slow, error-prone, and hard to repeat. This actor helps you collect public catalog rows in a consistent schema so you can compare SKUs, track pricing, and monitor supplier pages over time. ### What data can you extract? | Field | Description | | --- | --- | | `sku` | Uline item number | | `name` | Product name or description | | `category` | Visible Uline category | | `breadcrumbs` | Page breadcrumb/category labels | | `productUrl` | Product detail URL | | `imageUrl` | Product image URL | | `price` | Visible unit/lowest price | | `priceBreaks` | Quantity price tiers | | `dimensions` | Size or option text | | `attributes` | Extra visible specs/options | | `packQuantity` | Pack, bundle, bale, or quantity text when visible | | `weight` | Weight text when visible | | `availability` | Public availability signal when visible | | `description` | Page/product meta description | | `sourceUrl` | Input URL where the row was found | | `scrapedAt` | Timestamp of extraction | ### How much does it cost to scrape Uline products? This actor uses pay-per-event pricing. - A $0.005 start fee is charged once per run. - A product-row event is charged for each saved Uline product row. - Formula-derived BRONZE price with platform minimum floor: $0.00004 per product row (about $0.04 per 1,000 rows), with higher-tier discounts. - FREE tier product-row price: $0.000046 per row. - You can control cost with `maxItems` and `maxPages`. For a quick first test, keep the default input and `maxItems` at 20. ### How to use it 1. Open the actor on Apify. 2. Paste one or more public Uline URLs in **Uline start URLs**. 3. Set **Maximum products** to the number of rows you need. 4. Keep proxy disabled unless your network is blocked. 5. Click **Start**. 6. Download results from the dataset as JSON, CSV, Excel, or via API. ### Supported Uline URLs The scraper is built for public Uline pages such as: - Guided navigation pages, for example `/Product/GuidedNav?t=184360&dup=title` - Product detail pages, for example `/Product/Detail/S-13287/...` - Category-style pages that render product tables in the initial HTML ### Input example ```json { "startUrls": [ { "url": "https://www.uline.com/Product/GuidedNav?t=184360&dup=title" } ], "maxItems": 50, "maxPages": 1, "proxyConfiguration": { "useApifyProxy": false } } ```` ### Output example ```json { "sku": "S-13287", "name": "3 x 3 x 3\" Corrugated Boxes", "category": "Boxes, Corrugated", "breadcrumbs": ["Corrugated Boxes"], "productUrl": "https://www.uline.com/Product/Detail/S-13287/Corrugated-Boxes-200-Test/3-x-3-x-3-Corrugated-Boxes", "imageUrl": "https://img.uline.com/is/image/uline/S-13287?$Browse$", "price": 0.37, "currency": "USD", "priceBreaks": [ { "quantity": "25", "price": 0.37 }, { "quantity": "100", "price": 0.36 } ], "dimensions": "3 x 3 x 3\"", "attributes": ["200 lb. Test"], "availability": "In stock / ships today shown on page", "sourceUrl": "https://www.uline.com/Product/GuidedNav?t=184360&dup=title", "scrapedAt": "2026-06-16T00:00:00.000Z" } ``` ### Tips for better results - Use public Uline catalog URLs that show product tables. - Start with a low `maxItems` value when testing a new page. - Use product detail URLs when you need richer description/specification text. - Use guided navigation URLs when you need many SKUs from a category table. - Re-run the same URL on a schedule to monitor price changes. ### Common procurement workflows - ๐Ÿ“‰ Track price changes for packaging SKUs. - ๐Ÿ“ฆ Build a reference database of carton and shipping supply dimensions. - ๐Ÿงพ Compare supplier catalog prices for recurring purchases. - ๐Ÿ”” Trigger alerts when a key product page changes. - ๐Ÿ“Š Feed public catalog rows into BI dashboards. ### Integrations You can connect the dataset to: - Google Sheets for shared category monitoring - Make or Zapier for SKU change alerts - Snowflake, BigQuery, or S3 for data warehouse pipelines - Apify API for scheduled internal procurement jobs - Webhooks for downstream notifications after each run ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/uline-product-catalog-scraper').call({ startUrls: [{ url: 'https://www.uline.com/Product/GuidedNav?t=184360&dup=title' }], maxItems: 50, maxPages: 1, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` ### API usage with Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_APIFY_TOKEN') run = client.actor('automation-lab/uline-product-catalog-scraper').call(run_input={ 'startUrls': [{'url': 'https://www.uline.com/Product/GuidedNav?t=184360&dup=title'}], 'maxItems': 50, 'maxPages': 1, }) items = client.dataset(run['defaultDatasetId']).list_items().items print(items) ``` ### API usage with cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/automation-lab~uline-product-catalog-scraper/runs?token=YOUR_APIFY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "startUrls": [{"url": "https://www.uline.com/Product/GuidedNav?t=184360&dup=title"}], "maxItems": 50, "maxPages": 1 }' ``` ### Use with AI agents via MCP Uline Product Catalog Scraper is available as a tool for AI assistants that support the [Model Context Protocol (MCP)](https://docs.apify.com/platform/integrations/mcp). Add the Apify MCP server to your AI client with this actor selected. #### Setup for Claude Code ```bash claude mcp add --transport http apify "https://mcp.apify.com?tools=automation-lab/uline-product-catalog-scraper" ``` #### Setup for Claude Desktop, Cursor, or VS Code Add this to your MCP config file: ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=automation-lab/uline-product-catalog-scraper" } } } ``` Your AI assistant will use OAuth to authenticate with your Apify account on first use. #### Example MCP prompts Once connected, try asking your AI assistant: - "Run automation-lab/uline-product-catalog-scraper for this Uline guided navigation URL and summarize the first 20 SKUs with prices." - "Scrape this Uline category URL and create a table of SKU, name, dimensions, and price breaks." - "Monitor this Uline box category and tell me which SKUs have the lowest unit price." - "Extract all visible quantity price tiers from this Uline catalog page." - "Create a CSV-ready list of Uline SKUs, product URLs, and images." Learn more in the [Apify MCP documentation](https://docs.apify.com/platform/integrations/mcp). ### Scheduling Use Apify schedules to run the actor daily, weekly, or monthly. A common setup is: 1. Save a task with your Uline category URLs. 2. Schedule it weekly. 3. Export the dataset to Google Sheets or your data warehouse. 4. Compare the latest run with previous runs. ### Data quality notes Uline pages vary by category. Some tables expose many price tiers and product URLs, while some pages expose only basic SKU metadata. The actor saves fields when they are publicly visible in the returned HTML. Missing values are returned as `null` or empty arrays instead of invented data. ### FAQ #### Can I scrape all Uline products? You can provide public Uline category or guided navigation URLs and set `maxItems` high enough for the rows visible on those pages. Full-site discovery is not included in the first version; use targeted catalog pages for best reliability. #### Does this actor scrape private account pricing? No. It only extracts public catalog data visible without logging in. It does not access account-specific discounts, carts, invoices, or private customer data. ### Troubleshooting #### Why did I get zero products? Check that your URL is a public Uline product detail, guided navigation, or category page with product rows in the HTML. Search pages or error pages may not contain product tables. #### Do I need a proxy? Usually no. The public Uline catalog pages tested during development were reachable with normal HTTP requests. If your environment receives blocks, enable Apify Proxy and try a datacenter group first. #### Why are some fields null? Not every Uline page exposes pack quantity, weight, or availability in the same place. The actor only returns data visible on the public page. ### Legality This actor extracts publicly available catalog information. You are responsible for using the data in compliance with Uline's terms, applicable laws, and your own policies. Avoid collecting personal data and use reasonable request limits. ### Related scrapers Other ecommerce and catalog actors by Automation Lab: - https://apify.com/automation-lab/amazon-product-scraper - https://apify.com/automation-lab/shopify-scraper - https://apify.com/automation-lab/ebay-scraper - https://apify.com/automation-lab/walmart-scraper ### Changelog Initial version extracts public Uline catalog/product rows with SKU, price, price breaks, dimensions, image URLs, product URLs, and source URLs. ### Support If you find a Uline page that does not parse correctly, open an issue with the exact input URL and a short description of the expected fields. # Actor input Schema ## `startUrls` (type: `array`): Public Uline product detail, guided navigation, or category URLs. The prefilled URL is a shipping boxes guided navigation page. ## `maxItems` (type: `integer`): Maximum number of product rows to save across all start URLs. ## `maxPages` (type: `integer`): Maximum number of supplied start URLs to fetch in this run. ## `proxyConfiguration` (type: `object`): Optional Apify Proxy settings. Uline public catalog pages usually work without a proxy; enable datacenter proxy only if your environment is blocked. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.uline.com/Product/GuidedNav?t=184360&dup=title" } ], "maxItems": 20, "maxPages": 1, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 = { "startUrls": [ { "url": "https://www.uline.com/Product/GuidedNav?t=184360&dup=title" } ], "maxItems": 20, "maxPages": 1 }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/uline-product-catalog-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 = { "startUrls": [{ "url": "https://www.uline.com/Product/GuidedNav?t=184360&dup=title" }], "maxItems": 20, "maxPages": 1, } # Run the Actor and wait for it to finish run = client.actor("automation-lab/uline-product-catalog-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 '{ "startUrls": [ { "url": "https://www.uline.com/Product/GuidedNav?t=184360&dup=title" } ], "maxItems": 20, "maxPages": 1 }' | apify call automation-lab/uline-product-catalog-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/uline-product-catalog-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Uline Product Catalog Scraper", "description": "Scrape public Uline catalog products, SKUs, prices, pack data, image URLs, and product links for procurement and ecommerce monitoring.", "version": "0.1", "x-build-id": "HWBdFAJGp0CprECTY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~uline-product-catalog-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-uline-product-catalog-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/automation-lab~uline-product-catalog-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-uline-product-catalog-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/automation-lab~uline-product-catalog-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-uline-product-catalog-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": [ "startUrls" ], "properties": { "startUrls": { "title": "Uline start URLs", "type": "array", "description": "Public Uline product detail, guided navigation, or category URLs. The prefilled URL is a shipping boxes guided navigation page.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum products", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of product rows to save across all start URLs.", "default": 20 }, "maxPages": { "title": "Maximum pages", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of supplied start URLs to fetch in this run.", "default": 1 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify Proxy settings. Uline public catalog pages usually work without a proxy; enable datacenter proxy only if your environment is blocked.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```