{ "openapi": "3.0.1", "info": { "title": "AranyOldalak Scraper - Hungary Business Directory", "description": "Scrape aranyoldalak.hu (Arany Oldalak), Hungary's leading business directory. Search by category and city/county to get business names, addresses, phone numbers, emails, websites, opening hours, and coordinates.", "version": "1.0", "x-build-id": "nVjlW4vwY9kagbrCp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~aranyoldalak-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-aranyoldalak-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~aranyoldalak-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-aranyoldalak-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~aranyoldalak-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-aranyoldalak-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", "detail" ], "type": "string", "description": "What to fetch: search a business category in a city/county, or fetch full business profiles from direct aranyoldalak.hu URLs.", "default": "search" }, "category": { "title": "Category", "enum": [ "custom", "étterem", "pizzéria", "cukrászda", "kávézó", "gyorsétterem", "szálloda", "panzió", "utazási iroda", "fodrász", "kozmetika", "körömszalon", "tetoválás", "edzőterem", "masszázs", "gyógyszertár", "orvosi rendelő", "fogorvos", "állatorvos", "gyógytornász", "ügyvéd", "közjegyző", "könyvelő", "adótanácsadó", "biztosítás", "bank", "ingatlanügynökség", "autószerelő", "autókereskedés", "autómosó", "gumis", "autókölcsönző", "taxis", "villanyszerelő", "vízvezeték szerelő", "asztalos", "festő", "kőműves", "ács", "tetőfedő", "ablakos", "kertész", "virágbolt", "állatkereskedés", "bútorbolt", "építőanyag", "festékbolt", "informatikus", "webdesign", "fordítóiroda", "nyomda", "reklámügynökség", "rendezvényszervezés", "esküvőszervezés", "temetkezés", "sírkő", "zár szerviz", "klímaszerelés", "riasztószerelés", "költöztetés", "takarítás", "gépjármű szerviz", "autóalkatrész", "optika", "ékszerbolt", "cipőbolt", "ruhabolt", "élelmiszerbolt", "hentes", "pék", "bio bolt" ], "type": "string", "description": "Business category / type to search for. Pick a common category, or choose 'Custom category' and type your own below (mode=search). Values use proper Hungarian spelling/diacritics -- aranyoldalak.hu's own search matching relies on them.", "default": "étterem" }, "customCategory": { "title": "Custom category (overrides selection above)", "type": "string", "description": "Free-text business category/type not in the curated list above, e.g. 'kulcsmásolás' or 'dohánybolt' (mode=search). Takes priority over 'Category' when set. aranyoldalak.hu resolves this like its own search box, so most Hungarian business-type terms work -- use proper Hungarian diacritics for best matching." }, "location": { "title": "City or county", "enum": [ "", "custom", "Budapest", "Bács-Kiskun megye", "Baranya megye", "Békés megye", "Borsod-Abaúj-Zemplén megye", "Csongrád-Csanád megye", "Fejér megye", "Győr-Moson-Sopron megye", "Hajdú-Bihar megye", "Heves megye", "Jász-Nagykun-Szolnok megye", "Komárom-Esztergom megye", "Nógrád megye", "Pest megye", "Somogy megye", "Szabolcs-Szatmár-Bereg megye", "Tolna megye", "Vas megye", "Veszprém megye", "Zala megye", "Kecskemét", "Pécs", "Békéscsaba", "Miskolc", "Szeged", "Székesfehérvár", "Győr", "Debrecen", "Eger", "Szolnok", "Tatabánya", "Salgótarján", "Kaposvár", "Nyíregyháza", "Szekszárd", "Szombathely", "Veszprém", "Zalaegerszeg" ], "type": "string", "description": "Hungarian city or county (megye) to search in. Pick one, or choose 'Custom location' and type your own below (mode=search). Leave as 'No location filter' to search all of Hungary.", "default": "Budapest" }, "customLocation": { "title": "Custom location (overrides selection above)", "type": "string", "description": "Free-text Hungarian city, town, or district not in the curated list above, e.g. 'Siófok' or 'Gödöllő' (mode=search). Takes priority over 'City or county' when set. Use proper Hungarian diacritics for best matching." }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "az", "za", "name" ], "type": "string", "description": "How to order search results (mode=search). 'az'/'za' request aranyoldalak.hu's own alphabetical sort server-side; 'name' re-sorts the fetched batch client-side A-Z (useful if you also want fetchDetails-enriched names).", "default": "relevance" }, "fetchDetails": { "title": "Fetch full business profiles", "type": "boolean", "description": "For each search result, also visit its business profile (.htm) page to collect opening hours, business description, related category tags, precise coordinates, and logo. Slower -- one extra request per result (mode=search).", "default": false }, "businessUrls": { "title": "Business profile URLs (mode=detail)", "type": "array", "description": "Direct aranyoldalak.hu business profile URLs to fetch, e.g. https://aranyoldalak.hu/merleg-kft6.htm. Use the 'sourceUrl' field from search results.", "items": { "type": "object", "properties": { "url": { "title": "URL", "type": "string", "description": "aranyoldalak.hu business profile (.htm) URL." } } }, "default": [] }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on the number of business records to return.", "default": 20 } } }, "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 } } } } } } } } } }