{ "openapi": "3.0.1", "info": { "title": "Easy Chile Scraper - Hardware, Home & Construction Prices", "description": "Scrape Easy.cl, Chile's hardware, home and construction retailer: product name, brand, category, EAN, list and offer price in CLP, live stock, seller and image for every SKU found by search term. Export CSV, Excel, JSON. No login or API key. 50 products per request.", "version": "0.1", "x-build-id": "K2D7AJIAAvr9INGgf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/recordsdata~easy-chile-hardware-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-recordsdata-easy-chile-hardware-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/recordsdata~easy-chile-hardware-scraper/runs": { "post": { "operationId": "runs-sync-recordsdata-easy-chile-hardware-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/recordsdata~easy-chile-hardware-scraper/run-sync": { "post": { "operationId": "run-sync-recordsdata-easy-chile-hardware-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": { "searchTerms": { "title": "Search terms", "maxItems": 100, "type": "array", "description": "Product keywords to search on Easy.cl (Chile hardware, home and construction retailer), in Spanish, e.g. \"martillo\", \"taladro\", \"tornillo\". Each term returns its matching products with price, discount, stock and brand. Leave empty to browse only by category, brand or product URL.", "default": [], "items": { "type": "string" } }, "categories": { "title": "Categories (optional)", "maxItems": 50, "type": "array", "description": "Limit the search to Easy.cl categories. Accepts a category name (\"Herramientas\"), a path (\"Ferretería y Gasfitería/Fijaciones y Adhesivos\"), a category id or an easy.cl category URL. With no search term, the whole category is listed. Each term and category pair is one search.", "default": [], "items": { "type": "string" } }, "brands": { "title": "Brands (optional)", "maxItems": 50, "type": "array", "description": "Limit the search to brands, spelled as on the product (for example \"Bosch\", \"Makita\", \"Stanley\"). With no search term, every product of the brand is listed.", "default": [], "items": { "type": "string" } }, "productUrls": { "title": "Product URLs or IDs (optional)", "maxItems": 500, "type": "array", "description": "Fetch specific products: easy.cl product links (they end in /p) or numeric product ids. Every size and color variant (SKU) of the product is returned.", "default": [], "items": { "type": "string" } }, "maxItemsPerSearch": { "title": "Max results per search", "minimum": 1, "maximum": 2500, "type": "integer", "description": "Maximum number of products (SKUs) to collect for each search (each term, category, brand or product URL). Free plan accounts are limited to 10 per search. You are charged per product delivered, so lower this number to cap cost. Easy.cl serves at most the first 2,500 results of one search.", "default": 50 }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "priceAsc", "priceDesc", "nameAsc", "nameDesc", "newest", "bestSellers", "biggestDiscount" ], "type": "string", "description": "Order of the results. Applied by Easy.cl before the result limit, so \"Biggest discount\" with a limit of 10 gives the 10 best deals.", "default": "relevance" }, "minPrice": { "title": "Min price (CLP)", "minimum": 0, "type": "integer", "description": "Only products priced at or above this amount, in Chilean pesos. Applied by Easy.cl before the result limit." }, "maxPrice": { "title": "Max price (CLP)", "minimum": 0, "type": "integer", "description": "Only products priced at or below this amount, in Chilean pesos. Applied by Easy.cl before the result limit." }, "onlyDiscounts": { "title": "Only products on sale", "type": "boolean", "description": "Return only products whose price is below the list price. The discount percent and amount are in the output.", "default": false }, "minDiscountPercent": { "title": "Min discount (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Only products with at least this discount off the list price, for example 30." }, "onlyInStock": { "title": "Only products in stock", "type": "boolean", "description": "Skip products that are out of stock or have no units available.", "default": false }, "includeDetails": { "title": "Include description, specifications and all images", "type": "boolean", "description": "Adds the product description, the specification table (material, power, warranty and more), and up to 10 image links. Turn off for smaller, faster rows when you only need prices.", "default": true }, "onlyChanged": { "title": "Only new or changed products", "type": "boolean", "description": "Return a product only when it is new or its price, list price or availability changed since the last run. Unchanged products are skipped and not charged. Each row carries changeType new or changed. A product found by two searches in the same monitor is delivered once.", "default": false }, "stateKey": { "title": "Monitor name (optional)", "type": "string", "description": "Name for the memory of previous results. Leave empty to derive it from your filters. Use the same name to share memory between runs, or a different name to keep separate monitors.", "default": "" }, "resetSeen": { "title": "Forget previous results", "type": "boolean", "description": "Clear the memory for this monitor before the run, so every product counts as new again.", "default": 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 }, "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 } } } } } } } } } }