{ "openapi": "3.0.1", "info": { "title": "Promart Peru Hardware Price Scraper", "description": "Scrape Promart product prices from Peru's home improvement and hardware retailer. Extract name, brand, price and list price in soles (PEN), EAN barcode, stock, seller and category across tools, paint and construction. Export JSON, CSV, Excel.", "version": "0.1", "x-build-id": "HIuxe2PAl2sUb4iok" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~promart-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-promart-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/scrapers_lat~promart-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-promart-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/scrapers_lat~promart-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-promart-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": { "maxProducts": { "title": "Max products", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of product offers to collect across all searches and categories. Each available SKU and seller is one record. Optional." }, "withDetails": { "title": "Include Details", "type": "boolean", "description": "When enabled, each record also includes the product description and a specifications object (material, model, warranty, dimensions, and so on).", "default": true }, "searchTerms": { "title": "Search Terms", "type": "array", "description": "Full-text queries to search the Promart catalog (e.g. \"taladro\", \"pintura\", \"cemento\"). Each term is searched separately. Maps to the VTEX ft parameter.", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Restrict results to one or more Promart departments. Maps to the VTEX fq=C: filter.", "items": { "type": "string", "enum": [ "599", "12", "18", "20", "21", "19", "17", "16", "629", "653", "15", "687", "688", "804", "32", "879", "890", "908", "913", "1075", "1088", "1101", "1130", "1286", "1299", "1435", "1488", "1936", "1977", "1984" ], "enumTitles": [ "Electrohogar (Home Appliances)", "Aire Libre (Outdoors)", "Iluminacion (Lighting)", "Limpieza (Cleaning)", "Ceramicos y Pisos (Tiles & Flooring)", "Pinturas y Acabados (Paint & Finishes)", "Herramientas (Tools)", "Ferreteria (Hardware)", "Gasfiteria (Plumbing)", "Electricidad (Electrical)", "Construccion (Construction)", "Bano (Bathroom)", "Cocina (Kitchen)", "Tecnologia (Technology)", "Terrazas (Terraces)", "Jardineria (Gardening)", "Muebles (Furniture)", "Organizacion (Organization)", "Deco Hogar (Home Decor)", "Dormitorio (Bedroom)", "Infantil (Kids)", "Deportes (Sports)", "Automotriz (Automotive)", "Oficina y Escolar (Office & School)", "Instrumentos Musicales (Musical Instruments)", "Salud (Health)", "Mascotas (Pets)", "Calzado (Footwear)", "Accesorios (Accessories)", "Belleza y Cuidado Personal (Beauty & Personal Care)" ] } }, "sortOrder": { "title": "Sort Order", "enum": [ "", "OrderByPriceASC", "OrderByPriceDESC", "OrderByTopSaleDESC", "OrderByReviewRateDESC", "OrderByNameASC", "OrderByNameDESC", "OrderByReleaseDateDESC", "OrderByBestDiscountDESC" ], "type": "string", "description": "Order in which the catalog returns products. Maps to the VTEX O parameter.", "default": "" }, "minPrice": { "title": "Minimum price (PEN)", "minimum": 0, "type": "integer", "description": "Only return offers with a selling price at or above this amount in Peruvian soles. Applied at the Promart catalog level. Optional." }, "maxPrice": { "title": "Maximum price (PEN)", "minimum": 0, "type": "integer", "description": "Only return offers with a selling price at or below this amount in Peruvian soles. Applied at the Promart catalog level. Optional." }, "brands": { "title": "Brands", "type": "array", "description": "Keep only products whose brand matches one of these names (case-insensitive, partial match), e.g. \"Bosch\", \"Stanley\", \"Truper\". Leave empty to include all brands.", "items": { "type": "string" } }, "onlyAvailable": { "title": "In-stock only", "type": "boolean", "description": "When enabled, only products currently available to buy (with stock) are returned.", "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 } } }, "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 } } } } } } } } } }