{ "openapi": "3.0.1", "info": { "title": "Zlaté stránky Business Directory Scraper", "description": "Scrape Zlaté stránky (zlatestranky.sk), Slovakia's leading business directory. Search by keyword, browse by category, or fetch business detail pages directly. Get name, address, phone, email, website, opening hours, rating and more - no login required.", "version": "1.0", "x-build-id": "xgq6npodVwaZYZpfg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~zlatestranky-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-zlatestranky-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/crawlerbros~zlatestranky-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-zlatestranky-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/crawlerbros~zlatestranky-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-zlatestranky-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byCategory", "byUrl" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Free-text keyword, e.g. business name, trade, or service (\"reštaurácia\", \"kaderníctvo\", \"advokáti\").", "default": "reštaurácia" }, "category": { "title": "Category (mode=byCategory)", "type": "string", "description": "A Zlaté stránky category/trade search term. Type any term you find while browsing the site's category index at zlatestranky.sk/rubriky-az/, or copy one of the 51 curated examples below into the field.\n\nCurated examples:\n`reštaurácie` (Restaurants), `advokáti` (Lawyers), `lekári` (Doctors), `lekárne` (Pharmacies), `realitné kancelárie` (Real estate agencies), `kaderníctvo` (Hairdressers), `elektroinštalácie` (Electrical installations), `automobily - servisy` (Car repair shops), `nábytok` (Furniture), `cestovné kancelárie a agentúry` (Travel agencies), `upratovacie služby` (Cleaning services), `gastronomické služby` (Catering services), `ubytovne` (Hostels/lodging), `automobily - náhradné dielce` (Car parts), `maliari interiérov` (Interior painters), `geodézia` (Surveying), `architekti` (Architects), `e-shopy` (Online shops), `inštalatéri` (Plumbers), `taxislužba` (Taxi service), `ekonomické poradenstvo` (Economic consulting), `inžinierska činnosť` (Engineering services), `veterinári` (Veterinarians), `autobazáre` (Used car dealers), `zabezpečovacie zariadenia a systémy` (Security systems), `automobily - príslušenstvo a doplnky` (Car accessories), `automobily - požičovne` (Car rentals), `autobusová doprava` (Bus transport), `kamenárstvo` (Stonemasonry), `banky` (Banks), `elektrikári` (Electricians), `ubytovanie v súkromí` (Private accommodation), `interiéry` (Interior design), `jazykové školy` (Language schools), `darčekové predmety` (Gift shops), `informačné systémy` (IT/information systems), `papiernictvá` (Stationery stores), `internet - pripojenie` (Internet providers), `deratizácia` (Pest control), `manikúra` (Manicure), `pedikúra` (Pedicure), `kanalizácia` (Sewerage services), `zariadenia pre seniorov` (Senior care facilities), `audítori` (Auditors), `elektrické spotrebiče` (Electrical appliances), `kancelárie - prenájom` (Office rental), `herne a kasína` (Gaming halls & casinos), `daňové poradenstvo` (Tax consulting), `gastronómia` (Gastronomy), `jedálne` (Canteens), `hasiči` (Fire safety services), `bicykle` (Bicycles), `kúpaliská, plavárne` (Swimming pools)", "default": "reštaurácie" }, "city": { "title": "City / town", "type": "string", "description": "Restrict results to a Slovak city or town, matching zlatestranky.sk's own city-scoped URLs. Works with any mode. Leave empty for nationwide results. Any valid Slovak town name is accepted; common examples: `Bratislava`, `Košice`, `Prešov`, `Žilina`, `Banská Bystrica`, `Nitra`, `Trnava`, `Trenčín`, `Martin`, `Poprad`, `Prievidza`, `Zvolen`, `Považská Bystrica`, `Michalovce`, `Spišská Nová Ves`, `Komárno`, `Levice`, `Humenné`, `Bardejov`, `Liptovský Mikuláš`, `Ružomberok`, `Piešťany`, `Topoľčany`, `Lučenec`, `Čadca`, `Dunajská Streda`, `Rimavská Sobota`, `Vranov nad Topľou`, `Šaľa`, `Pezinok`, `Nové Zámky`, `Trebišov`." }, "urls": { "title": "Business detail URLs (mode=byUrl)", "type": "array", "description": "Full zlatestranky.sk detail-page URLs, e.g. `https://www.zlatestranky.sk/firmy/Bratislava/H681768/Luigi+No.+1,+s.r.o./`.", "default": [], "items": { "type": "string" } }, "keyword": { "title": "Keyword filter", "type": "string", "description": "Only keep results whose name, description, categories, or services contain this text (case- and diacritics-insensitive)." }, "minRating": { "title": "Minimum rating (0-5)", "minimum": 0, "maximum": 5, "type": "number", "description": "Drop businesses with a review rating below this value." }, "openNowOnly": { "title": "Open now only", "type": "boolean", "description": "Only emit businesses currently marked as open on zlatestranky.sk.", "default": false }, "fetchDetails": { "title": "Fetch full detail page per business", "type": "boolean", "description": "For search/byCategory modes: visit each business's detail page to also collect review count, full per-day opening hours, services offered, accepted payment methods, related keywords, and gallery photos. Slower (1 extra request per business).", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on emitted records.", "default": 30 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy settings. Leave empty to use no proxy — zlatestranky.sk is publicly accessible without one. The actor automatically escalates to the free AUTO datacenter proxy group if it hits a 403/429." } } }, "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 } } } } } } } } } }