{ "openapi": "3.0.1", "info": { "title": "Mironet.cz Scraper: Prices, Stock, MPN & Filters", "description": "Scrape Mironet.cz (Czech electronics shop) by category, brand, sale, search, code, EAN, MPN or product URL: price, discount, stock & delivery, stores, MPN, parameters, price history. Filters, monitoring. Unofficial.", "version": "0.0", "x-build-id": "gJbWSKBXYKw8DlNza" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tsutseisoftware~mironet-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tsutseisoftware-mironet-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/tsutseisoftware~mironet-scraper/runs": { "post": { "operationId": "runs-sync-tsutseisoftware-mironet-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/tsutseisoftware~mironet-scraper/run-sync": { "post": { "operationId": "run-sync-tsutseisoftware-mironet-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": { "startUrls": { "title": "Category, brand, sale, search or product URLs", "type": "array", "description": "Mironet.cz URLs: a category (e.g. https://www.mironet.cz/notebooky+c1504/), a category overview (…+rzn10761/, its categories are read), a brand (https://www.mironet.cz/apple+v27633/), a sale section (https://www.mironet.cz/vyprodej/?v=rozbaleno), search results (https://www.mironet.cz/ProductList/showSearch?EXPF=iphone) or a product (…+dp812263/). Tip: set filters and sorting on the website and paste the URL; the actor keeps them.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQueries": { "title": "Search terms", "type": "array", "description": "Searched with the website's own search, in its order (e.g. \"iphone 17\", \"RTX 5070\"). Up to 10 terms; \"Max pages per search\" limits each.", "items": { "type": "string" } }, "productCodes": { "title": "Mironet codes", "type": "array", "description": "Mironet product codes (\"Kód\" on the product page, e.g. 90636722). Each is looked up with the website's search and read from its product page.", "items": { "type": "string" } }, "eans": { "title": "EANs", "type": "array", "description": "EAN barcodes (check digit verified). The website's search finds a product by EAN and opens its product page; the row then has the EAN in the \"ean\" field. A product the search doesn't open directly counts as not found.", "items": { "type": "string" } }, "mpns": { "title": "MPNs (manufacturer part numbers)", "type": "array", "description": "Manufacturer part numbers (P/N, e.g. MDH74CZ/A). Looked up like EANs: only an exact match that opens a product page is returned.", "items": { "type": "string" } }, "saleSections": { "title": "Sale sections", "type": "array", "description": "Mironet.cz sale (\"Výprodej\") sections to read.", "items": { "type": "string", "enum": [ "vse", "slevy", "doprodej", "rozbaleno", "zanovni", "bazar", "repasovany" ], "enumTitles": [ "Everything on sale", "Discounts (Slevy)", "Clearance (Doprodej)", "Unpacked (Rozbaleno)", "Like new (Zánovní)", "Bazaar (Bazar)", "Refurbished (Repasovaný)" ] } }, "maxItems": { "title": "Max products", "minimum": 0, "type": "integer", "description": "Maximum number of products saved (and charged) in total. 0 = no limit.", "default": 100 }, "maxItemsPerStartUrl": { "title": "Max products per URL", "minimum": 0, "type": "integer", "description": "Maximum number of products from each start URL, search term or sale section (and from all codes, EANs or MPNs). 0 = no limit.", "default": 0 }, "includeAvailability": { "title": "Add availability", "type": "boolean", "description": "Stock as the website shows it under the price (\"Ihned na 6 prodejnách nebo u Vás doma – zítra\", \"Skladem 5+ kusů\", \"Není skladem – na dotaz\"): availability, pieces, number of stores with stock and delivery date. One small extra request per 24 products; turn off only if you need prices alone.", "default": true }, "includeDetails": { "title": "Add product page details", "type": "boolean", "description": "Reads each product page (one request per product): MPN (P/N), brand, warranty, all technical parameters, energy class, description, category breadcrumb, variants and cheaper unpacked offers, the 30-day price note. Turned on automatically by filters that need it.", "default": false }, "descriptionMaxLength": { "title": "Description length", "minimum": 0, "type": "integer", "description": "Maximum characters of the description (with details). 0 = the whole text.", "default": 1000 }, "includeStoreAvailability": { "title": "Add stock per store", "type": "boolean", "description": "Stock in each Mironet store and partner store as the \"Kdy zboží dostanu?\" window shows it (\"5+ ks – ihned\", \"zítra\"). One extra request per product.", "default": false }, "includePriceHistory": { "title": "Add price history (180 days)", "type": "boolean", "description": "The website's \"Transparentní historie ceny\": every price change of the last 180 days, plus the lowest price of 30 and 180 days and the highest of 180 days. One extra request per product. For your own analysis.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "default", "top", "cheapest", "mostExpensive", "name", "newest", "biggestDiscount" ], "type": "string", "description": "The website's sorting. \"Default\" keeps the sort of the URL; without one, categories and brand pages are read by name A–Z (the website's \"Top\" order changes between pages and would skip and repeat products), search results by relevance and sale sections by discount.", "default": "default" }, "minPrice": { "title": "Min price (CZK)", "minimum": 0, "type": "integer", "description": "Lowest price incl. VAT (the website's price filter, checked again by the actor)." }, "maxPrice": { "title": "Max price (CZK)", "minimum": 0, "type": "integer", "description": "Highest price incl. VAT (the website's price filter, checked again by the actor)." }, "brands": { "title": "Brands", "type": "array", "description": "Only these brands (the website's \"Značka\" filter where the listing has it, e.g. Lenovo, HP, DELL; elsewhere the actor checks the brand).", "items": { "type": "string" } }, "excludeBrands": { "title": "Exclude brands", "type": "array", "description": "Never these brands (the website's brand filter with all other brands, checked again by the actor).", "items": { "type": "string" } }, "productStates": { "title": "Product state", "type": "array", "description": "The website's \"Stav zboží\" filter (any of the chosen).", "items": { "type": "string", "enum": [ "new", "promo", "discounted", "unpacked", "likeNew", "topProduct", "novelty" ], "enumTitles": [ "New only (Jen nové)", "Promotions (Akční nabídky)", "Discounts (Slevy)", "Unpacked (Rozbaleno)", "Like new (Zánovní)", "Top product", "Novelty (Novinka)" ] } }, "onlyInStock": { "title": "Only in stock", "type": "boolean", "description": "The website's \"Skladem\" filter; the actor also drops products whose stock box doesn't say \"Skladem\".", "default": false }, "availableInStores": { "title": "In stock in these stores", "type": "array", "description": "The website's store filter (\"Skladem\" options), e.g. \"Praha 4-Chodov\", \"Brno\", \"Plzeň\"; part of the name is enough.", "items": { "type": "string" } }, "parameterFilters": { "title": "Parameter filters", "type": "object", "description": "The website's parameter filters by name as the filter panel shows them, e.g. {\"Typ panelu displeje\": [\"OLED\", \"IPS\"], \"Úhlopříčka displeje (\\\")\": {\"min\": 14, \"max\": 16}}. Unknown names or values are reported in the log with the options." }, "onlyDiscounted": { "title": "Only discounted", "type": "boolean", "description": "Only products with a crossed-out price.", "default": false }, "minDiscountPercent": { "title": "Min discount (%)", "minimum": 0, "type": "integer", "description": "Only products with at least this discount." }, "nameKeywords": { "title": "Name must contain", "type": "array", "description": "Any of these words (case and diacritics ignored).", "items": { "type": "string" } }, "excludeNameKeywords": { "title": "Name must not contain", "type": "array", "description": "None of these words (case and diacritics ignored).", "items": { "type": "string" } }, "labels": { "title": "Labels", "type": "array", "description": "Only products with one of these tile labels, e.g. \"Bomba ceny\", \"Slevy\", \"CZ klávesnice\".", "items": { "type": "string" } }, "excludeUnpackedAndUsed": { "title": "Only new (no unpacked, bazaar or refurbished)", "type": "boolean", "description": "Drops \"Rozbaleno\", \"Bazar\", \"Zánovní\" and refurbished offers (by the name the website gives them).", "default": false }, "onlyUnpackedOrUsed": { "title": "Only unpacked, bazaar or refurbished", "type": "boolean", "description": "Only \"Rozbaleno\", \"Bazar\", \"Zánovní\" and refurbished offers.", "default": false }, "onlyWithMpn": { "title": "Only with MPN", "type": "boolean", "description": "Only products with a manufacturer part number (turns on product page details).", "default": false }, "minWarrantyMonths": { "title": "Min warranty (months)", "minimum": 0, "type": "integer", "description": "Only products with at least this warranty (turns on product page details)." }, "energyClasses": { "title": "Energy classes", "type": "array", "description": "Only these energy classes (turns on product page details).", "items": { "type": "string", "enum": [ "A+++", "A++", "A+", "A", "B", "C", "D", "E", "F", "G" ] } }, "onlyNewOrChanged": { "title": "Monitoring: only new or changed products", "type": "boolean", "description": "Saves (and charges) only products that are new or whose price, crossed-out price or availability changed since the previous run with the same monitoring key. Ideal for scheduled runs.", "default": false }, "monitoringKey": { "title": "Monitoring key", "type": "string", "description": "Name of the saved state. Use a different key for each tracked list.", "default": "default" }, "onlyPriceChanges": { "title": "Monitoring: only price changes", "type": "boolean", "description": "Of the changed products, only those whose price changed (new products are still saved).", "default": false }, "minPriceDropPercent": { "title": "Monitoring: min price drop (%)", "minimum": 0, "type": "number", "description": "Only products whose price fell by at least this many percent since the previous run." }, "includeRemovedProducts": { "title": "Monitoring: include removed products", "type": "boolean", "description": "Adds rows with changeType \"removed\" for products that disappeared since the previous run (only after a run that read everything) and \"reappeared\" when they are back.", "default": false }, "fastMode": { "title": "Fast mode (small extra charge)", "type": "boolean", "description": "Reads Mironet.cz about 3x faster: at most 60 requests per minute and 3 at a time instead of 20 per minute and 2 at a time. It stays polite: the moment the website answers \"too many requests\", \"service unavailable\", \"forbidden\", shows a challenge or slows down, the run switches back to the normal speed for the rest of the run; it waits when the website asks it to wait and never changes IP address to get around a limit. Extra charge \"Fast mode\" ($0.01 per 1 000 products, see the Pricing tab) only for products saved while the fast speed was on.", "default": false }, "maxRequestsPerMinute": { "title": "Max requests per minute (normal speed)", "minimum": 1, "maximum": 30, "type": "integer", "description": "All requests together (pages, stock, product pages). At most 30.", "default": 20 }, "maxPagesPerCategory": { "title": "Max pages per category", "minimum": 1, "maximum": 500, "type": "integer", "description": "Listing pages (24 products each) read per category, brand or sale URL.", "default": 50 }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "maximum": 209, "type": "integer", "description": "Result pages (24 products each) read per search term. The website's search also lists loosely matching products further down.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Mironet.cz works without a proxy from Apify, so no proxy is used by default.", "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 }, "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 } } } } } } } } } }