{ "openapi": "3.0.1", "info": { "title": "Oechsle Peru Product Price & Stock Scraper", "description": "Scrape Oechsle Peru department store products by keyword or category. Extract price, list price, discount, stock, EAN, brand, seller and installments in Peruvian soles. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "i3MXlCnzPFh4gowXy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~oechsle-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-oechsle-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~oechsle-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-oechsle-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~oechsle-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-oechsle-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 product details", "type": "boolean", "description": "When enabled, each record also includes the product description and a specifications object (technical attributes such as model, color, warranty and dimensions).", "default": true }, "searchTerms": { "title": "Search Terms", "type": "array", "description": "Full-text queries to search the Oechsle catalog (e.g. \"televisor\", \"zapatillas\", \"laptop\"). Each term runs as a separate VTEX search. Leave empty to use Categories or a Start URL instead.", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Restrict results to one or more Oechsle departments. Each maps to the VTEX fq=C: filter.", "items": { "type": "string", "enum": [ "160", "161", "374", "1223006", "504", "9", "100", "8", "143", "301", "11", "1222515", "2746625", "2746669", "2746376", "2746781", "2746765", "2746037", "1222568" ], "enumTitles": [ "Tecnologia (Technology)", "Electrohogar (Home Appliances)", "Zapatos (Shoes)", "Zapatillas (Sneakers)", "Moda (Fashion)", "Deportes (Sports)", "Muebles (Furniture)", "Dormitorio (Bedroom)", "Decohogar (Home Decor)", "Belleza y Accesorios (Beauty & Accessories)", "Infantil (Kids)", "Supermercado (Supermarket)", "Jugueteria (Toys)", "Zona Gamer (Gaming)", "Automotriz (Automotive)", "Mejoramiento del Hogar (Home Improvement)", "Salud y Bienestar (Health & Wellness)", "Mascotas (Pets)", "Libreria y oficina (Stationery & Office)" ] } }, "startUrl": { "title": "Start URL", "type": "string", "description": "Advanced. A full VTEX catalog search URL whose query string (ft, fq, O, etc.) is used as-is, e.g. https://www.oechsle.pe/api/catalog_system/pub/products/search?ft=laptop&O=OrderByPriceASC . When set, its parameters take precedence." }, "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 Oechsle 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 Oechsle 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. \"Samsung\", \"Nike\", \"Bosch\". 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 } } } } } } } } } }