{
  "data": {
    "id": "B6YBOhfbErzFc99u4",
    "actId": "HHgNvADWxphGzbm8Y",
    "userId": "zq8lKbpLzTjGDayPC",
    "startedAt": "2026-11-21T09:43:47.767Z",
    "finishedAt": "2026-11-21T09:43:51.918Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 4066,
      "runTimeSecs": 4.066,
      "computeUnits": 0.004517777777777778,
      "imageSizeBytes": 332610048
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "GK9YjZRyQZVzOdoH5",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"AranyOldalak Scraper Input\",\n  \"description\": \"Search aranyoldalak.hu (Arany Oldalak / Golden Pages), Hungary's leading business directory, by category and city/county, or fetch full business profiles by direct URL.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to fetch: search a business category in a city/county, or fetch full business profiles from direct aranyoldalak.hu URLs.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"detail\"\n      ],\n      \"enumTitles\": [\n        \"Search by category & city/county\",\n        \"Fetch business profiles by URL\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"category\": {\n      \"title\": \"Category\",\n      \"type\": \"string\",\n      \"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.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"custom\",\n        \"étterem\",\n        \"pizzéria\",\n        \"cukrászda\",\n        \"kávézó\",\n        \"gyorsétterem\",\n        \"szálloda\",\n        \"panzió\",\n        \"utazási iroda\",\n        \"fodrász\",\n        \"kozmetika\",\n        \"körömszalon\",\n        \"tetoválás\",\n        \"edzőterem\",\n        \"masszázs\",\n        \"gyógyszertár\",\n        \"orvosi rendelő\",\n        \"fogorvos\",\n        \"állatorvos\",\n        \"gyógytornász\",\n        \"ügyvéd\",\n        \"közjegyző\",\n        \"könyvelő\",\n        \"adótanácsadó\",\n        \"biztosítás\",\n        \"bank\",\n        \"ingatlanügynökség\",\n        \"autószerelő\",\n        \"autókereskedés\",\n        \"autómosó\",\n        \"gumis\",\n        \"autókölcsönző\",\n        \"taxis\",\n        \"villanyszerelő\",\n        \"vízvezeték szerelő\",\n        \"asztalos\",\n        \"festő\",\n        \"kőműves\",\n        \"ács\",\n        \"tetőfedő\",\n        \"ablakos\",\n        \"kertész\",\n        \"virágbolt\",\n        \"állatkereskedés\",\n        \"bútorbolt\",\n        \"építőanyag\",\n        \"festékbolt\",\n        \"informatikus\",\n        \"webdesign\",\n        \"fordítóiroda\",\n        \"nyomda\",\n        \"reklámügynökség\",\n        \"rendezvényszervezés\",\n        \"esküvőszervezés\",\n        \"temetkezés\",\n        \"sírkő\",\n        \"zár szerviz\",\n        \"klímaszerelés\",\n        \"riasztószerelés\",\n        \"költöztetés\",\n        \"takarítás\",\n        \"gépjármű szerviz\",\n        \"autóalkatrész\",\n        \"optika\",\n        \"ékszerbolt\",\n        \"cipőbolt\",\n        \"ruhabolt\",\n        \"élelmiszerbolt\",\n        \"hentes\",\n        \"pék\",\n        \"bio bolt\"\n      ],\n      \"enumTitles\": [\n        \"Custom category (type below)\",\n        \"Restaurant\",\n        \"Pizzeria\",\n        \"Confectionery / Pastry shop\",\n        \"Cafe\",\n        \"Fast food\",\n        \"Hotel\",\n        \"Guesthouse / B&B\",\n        \"Travel agency\",\n        \"Hairdresser\",\n        \"Beauty salon\",\n        \"Nail salon\",\n        \"Tattoo studio\",\n        \"Gym / Fitness center\",\n        \"Massage\",\n        \"Pharmacy\",\n        \"Doctor's office\",\n        \"Dentist\",\n        \"Veterinarian\",\n        \"Physiotherapist\",\n        \"Lawyer\",\n        \"Notary\",\n        \"Accountant / Bookkeeper\",\n        \"Tax advisor\",\n        \"Insurance\",\n        \"Bank\",\n        \"Real estate agency\",\n        \"Car mechanic / Auto repair\",\n        \"Car dealership\",\n        \"Car wash\",\n        \"Tire service\",\n        \"Car rental\",\n        \"Taxi service\",\n        \"Electrician\",\n        \"Plumber\",\n        \"Carpenter\",\n        \"Painter\",\n        \"Bricklayer / Mason\",\n        \"Roof carpenter\",\n        \"Roofer\",\n        \"Window installer\",\n        \"Gardener\",\n        \"Flower shop\",\n        \"Pet shop\",\n        \"Furniture store\",\n        \"Building materials\",\n        \"Paint shop\",\n        \"IT specialist\",\n        \"Web design\",\n        \"Translation agency\",\n        \"Print shop\",\n        \"Advertising agency\",\n        \"Event planning\",\n        \"Wedding planning\",\n        \"Funeral services\",\n        \"Gravestones\",\n        \"Locksmith\",\n        \"Air conditioning installation\",\n        \"Alarm system installation\",\n        \"Moving / Relocation services\",\n        \"Cleaning services\",\n        \"Vehicle service\",\n        \"Auto parts\",\n        \"Optician\",\n        \"Jewelry store\",\n        \"Shoe store\",\n        \"Clothing store\",\n        \"Grocery store\",\n        \"Butcher\",\n        \"Bakery\",\n        \"Organic / health food store\"\n      ],\n      \"default\": \"étterem\",\n      \"prefill\": \"étterem\"\n    },\n    \"customCategory\": {\n      \"title\": \"Custom category (overrides selection above)\",\n      \"type\": \"string\",\n      \"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.\",\n      \"editor\": \"textfield\"\n    },\n    \"location\": {\n      \"title\": \"City or county\",\n      \"type\": \"string\",\n      \"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.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"custom\",\n        \"Budapest\",\n        \"Bács-Kiskun megye\",\n        \"Baranya megye\",\n        \"Békés megye\",\n        \"Borsod-Abaúj-Zemplén megye\",\n        \"Csongrád-Csanád megye\",\n        \"Fejér megye\",\n        \"Győr-Moson-Sopron megye\",\n        \"Hajdú-Bihar megye\",\n        \"Heves megye\",\n        \"Jász-Nagykun-Szolnok megye\",\n        \"Komárom-Esztergom megye\",\n        \"Nógrád megye\",\n        \"Pest megye\",\n        \"Somogy megye\",\n        \"Szabolcs-Szatmár-Bereg megye\",\n        \"Tolna megye\",\n        \"Vas megye\",\n        \"Veszprém megye\",\n        \"Zala megye\",\n        \"Kecskemét\",\n        \"Pécs\",\n        \"Békéscsaba\",\n        \"Miskolc\",\n        \"Szeged\",\n        \"Székesfehérvár\",\n        \"Győr\",\n        \"Debrecen\",\n        \"Eger\",\n        \"Szolnok\",\n        \"Tatabánya\",\n        \"Salgótarján\",\n        \"Kaposvár\",\n        \"Nyíregyháza\",\n        \"Szekszárd\",\n        \"Szombathely\",\n        \"Veszprém\",\n        \"Zalaegerszeg\"\n      ],\n      \"enumTitles\": [\n        \"No location filter (search all of Hungary)\",\n        \"Custom location (type below)\",\n        \"Budapest\",\n        \"Bács-Kiskun county\",\n        \"Baranya county\",\n        \"Békés county\",\n        \"Borsod-Abaúj-Zemplén county\",\n        \"Csongrád-Csanád county\",\n        \"Fejér county\",\n        \"Győr-Moson-Sopron county\",\n        \"Hajdú-Bihar county\",\n        \"Heves county\",\n        \"Jász-Nagykun-Szolnok county\",\n        \"Komárom-Esztergom county\",\n        \"Nógrád county\",\n        \"Pest county\",\n        \"Somogy county\",\n        \"Szabolcs-Szatmár-Bereg county\",\n        \"Tolna county\",\n        \"Vas county\",\n        \"Veszprém county\",\n        \"Zala county\",\n        \"Kecskemét\",\n        \"Pécs\",\n        \"Békéscsaba\",\n        \"Miskolc\",\n        \"Szeged\",\n        \"Székesfehérvár\",\n        \"Győr\",\n        \"Debrecen\",\n        \"Eger\",\n        \"Szolnok\",\n        \"Tatabánya\",\n        \"Salgótarján\",\n        \"Kaposvár\",\n        \"Nyíregyháza\",\n        \"Szekszárd\",\n        \"Szombathely\",\n        \"Veszprém\",\n        \"Zalaegerszeg\"\n      ],\n      \"default\": \"Budapest\",\n      \"prefill\": \"Budapest\"\n    },\n    \"customLocation\": {\n      \"title\": \"Custom location (overrides selection above)\",\n      \"type\": \"string\",\n      \"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.\",\n      \"editor\": \"textfield\"\n    },\n    \"sortBy\": {\n      \"title\": \"Sort order\",\n      \"type\": \"string\",\n      \"description\": \"How to order search results (mode=search). aranyoldalak.hu ignores its own sort parameter, so 'az'/'za'/'name' all re-sort the specific batch this run fetches client-side (useful together with fetchDetails).\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"relevance\",\n        \"az\",\n        \"za\",\n        \"name\"\n      ],\n      \"enumTitles\": [\n        \"Relevance (aranyoldalak.hu's own order)\",\n        \"A-Z (client-side)\",\n        \"Z-A (client-side)\",\n        \"Name A-Z (client-side, applied to fetched batch)\"\n      ],\n      \"default\": \"relevance\",\n      \"prefill\": \"relevance\"\n    },\n    \"fetchDetails\": {\n      \"title\": \"Fetch full business profiles\",\n      \"type\": \"boolean\",\n      \"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).\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"businessUrls\": {\n      \"title\": \"Business profile URLs (mode=detail)\",\n      \"type\": \"array\",\n      \"description\": \"Direct aranyoldalak.hu business profile URLs to fetch, e.g. https://aranyoldalak.hu/merleg-kft6.htm. Use the 'sourceUrl' field from search results.\",\n      \"editor\": \"requestListSources\",\n      \"items\": {\n        \"type\": \"object\",\n        \"properties\": {\n          \"url\": {\n            \"type\": \"string\",\n            \"description\": \"aranyoldalak.hu business profile (.htm) URL.\",\n            \"title\": \"URL\"\n          }\n        }\n      },\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on the number of business records to return.\",\n      \"minimum\": 1,\n      \"maximum\": 1000,\n      \"default\": 20,\n      \"prefill\": 20\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# AranyOldalak Scraper - Hungary Business Directory\n\nScrape **aranyoldalak.hu** (Arany Oldalak / \"Golden Pages\") — Hungary's leading online business directory. Search any business category in any Hungarian city or county and get business names, addresses, phone numbers, emails, websites, opening hours, and GPS coordinates. Optionally follow through to each business's full profile page for a richer description, related category tags, fax number, extra phone numbers/websites, a price-range badge, payment methods, spoken languages, and a photo gallery. No login, no cookies, no API key required.\n\n## What this actor does\n\n- **Two modes:** `search` (category + city/county) and `detail` (direct business profile URLs)\n- **70+ curated business categories** to pick from, or type any custom category in Hungarian\n- **All 19 Hungarian counties (megye) + Budapest + 18 major cities** available as one-click location filters, in addition to free-text city/town search\n- **Sort by** relevance, A-Z, or Z-A\n- **Rich business profiles** — structured opening hours (per day of the week), business description, related category/location tags, precise GPS coordinates, logo, photo gallery, fax number, extra phone numbers/websites when a business lists more than one, price-range badge, accepted payment methods, brands, and spoken languages (when the business provides them)\n- **Full Hungarian character support** — á, é, í, ó, ö, ő, ú, ü, ű are handled correctly in both input and output\n- **Empty fields are omitted** — you only ever see fields that were actually found for a business\n\n## Output per business\n\n- `name` — business name\n- `category` — primary listed category (mode=detail, from the page's own breadcrumb)\n- `categories[]` — related category + location tags the business is listed under (mode=detail)\n- `description` — business \"about\" text (mode=detail) or short listing description (mode=search)\n- `street`, `postalCode`, `city`\n- `latitude`, `longitude` — GPS coordinates\n- `phone`, `email`, `website`\n- `additionalPhones[]` — extra phone numbers beyond the primary `phone`, when a business lists more than one (mode=detail)\n- `fax` — fax number, when listed separately from the phone number(s) (mode=detail)\n- `additionalWebsites[]` — extra website/booking/menu links beyond the primary `website`, when a business lists more than one (mode=detail)\n- `priceRange` — price-tier badge (e.g. `$$`), when the business has one set (mode=detail, mostly hospitality listings)\n- `paymentMethods[]` — accepted payment methods, when the business lists them (mode=detail, or the search card when shown there)\n- `languagesSpoken[]` — languages the business serves customers in, when listed (mode=detail, or the search card when shown there)\n- `brands[]` — brands the business carries or is affiliated with, when listed (mode=detail, or the search card when shown there)\n- `images[]` — photo gallery image URLs (mode=detail)\n- `logoUrl` — business logo image (mode=detail)\n- `openingHours[]` — structured opening hours (`{day, hours}` per day of the week; mode=detail or `fetchDetails: true`)\n- `searchCategory`, `searchLocation` — the search parameters used (mode=search)\n- `sourceUrl` — canonical aranyoldalak.hu profile URL for the business\n- `businessId` — aranyoldalak.hu's internal listing ID (mode=search)\n- `recordType: \"business\"`, `scrapedAt`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string (select) | `search` | `search` (category + city/county) or `detail` (fetch by URL) |\n| `category` | string (select) | `étterem` | Pick a common category, or `custom` to use `customCategory` (mode=search) |\n| `customCategory` | string | – | Any free-text Hungarian business category, overrides `category` (mode=search) |\n| `location` | string (select) | `Budapest` | Hungarian city or county to search in, or leave as \"No location filter\" for all of Hungary |\n| `customLocation` | string | – | Any free-text Hungarian city/town, overrides `location` (mode=search) |\n| `sortBy` | string (select) | `relevance` | `relevance` (site's own order) / `az` / `za` / `name` — the latter three all re-sort the fetched batch client-side |\n| `fetchDetails` | boolean | `false` | Also visit each business's profile page for opening hours, description, tags, and logo (slower) |\n| `businessUrls` | array | – | aranyoldalak.hu profile URLs to fetch directly (mode=detail) |\n| `maxItems` | int | `20` | Hard cap on returned records (1-1000) |\n\n### Example: search restaurants in Budapest\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"étterem\",\n  \"location\": \"Budapest\",\n  \"maxItems\": 20\n}\n```\n\n### Example: accountants in Nógrád county, with full profiles\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"könyvelő\",\n  \"location\": \"Nógrád megye\",\n  \"fetchDetails\": true,\n  \"maxItems\": 30\n}\n```\n\n### Example: car mechanics nationwide, A-Z\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"autószerelő\",\n  \"location\": \"\",\n  \"sortBy\": \"az\",\n  \"maxItems\": 100\n}\n```\n\n### Example: custom category and city not in the curated lists\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"custom\",\n  \"customCategory\": \"kulcsmásolás\",\n  \"location\": \"custom\",\n  \"customLocation\": \"Siófok\",\n  \"maxItems\": 20\n}\n```\n\n### Example: fetch specific business profiles\n\n```json\n{\n  \"mode\": \"detail\",\n  \"businessUrls\": [\n    { \"url\": \"https://aranyoldalak.hu/merleg-kft6.htm\" }\n  ]\n}\n```\n\n## Use cases\n\n- **Local lead generation** — build a prospect list of Hungarian businesses by trade and city/county for B2B outreach\n- **Market research** — measure business density for a category across Hungarian regions\n- **Directory aggregation** — feed structured Hungarian business data into your own local-search product\n- **Competitor mapping** — see who else operates in a category and area, with contact info\n- **Franchise & site-selection analysis** — evaluate service-business coverage across counties and cities\n\n## Limitations\n\n- **Category/location matching is server-resolved, not URL-guessed.** aranyoldalak.hu's canonical pages live at slugged URLs (e.g. `/koenyvelo/nograd-megye/`) that sometimes carry numeric disambiguation suffixes not predictable from the category/location name alone. This actor always goes through aranyoldalak.hu's own free-text search (the same box a visitor uses), which resolves `category`/`location` to the correct canonical page server-side — the same reliable path a real user gets, with no slug-guessing. For best matching, use proper Hungarian diacritics in custom category/location text (e.g. `könyvelő`, not `konyvelo`) — the site's own search matching relies on them.\n- **No star ratings.** aranyoldalak.hu does not publish a review/rating system on business listings, so no `rating`/`reviewCount` fields are produced.\n- **Some categories may return listings from a broader area than requested.** aranyoldalak.hu occasionally cross-lists a business under a nearby county/city's category page (an upstream site behavior, not a client-side filtering gap in this actor).\n- **aranyoldalak.hu URLs are geo-restricted to Hungarian IPs.** `sourceUrl`, `images[]`, and `logoUrl` point at the source's own pages/CDN, which answer only Hungarian addresses. Open them from a Hungarian connection (or via an Apify proxy pinned to Hungary); the scraped data itself is unaffected.\n- **Search-result cards mask the street address.** aranyoldalak.hu shows only postal code, city, and coordinates on search-result cards; the full street address is on the business profile. Set `fetchDetails: true` (or use `mode: \"detail\"`) to get `street`.\n- **`sortBy: \"az\"/\"za\"/\"name\"` all re-sort client-side.** aranyoldalak.hu's own sort parameter doesn't change its result order, so all three non-default sort options instead reorder the specific batch this run fetched (useful together with `fetchDetails`), rather than the site's entire matching result set.\n\n## FAQ\n\n**What data source does this actor use?**\nIt reads the publicly available search and business-profile pages on aranyoldalak.hu, Hungary's leading business directory. No account or API key is needed.\n\n**Is this affiliated with aranyoldalak.hu?**\nNo. This is an independent, third-party actor that reads publicly accessible pages.\n\n**Why do some businesses have no phone, email, or website?**\naranyoldalak.hu only shows contact details a business itself provided when registering its listing. Fields with no data are simply omitted from the record rather than shown as empty or null.\n\n**Can I search a whole county instead of a single city?**\nYes — set `location` to any of the 19 Hungarian counties (megye), e.g. `\"Nógrád megye\"`, or type any county name into `customLocation`.\n\n**Can I search all of Hungary at once?**\nYes — set `location` to `\"\"` (the default \"No location filter\" option) for a nationwide search.\n\n**How accurate are the GPS coordinates?**\n`latitude`/`longitude` come directly from the business's own aranyoldalak.hu listing, which sources them from the address the business registered.\n\n**Why is `fetchDetails` off by default?**\nFetching each business's full profile page requires one extra request per result, which is slower. Turn it on when you need opening hours, a full description, related category tags, or the logo image.\n\n**Does this actor need a proxy or login?**\nNo — aranyoldalak.hu's search and profile pages are served without any login wall, so no account, cookie, or credential is needed. The actor automatically picks the proxy route each request needs, so you never have to configure one.\n\n**What does `categories[]` mean on a detail-mode record?**\naranyoldalak.hu lists each business under several related category+location tag pages (e.g. \"Könyvelés - Hatvan\", \"Adóbevallás - Hatvan\"). `categories[]` (only populated with `fetchDetails: true` or in `mode=detail`) reflects every tag the business's own profile page links to.\n\n**Why do only some businesses have `priceRange`, `paymentMethods`, `brands`, or `languagesSpoken`?**\nThese come from optional fields a business fills in on its own aranyoldalak.hu listing — mainly restaurants, cafés, hotels, and chain venues. They're simply omitted when a business hasn't set them.\n\n**Why is the `street` missing an NTAK number some listings show?**\naranyoldalak.hu appends the venue's NTAK (Hungarian tourism registration) ID to the street address on hospitality listings. It is a registration number, not part of the address, so the actor strips it and returns the clean street.\n\n**Why do only some businesses have `fax`, `additionalPhones`, or `additionalWebsites`?**\nMost businesses list a single phone number and website. These extra fields appear only when a business's own listing provides more than one contact number (e.g. Main/Alt/Mobile lines) or more than one link (e.g. a separate booking/reservation or menu page).\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "aranyoldalak-scraper-hungary-business-directory",
      "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",
      "buildTag": "latest",
      "dockerfile": "../Dockerfile",
      "readme": "# AranyOldalak Scraper - Hungary Business Directory\n\nScrape **aranyoldalak.hu** (Arany Oldalak / \"Golden Pages\") — Hungary's leading online business directory. Search any business category in any Hungarian city or county and get business names, addresses, phone numbers, emails, websites, opening hours, and GPS coordinates. Optionally follow through to each business's full profile page for a richer description, related category tags, fax number, extra phone numbers/websites, a price-range badge, payment methods, spoken languages, and a photo gallery. No login, no cookies, no API key required.\n\n## What this actor does\n\n- **Two modes:** `search` (category + city/county) and `detail` (direct business profile URLs)\n- **70+ curated business categories** to pick from, or type any custom category in Hungarian\n- **All 19 Hungarian counties (megye) + Budapest + 18 major cities** available as one-click location filters, in addition to free-text city/town search\n- **Sort by** relevance, A-Z, or Z-A\n- **Rich business profiles** — structured opening hours (per day of the week), business description, related category/location tags, precise GPS coordinates, logo, photo gallery, fax number, extra phone numbers/websites when a business lists more than one, price-range badge, accepted payment methods, brands, and spoken languages (when the business provides them)\n- **Full Hungarian character support** — á, é, í, ó, ö, ő, ú, ü, ű are handled correctly in both input and output\n- **Empty fields are omitted** — you only ever see fields that were actually found for a business\n\n## Output per business\n\n- `name` — business name\n- `category` — primary listed category (mode=detail, from the page's own breadcrumb)\n- `categories[]` — related category + location tags the business is listed under (mode=detail)\n- `description` — business \"about\" text (mode=detail) or short listing description (mode=search)\n- `street`, `postalCode`, `city`\n- `latitude`, `longitude` — GPS coordinates\n- `phone`, `email`, `website`\n- `additionalPhones[]` — extra phone numbers beyond the primary `phone`, when a business lists more than one (mode=detail)\n- `fax` — fax number, when listed separately from the phone number(s) (mode=detail)\n- `additionalWebsites[]` — extra website/booking/menu links beyond the primary `website`, when a business lists more than one (mode=detail)\n- `priceRange` — price-tier badge (e.g. `$$`), when the business has one set (mode=detail, mostly hospitality listings)\n- `paymentMethods[]` — accepted payment methods, when the business lists them (mode=detail, or the search card when shown there)\n- `languagesSpoken[]` — languages the business serves customers in, when listed (mode=detail, or the search card when shown there)\n- `brands[]` — brands the business carries or is affiliated with, when listed (mode=detail, or the search card when shown there)\n- `images[]` — photo gallery image URLs (mode=detail)\n- `logoUrl` — business logo image (mode=detail)\n- `openingHours[]` — structured opening hours (`{day, hours}` per day of the week; mode=detail or `fetchDetails: true`)\n- `searchCategory`, `searchLocation` — the search parameters used (mode=search)\n- `sourceUrl` — canonical aranyoldalak.hu profile URL for the business\n- `businessId` — aranyoldalak.hu's internal listing ID (mode=search)\n- `recordType: \"business\"`, `scrapedAt`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string (select) | `search` | `search` (category + city/county) or `detail` (fetch by URL) |\n| `category` | string (select) | `étterem` | Pick a common category, or `custom` to use `customCategory` (mode=search) |\n| `customCategory` | string | – | Any free-text Hungarian business category, overrides `category` (mode=search) |\n| `location` | string (select) | `Budapest` | Hungarian city or county to search in, or leave as \"No location filter\" for all of Hungary |\n| `customLocation` | string | – | Any free-text Hungarian city/town, overrides `location` (mode=search) |\n| `sortBy` | string (select) | `relevance` | `relevance` (site's own order) / `az` / `za` / `name` — the latter three all re-sort the fetched batch client-side |\n| `fetchDetails` | boolean | `false` | Also visit each business's profile page for opening hours, description, tags, and logo (slower) |\n| `businessUrls` | array | – | aranyoldalak.hu profile URLs to fetch directly (mode=detail) |\n| `maxItems` | int | `20` | Hard cap on returned records (1-1000) |\n\n### Example: search restaurants in Budapest\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"étterem\",\n  \"location\": \"Budapest\",\n  \"maxItems\": 20\n}\n```\n\n### Example: accountants in Nógrád county, with full profiles\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"könyvelő\",\n  \"location\": \"Nógrád megye\",\n  \"fetchDetails\": true,\n  \"maxItems\": 30\n}\n```\n\n### Example: car mechanics nationwide, A-Z\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"autószerelő\",\n  \"location\": \"\",\n  \"sortBy\": \"az\",\n  \"maxItems\": 100\n}\n```\n\n### Example: custom category and city not in the curated lists\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"custom\",\n  \"customCategory\": \"kulcsmásolás\",\n  \"location\": \"custom\",\n  \"customLocation\": \"Siófok\",\n  \"maxItems\": 20\n}\n```\n\n### Example: fetch specific business profiles\n\n```json\n{\n  \"mode\": \"detail\",\n  \"businessUrls\": [\n    { \"url\": \"https://aranyoldalak.hu/merleg-kft6.htm\" }\n  ]\n}\n```\n\n## Use cases\n\n- **Local lead generation** — build a prospect list of Hungarian businesses by trade and city/county for B2B outreach\n- **Market research** — measure business density for a category across Hungarian regions\n- **Directory aggregation** — feed structured Hungarian business data into your own local-search product\n- **Competitor mapping** — see who else operates in a category and area, with contact info\n- **Franchise & site-selection analysis** — evaluate service-business coverage across counties and cities\n\n## Limitations\n\n- **Category/location matching is server-resolved, not URL-guessed.** aranyoldalak.hu's canonical pages live at slugged URLs (e.g. `/koenyvelo/nograd-megye/`) that sometimes carry numeric disambiguation suffixes not predictable from the category/location name alone. This actor always goes through aranyoldalak.hu's own free-text search (the same box a visitor uses), which resolves `category`/`location` to the correct canonical page server-side — the same reliable path a real user gets, with no slug-guessing. For best matching, use proper Hungarian diacritics in custom category/location text (e.g. `könyvelő`, not `konyvelo`) — the site's own search matching relies on them.\n- **No star ratings.** aranyoldalak.hu does not publish a review/rating system on business listings, so no `rating`/`reviewCount` fields are produced.\n- **Some categories may return listings from a broader area than requested.** aranyoldalak.hu occasionally cross-lists a business under a nearby county/city's category page (an upstream site behavior, not a client-side filtering gap in this actor).\n- **aranyoldalak.hu URLs are geo-restricted to Hungarian IPs.** `sourceUrl`, `images[]`, and `logoUrl` point at the source's own pages/CDN, which answer only Hungarian addresses. Open them from a Hungarian connection (or via an Apify proxy pinned to Hungary); the scraped data itself is unaffected.\n- **Search-result cards mask the street address.** aranyoldalak.hu shows only postal code, city, and coordinates on search-result cards; the full street address is on the business profile. Set `fetchDetails: true` (or use `mode: \"detail\"`) to get `street`.\n- **`sortBy: \"az\"/\"za\"/\"name\"` all re-sort client-side.** aranyoldalak.hu's own sort parameter doesn't change its result order, so all three non-default sort options instead reorder the specific batch this run fetched (useful together with `fetchDetails`), rather than the site's entire matching result set.\n\n## FAQ\n\n**What data source does this actor use?**\nIt reads the publicly available search and business-profile pages on aranyoldalak.hu, Hungary's leading business directory. No account or API key is needed.\n\n**Is this affiliated with aranyoldalak.hu?**\nNo. This is an independent, third-party actor that reads publicly accessible pages.\n\n**Why do some businesses have no phone, email, or website?**\naranyoldalak.hu only shows contact details a business itself provided when registering its listing. Fields with no data are simply omitted from the record rather than shown as empty or null.\n\n**Can I search a whole county instead of a single city?**\nYes — set `location` to any of the 19 Hungarian counties (megye), e.g. `\"Nógrád megye\"`, or type any county name into `customLocation`.\n\n**Can I search all of Hungary at once?**\nYes — set `location` to `\"\"` (the default \"No location filter\" option) for a nationwide search.\n\n**How accurate are the GPS coordinates?**\n`latitude`/`longitude` come directly from the business's own aranyoldalak.hu listing, which sources them from the address the business registered.\n\n**Why is `fetchDetails` off by default?**\nFetching each business's full profile page requires one extra request per result, which is slower. Turn it on when you need opening hours, a full description, related category tags, or the logo image.\n\n**Does this actor need a proxy or login?**\nNo — aranyoldalak.hu's search and profile pages are served without any login wall, so no account, cookie, or credential is needed. The actor automatically picks the proxy route each request needs, so you never have to configure one.\n\n**What does `categories[]` mean on a detail-mode record?**\naranyoldalak.hu lists each business under several related category+location tag pages (e.g. \"Könyvelés - Hatvan\", \"Adóbevallás - Hatvan\"). `categories[]` (only populated with `fetchDetails: true` or in `mode=detail`) reflects every tag the business's own profile page links to.\n\n**Why do only some businesses have `priceRange`, `paymentMethods`, `brands`, or `languagesSpoken`?**\nThese come from optional fields a business fills in on its own aranyoldalak.hu listing — mainly restaurants, cafés, hotels, and chain venues. They're simply omitted when a business hasn't set them.\n\n**Why is the `street` missing an NTAK number some listings show?**\naranyoldalak.hu appends the venue's NTAK (Hungarian tourism registration) ID to the street address on hospitality listings. It is a registration number, not part of the address, so the actor strips it and returns the clean street.\n\n**Why do only some businesses have `fax`, `additionalPhones`, or `additionalWebsites`?**\nMost businesses list a single phone number and website. These extra fields appear only when a business's own listing provides more than one contact number (e.g. Main/Alt/Mobile lines) or more than one link (e.g. a separate booking/reservation or menu page).\n",
      "input": {
        "title": "AranyOldalak Scraper Input",
        "description": "Search aranyoldalak.hu (Arany Oldalak / Golden Pages), Hungary's leading business directory, by category and city/county, or fetch full business profiles by direct URL.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to fetch: search a business category in a city/county, or fetch full business profiles from direct aranyoldalak.hu URLs.",
            "editor": "select",
            "enum": [
              "search",
              "detail"
            ],
            "enumTitles": [
              "Search by category & city/county",
              "Fetch business profiles by URL"
            ],
            "default": "search",
            "prefill": "search"
          },
          "category": {
            "title": "Category",
            "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.",
            "editor": "select",
            "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"
            ],
            "enumTitles": [
              "Custom category (type below)",
              "Restaurant",
              "Pizzeria",
              "Confectionery / Pastry shop",
              "Cafe",
              "Fast food",
              "Hotel",
              "Guesthouse / B&B",
              "Travel agency",
              "Hairdresser",
              "Beauty salon",
              "Nail salon",
              "Tattoo studio",
              "Gym / Fitness center",
              "Massage",
              "Pharmacy",
              "Doctor's office",
              "Dentist",
              "Veterinarian",
              "Physiotherapist",
              "Lawyer",
              "Notary",
              "Accountant / Bookkeeper",
              "Tax advisor",
              "Insurance",
              "Bank",
              "Real estate agency",
              "Car mechanic / Auto repair",
              "Car dealership",
              "Car wash",
              "Tire service",
              "Car rental",
              "Taxi service",
              "Electrician",
              "Plumber",
              "Carpenter",
              "Painter",
              "Bricklayer / Mason",
              "Roof carpenter",
              "Roofer",
              "Window installer",
              "Gardener",
              "Flower shop",
              "Pet shop",
              "Furniture store",
              "Building materials",
              "Paint shop",
              "IT specialist",
              "Web design",
              "Translation agency",
              "Print shop",
              "Advertising agency",
              "Event planning",
              "Wedding planning",
              "Funeral services",
              "Gravestones",
              "Locksmith",
              "Air conditioning installation",
              "Alarm system installation",
              "Moving / Relocation services",
              "Cleaning services",
              "Vehicle service",
              "Auto parts",
              "Optician",
              "Jewelry store",
              "Shoe store",
              "Clothing store",
              "Grocery store",
              "Butcher",
              "Bakery",
              "Organic / health food store"
            ],
            "default": "étterem",
            "prefill": "é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.",
            "editor": "textfield"
          },
          "location": {
            "title": "City or county",
            "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.",
            "editor": "select",
            "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"
            ],
            "enumTitles": [
              "No location filter (search all of Hungary)",
              "Custom location (type below)",
              "Budapest",
              "Bács-Kiskun county",
              "Baranya county",
              "Békés county",
              "Borsod-Abaúj-Zemplén county",
              "Csongrád-Csanád county",
              "Fejér county",
              "Győr-Moson-Sopron county",
              "Hajdú-Bihar county",
              "Heves county",
              "Jász-Nagykun-Szolnok county",
              "Komárom-Esztergom county",
              "Nógrád county",
              "Pest county",
              "Somogy county",
              "Szabolcs-Szatmár-Bereg county",
              "Tolna county",
              "Vas county",
              "Veszprém county",
              "Zala county",
              "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"
            ],
            "default": "Budapest",
            "prefill": "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.",
            "editor": "textfield"
          },
          "sortBy": {
            "title": "Sort order",
            "type": "string",
            "description": "How to order search results (mode=search). aranyoldalak.hu ignores its own sort parameter, so 'az'/'za'/'name' all re-sort the specific batch this run fetches client-side (useful together with fetchDetails).",
            "editor": "select",
            "enum": [
              "relevance",
              "az",
              "za",
              "name"
            ],
            "enumTitles": [
              "Relevance (aranyoldalak.hu's own order)",
              "A-Z (client-side)",
              "Z-A (client-side)",
              "Name A-Z (client-side, applied to fetched batch)"
            ],
            "default": "relevance",
            "prefill": "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,
            "prefill": 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.",
            "editor": "requestListSources",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "description": "aranyoldalak.hu business profile (.htm) URL.",
                  "title": "URL"
                }
              }
            },
            "default": [],
            "prefill": []
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on the number of business records to return.",
            "minimum": 1,
            "maximum": 1000,
            "default": 20,
            "prefill": 20
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "AranyOldalak Scraper - Hungary Business Directory Output",
        "description": "Hungarian business listings from aranyoldalak.hu -- names, addresses, phone numbers, fax, emails, websites, opening hours, price range, payment methods, languages spoken, photo galleries, and coordinates.",
        "properties": {
          "businesses": {
            "type": "string",
            "title": "AranyOldalak businesses",
            "description": "Dataset containing all scraped aranyoldalak.hu business listings.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Businesses",
              "transformation": {
                "fields": [
                  "name",
                  "category",
                  "city",
                  "street",
                  "phone",
                  "email",
                  "website",
                  "sourceUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.2",
    "imageDigest": "dc833c00bdca87b589c60305b661f54c50cd9c9f4375068684ec3bab844cd0e4",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.004517777777777778
    }
  }
}