{ "openapi": "3.0.1", "info": { "title": "Bazos Mega Scraper — SK / CZ / AT / PL", "description": "Powerful scraper for Bazos. Scrapes all 4 country domains with detail pages, all images, seller info, GPS coordinates, and flexible input modes.", "version": "1.0", "x-build-id": "3HfbebKNGerqKTNqE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maxai~bazos-mega-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maxai-bazos-mega-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/maxai~bazos-mega-scraper/runs": { "post": { "operationId": "runs-sync-maxai-bazos-mega-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/maxai~bazos-mega-scraper/run-sync": { "post": { "operationId": "run-sync-maxai-bazos-mega-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": { "mode": { "title": "Scraping Mode", "enum": [ "SEARCH", "CATEGORY", "URLS" ], "type": "string", "description": "SEARCH: Search by keyword across categories. CATEGORY: Browse a specific category. URLS: Scrape specific listing or category URLs directly.", "default": "SEARCH" }, "country": { "title": "Country", "enum": [ "sk", "cz", "at", "pl" ], "type": "string", "description": "Which Bazos country domain to scrape.", "default": "sk" }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Search keyword (e.g. 'iphone 15', 'skoda octavia'). Used only in SEARCH mode." }, "strictTitleMatch": { "title": "Strict Title Match", "type": "boolean", "description": "If enabled, only listings where the title contains your search query will be scraped. This filters out irrelevant results like accessories or trade offers that only mention your query in the description.", "default": false }, "category": { "title": "Category", "enum": [ "", "auto", "deti", "dom", "elektro", "foto", "hudba", "knihy", "mobil", "motocykle", "nabytok", "oblecenie", "pc", "praca", "reality", "sluzby", "sport", "stroje", "vstupenky", "zvierata", "ostatne" ], "type": "string", "description": "Category to browse or search within. Leave empty to search all categories.", "default": "" }, "subcategory": { "title": "Subcategory", "type": "string", "description": "Optional subcategory slug (e.g. 'notebook' for PC, 'apple' for Mobily, 'skoda' for Auto). Check bazos.sk for available subcategories.", "default": "" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct listing or category page URLs to scrape. Used only in URLS mode.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "location": { "title": "Location (PSČ / City)", "type": "string", "description": "Postal code or city name for location-based filtering (e.g. '84101', 'Bratislava').", "default": "" }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Search radius in kilometers from the specified location. Only works when Location is set.", "default": 25 }, "minPrice": { "title": "Minimum Price", "type": "integer", "description": "Minimum price filter. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum Price", "type": "integer", "description": "Maximum price filter. Leave empty for no maximum." }, "sortBy": { "title": "Sort By", "enum": [ "date", "price", "views" ], "type": "string", "description": "How to sort the results.", "default": "date" }, "maxResults": { "title": "Maximum Results", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum number of listings to scrape. Set 0 for unlimited.", "default": 50 }, "maxPages": { "title": "Maximum Pages", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Maximum number of listing pages to paginate through. 0 = unlimited.", "default": 0 }, "scrapeDetails": { "title": "Scrape Detail Pages", "type": "boolean", "description": "If true, visits each listing's detail page to extract full description, all images, seller info, and GPS coordinates. Slower but much richer data. If false, only extracts data visible on listing pages (fast mode).", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for avoiding IP blocks. Recommended for large scrapes.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }