{ "openapi": "3.0.1", "info": { "title": "Uline Product Catalog Scraper: Bulk Pricing, Dimensions & Stock", "description": "Scrape Uline's product catalog across the US, Canada, and Mexico: SKUs, prices, bulk quantity tiers, dimensions, shipping weight, stock status, country of origin, and specs. Search by keyword, paste category URLs, or sweep the full catalog. Export to CSV, JSON, Excel, or Sheets.", "version": "0.2", "x-build-id": "Coh6IqHXHx8neh30i" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~uline-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-uline-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/getascraper~uline-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-uline-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/getascraper~uline-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-uline-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": { "scrapeMode": { "title": "Scraping Mode", "enum": [ "providedUrls", "searchKeyword", "fullCatalog" ], "type": "string", "description": "How to find products: paste specific Uline URLs, search by keyword, or discover the full catalog automatically.", "default": "searchKeyword" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Uline category, listing, or product detail URLs to scrape. Used in Provided URLs mode and as optional seed URLs in Full Catalog mode.", "default": [ { "url": "https://www.uline.com/BL_440/Lightweight-32-ECT-Boxes" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQuery": { "title": "Search Keywords", "type": "string", "description": "Search term to look up across Uline. Required in Search by Keyword mode.", "default": "" }, "domain": { "title": "Uline Domain", "enum": [ "uline.com", "uline.ca", "uline.mx" ], "type": "string", "description": "Regional Uline domain to scrape: US (USD), Canada (CAD), or Mexico (MXN).", "default": "uline.com" }, "language": { "title": "Language", "enum": [ "en", "fr", "es" ], "type": "string", "description": "Language subpath to use when browsing the Uline site.", "default": "en" }, "includeSpecs": { "title": "Extract dimensions and weight", "type": "boolean", "description": "Extract product length, width, height, and shipping weight for freight and logistics calculations.", "default": true }, "includeTiers": { "title": "Extract bulk pricing tiers", "type": "boolean", "description": "Extract all quantity price breaks (e.g. 1-unit price vs. 25-unit price), useful for procurement and reseller margin analysis.", "default": true }, "includeDescription": { "title": "Extract product descriptions", "type": "boolean", "description": "Extract the product description text shown on each Uline detail page.", "default": true }, "includeGallery": { "title": "Extract image gallery", "type": "boolean", "description": "Extract all secondary product image URLs in addition to the main image.", "default": true }, "maxItems": { "title": "Maximum products", "minimum": 1, "maximum": 500000, "type": "integer", "description": "Maximum number of product records to collect in one run. Set a lower limit for targeted runs; increase for full category sweeps.", "default": 120 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Residential proxies are required to reliably bypass Uline's bot protection. Switching to datacenter proxies will cause blocks.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }