{ "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": "40U1dfxKbFCQOVOqY" }, "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": { "maxItems": { "title": "Max Items", "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": "" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. The Promart VTEX catalog API has no anti-bot protection and works from datacenter IPs, so a proxy is optional. If you ever see geo-blocking, enable Apify Proxy with Peru residential IPs.", "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 } } } } } } } } } }