# AranyOldalak Scraper - Hungary Business Directory (`dataspryva/aranyoldalak-scraper-hungary-business-directory`) Actor

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.

- **URL**: https://apify.com/dataspryva/aranyoldalak-scraper-hungary-business-directory.md
- **Developed by:** [Dataspryva](https://apify.com/dataspryva) (community)
- **Categories:** Lead generation, Automation, Other
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## AranyOldalak Scraper - Hungary Business Directory

Scrape **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.

### What this actor does

- **Two modes:** `search` (category + city/county) and `detail` (direct business profile URLs)
- **70+ curated business categories** to pick from, or type any custom category in Hungarian
- **All 19 Hungarian counties (megye) + Budapest + 18 major cities** available as one-click location filters, in addition to free-text city/town search
- **Sort by** relevance, A-Z, or Z-A
- **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)
- **Full Hungarian character support** — á, é, í, ó, ö, ő, ú, ü, ű are handled correctly in both input and output
- **Empty fields are omitted** — you only ever see fields that were actually found for a business

### Output per business

- `name` — business name
- `category` — primary listed category (mode=detail, from the page's own breadcrumb)
- `categories[]` — related category + location tags the business is listed under (mode=detail)
- `description` — business "about" text (mode=detail) or short listing description (mode=search)
- `street`, `postalCode`, `city`
- `latitude`, `longitude` — GPS coordinates
- `phone`, `email`, `website`
- `additionalPhones[]` — extra phone numbers beyond the primary `phone`, when a business lists more than one (mode=detail)
- `fax` — fax number, when listed separately from the phone number(s) (mode=detail)
- `additionalWebsites[]` — extra website/booking/menu links beyond the primary `website`, when a business lists more than one (mode=detail)
- `priceRange` — price-tier badge (e.g. `$$`), when the business has one set (mode=detail, mostly hospitality listings)
- `paymentMethods[]` — accepted payment methods, when the business lists them (mode=detail, or the search card when shown there)
- `languagesSpoken[]` — languages the business serves customers in, when listed (mode=detail, or the search card when shown there)
- `brands[]` — brands the business carries or is affiliated with, when listed (mode=detail, or the search card when shown there)
- `images[]` — photo gallery image URLs (mode=detail)
- `logoUrl` — business logo image (mode=detail)
- `openingHours[]` — structured opening hours (`{day, hours}` per day of the week; mode=detail or `fetchDetails: true`)
- `searchCategory`, `searchLocation` — the search parameters used (mode=search)
- `sourceUrl` — canonical aranyoldalak.hu profile URL for the business
- `businessId` — aranyoldalak.hu's internal listing ID (mode=search)
- `recordType: "business"`, `scrapedAt`

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string (select) | `search` | `search` (category + city/county) or `detail` (fetch by URL) |
| `category` | string (select) | `étterem` | Pick a common category, or `custom` to use `customCategory` (mode=search) |
| `customCategory` | string | – | Any free-text Hungarian business category, overrides `category` (mode=search) |
| `location` | string (select) | `Budapest` | Hungarian city or county to search in, or leave as "No location filter" for all of Hungary |
| `customLocation` | string | – | Any free-text Hungarian city/town, overrides `location` (mode=search) |
| `sortBy` | string (select) | `relevance` | `relevance` (site's own order) / `az` / `za` / `name` — the latter three all re-sort the fetched batch client-side |
| `fetchDetails` | boolean | `false` | Also visit each business's profile page for opening hours, description, tags, and logo (slower) |
| `businessUrls` | array | – | aranyoldalak.hu profile URLs to fetch directly (mode=detail) |
| `maxItems` | int | `20` | Hard cap on returned records (1-1000) |

#### Example: search restaurants in Budapest

```json
{
  "mode": "search",
  "category": "étterem",
  "location": "Budapest",
  "maxItems": 20
}
```

#### Example: accountants in Nógrád county, with full profiles

```json
{
  "mode": "search",
  "category": "könyvelő",
  "location": "Nógrád megye",
  "fetchDetails": true,
  "maxItems": 30
}
```

#### Example: car mechanics nationwide, A-Z

```json
{
  "mode": "search",
  "category": "autószerelő",
  "location": "",
  "sortBy": "az",
  "maxItems": 100
}
```

#### Example: custom category and city not in the curated lists

```json
{
  "mode": "search",
  "category": "custom",
  "customCategory": "kulcsmásolás",
  "location": "custom",
  "customLocation": "Siófok",
  "maxItems": 20
}
```

#### Example: fetch specific business profiles

```json
{
  "mode": "detail",
  "businessUrls": [
    { "url": "https://aranyoldalak.hu/merleg-kft6.htm" }
  ]
}
```

### Use cases

- **Local lead generation** — build a prospect list of Hungarian businesses by trade and city/county for B2B outreach
- **Market research** — measure business density for a category across Hungarian regions
- **Directory aggregation** — feed structured Hungarian business data into your own local-search product
- **Competitor mapping** — see who else operates in a category and area, with contact info
- **Franchise & site-selection analysis** — evaluate service-business coverage across counties and cities

### Limitations

- **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.
- **No star ratings.** aranyoldalak.hu does not publish a review/rating system on business listings, so no `rating`/`reviewCount` fields are produced.
- **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).
- **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.
- **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`.
- **`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.

### FAQ

**What data source does this actor use?**
It reads the publicly available search and business-profile pages on aranyoldalak.hu, Hungary's leading business directory. No account or API key is needed.

**Is this affiliated with aranyoldalak.hu?**
No. This is an independent, third-party actor that reads publicly accessible pages.

**Why do some businesses have no phone, email, or website?**
aranyoldalak.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.

**Can I search a whole county instead of a single city?**
Yes — set `location` to any of the 19 Hungarian counties (megye), e.g. `"Nógrád megye"`, or type any county name into `customLocation`.

**Can I search all of Hungary at once?**
Yes — set `location` to `""` (the default "No location filter" option) for a nationwide search.

**How accurate are the GPS coordinates?**
`latitude`/`longitude` come directly from the business's own aranyoldalak.hu listing, which sources them from the address the business registered.

**Why is `fetchDetails` off by default?**
Fetching 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.

**Does this actor need a proxy or login?**
No — 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.

**What does `categories[]` mean on a detail-mode record?**
aranyoldalak.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.

**Why do only some businesses have `priceRange`, `paymentMethods`, `brands`, or `languagesSpoken`?**
These 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.

**Why is the `street` missing an NTAK number some listings show?**
aranyoldalak.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.

**Why do only some businesses have `fax`, `additionalPhones`, or `additionalWebsites`?**
Most 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).

# Actor input Schema

## `mode` (type: `string`):

What to fetch: search a business category in a city/county, or fetch full business profiles from direct aranyoldalak.hu URLs.

## `category` (type: `string`):

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.

## `customCategory` (type: `string`):

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` (type: `string`):

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.

## `customLocation` (type: `string`):

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` (type: `string`):

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).

## `fetchDetails` (type: `boolean`):

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).

## `businessUrls` (type: `array`):

Direct aranyoldalak.hu business profile URLs to fetch, e.g. https://aranyoldalak.hu/merleg-kft6.htm. Use the 'sourceUrl' field from search results.

## `maxItems` (type: `integer`):

Hard cap on the number of business records to return.

## Actor input object example

```json
{
  "mode": "search",
  "category": "étterem",
  "location": "Budapest",
  "sortBy": "relevance",
  "fetchDetails": false,
  "businessUrls": [],
  "maxItems": 20
}
```

# Actor output Schema

## `businesses` (type: `string`):

Dataset containing all scraped aranyoldalak.hu business listings.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "category": "étterem",
    "location": "Budapest",
    "sortBy": "relevance",
    "fetchDetails": false,
    "businessUrls": [],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("dataspryva/aranyoldalak-scraper-hungary-business-directory").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "category": "étterem",
    "location": "Budapest",
    "sortBy": "relevance",
    "fetchDetails": False,
    "businessUrls": [],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("dataspryva/aranyoldalak-scraper-hungary-business-directory").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "category": "étterem",
  "location": "Budapest",
  "sortBy": "relevance",
  "fetchDetails": false,
  "businessUrls": [],
  "maxItems": 20
}' |
apify call dataspryva/aranyoldalak-scraper-hungary-business-directory --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dataspryva/aranyoldalak-scraper-hungary-business-directory"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/HHgNvADWxphGzbm8Y/builds/B6YBOhfbErzFc99u4/openapi.json
