{ "openapi": "3.0.1", "info": { "title": "Bazos Scraper: bazos.cz, bazos.sk, bazos.pl, bazos.at + alerts", "description": "Bazos scraper for bazos.cz, bazos.sk, bazos.pl and bazos.at: search by keyword, section, town radius and price. Flat rows with parsed price and price type, town and postcode, section, view count, TOP flag, posted date and photo. Monitor mode alerts on new ads and price cuts. No login, no proxy.", "version": "0.1", "x-build-id": "OyhrNwxdX45ImhGCW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datahamster~bazos-classifieds/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datahamster-bazos-classifieds", "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/datahamster~bazos-classifieds/runs": { "post": { "operationId": "runs-sync-datahamster-bazos-classifieds", "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/datahamster~bazos-classifieds/run-sync": { "post": { "operationId": "run-sync-datahamster-bazos-classifieds", "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": { "site": { "title": "Site", "enum": [ "cz", "sk", "pl", "at" ], "type": "string", "description": "Which Bazos edition to search. Accepted codes: cz (bazos.cz, Czechia, CZK), sk (bazos.sk, Slovakia, EUR), pl (bazos.pl, Poland, PLN), at (bazos.at, Austria, EUR). One run covers one site. Example: \"cz\".", "default": "cz" }, "queries": { "title": "Search queries", "type": "array", "description": "Keywords to search, one string per phrase, each paginated separately. Example: [\"kolo\", \"horske kolo\"].", "default": [ "kolo" ], "items": { "type": "string" } }, "section": { "title": "Section", "enum": [ "www", "auto", "deti", "dum", "elektro", "foto", "hudba", "knihy", "mobil", "motorky", "nabytek", "obleceni", "pc", "prace", "reality", "sluzby", "sport", "stroje", "vstupenky", "zvirata", "ostatni" ], "type": "string", "description": "Bazos section (rubrika) to search inside; \"www\" searches all sections. Accepted values: www, auto, deti, dum, elektro, foto, hudba, knihy, mobil, motorky, nabytek, obleceni, pc, prace, reality, sluzby, sport, stroje, vstupenky, zvirata, ostatni. Example: \"auto\".", "default": "www" }, "location": { "title": "Location", "type": "string", "description": "Postcode or town name for a radius search, as written on the site. Example: \"Praha\" or \"11000\". Optional; used together with radiusKm." }, "radiusKm": { "title": "Radius (km)", "minimum": 0, "maximum": 500, "type": "integer", "description": "Search radius around location, in kilometres. Example: 25. Ignored unless location is set.", "default": 25 }, "priceFrom": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Minimum price, whole number in the site's currency (CZK on bazos.cz, EUR on bazos.sk and bazos.at, PLN on bazos.pl). Example: 1000. Optional." }, "priceTo": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Maximum price, whole number in the site's currency. Example: 20000. Optional." }, "sortBy": { "title": "Sort", "enum": [ "newest", "price_asc", "price_desc", "views" ], "type": "string", "description": "Result order: newest (newest first), price_asc (cheapest first), price_desc, views (most viewed first). Example: \"newest\".", "default": "newest" }, "maxPages": { "title": "Pages per query", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many result pages to fetch per query, 20 ads per page. Example: 5.", "default": 5 }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop the run after this many ads; you are charged only for ads actually pushed. Example: 20.", "default": 20 }, "mode": { "title": "Mode", "enum": [ "scrape", "monitor" ], "type": "string", "description": "scrape = return all matching ads; monitor = return only ads that are new or changed price since the previous run of this saved Task. Example: \"scrape\".", "default": "scrape" }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Optional state key for monitor mode when the actor is started directly instead of from a saved Task; any stable string, e.g. \"kolo-cz\"." }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional HTTPS URL that receives a POST with the monitor-mode change summary (JSON). Example: \"https://hooks.example.com/bazos\"." }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "Optional Telegram bot token used to send monitor-mode change summaries. Format: \"123456789:AA...\"." }, "telegramChatId": { "title": "Telegram chat id", "type": "string", "description": "Optional Telegram chat id that receives monitor-mode summaries. Example: \"-1001234567890\"." } } }, "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 } } } } } } } } } }