Aranyoldalak Scraper — Hungarian business leads from aranyoldalak.hu

This Aranyoldalak scraper reads Aranyoldalak (aranyoldalak.hu, Hungary's Yellow Pages / Arany Oldalak cégkereső) by business type or keyword and town: every business as one clean row with name, description, postal code, town, street, coordinates, phone (also in E.164), email, website and tags, plus whether its card is a paid Toprank or highlighted placement. One optional step reads each company's own page:

• Company page (includeDetails): every phone number and website, every email, the service area (Működési terület), the full introduction (Bemutatkozás), the services it lists, opening hours per day and its videos.

Search autószerviz in Budapest, fogorvos in Debrecen, ügyvéd in Szeged or könyvelő in all of Hungary — or paste results lists and company links straight from the site. You pay per business delivered; searches without results and links that give nothing are free rows that say why.

Who the Aranyoldalak scraper is for

• B2B sales and lead generation in Hungary: companies by category and town with phone, email and website, the address split into postal code, town and street for a CRM or a mail merge.
• Local SEO and marketing agencies prospecting Hungarian small businesses: who has a website of its own and who only has the directory's business card (businessCardUrl), and who pays Aranyoldalak for a highlighted listing.
• Market research: count and map the dentists, garages or lawyers of a town (the site's own count is in every search row; coordinates come with almost every row).

How the Aranyoldalak data is read

1. Searches go through the site's own search form (/search/?keyword=autószerviz&area=Budapest), which opens the results list it has for them (/autok-es-koezlekedes/autoszerviz/budapest/), 20 businesses a page, and follow the page's own next link until your maximum. Without a town the site searches all of Hungary.
2. Paid cards come first: Aranyoldalak lists its Toprank and highlighted ("Kiemelt") advertisers on top, some of them from nearby towns that serve the town you searched; listingType says which a row is and city says where the business is. A Toprank card shown again further down is delivered once.
3. One advertiser can have several profiles (one per product or service, each with its own phone and text): each profile is its own row with its own id, as the site lists them.
4. Company pages (optional) add the details below. Links: a results link is walked like a search from that page; a company link is read on its own page.

The Actor reads only pages the site's robots.txt leaves open to any crawler, one request every 3 seconds as robots.txt asks, without a login. Aranyoldalak answers only visitors in Hungary, so the Actor reads it through Hungarian residential IPs (included in the price).

Input example

{
    "searchTerms": ["autószerviz", "fogorvos"],
    "locations": ["Budapest", "Debrecen"],
    "maxResultsPerSearch": 100,
    "includeDetails": true
}

Links: "startUrls": ["https://aranyoldalak.hu/autok-es-koezlekedes/autoszervizek/budapest/", "https://aranyoldalak.hu/reflex-kft8.htm"].

Output example

{
    "rowType": "business",
    "id": "9179518",
    "url": "https://aranyoldalak.hu/reflex-kft8.htm",
    "name": "Reflex Kft.",
    "description": "Tehergépkocsik és pótkocsik javítása, személygépkocsik javítása, műszaki vizsgára történő felkészítés, műszaki vizsgáztatás.",
    "categories": ["Autójavítás", "Teherautó javítás", "Műszaki vizsga esztergom", "Mezőgazdasági gépjármű szerviz esztergom", "Daf szerviz"],
    "address": "2510 Dorog, Esztergomi út 27.",
    "postalCode": "2510",
    "city": "Dorog",
    "street": "Esztergomi út 27.",
    "latitude": 47.728398741834,
    "longitude": 18.725378012576,
    "phone": "+36 (33) 521210",
    "phoneInternational": "+3633521210",
    "email": "km@reflexkft.hu",
    "website": "http://www.reflexkft.hu",
    "businessCardUrl": "https://reflex-kft.uzleti.hu",
    "listingType": "highlighted",
    "searchTerm": "autószerviz",
    "location": "Budapest",
    "searchUrl": "https://aranyoldalak.hu/search/?keyword=aut%C3%B3szerviz&area=Budapest",
    "position": 9,
    "details": {
        "mainCategories": ["Autójavítás"],
        "introduction": "Tehergépkocsik és pótkocsik javítása, személygépkocsik javítása, műszaki vizsgára történő felkészítés, műszaki vizsgáztatás. Vállaljuk minden típusú s…",
        "phones": [
            { "number": "+36 (33) 521210", "international": "+3633521210" },
            { "number": "+36 (30) 3822399", "international": "+36303822399" }
        ],
        "emails": ["km@reflexkft.hu"],
        "websites": ["http://www.reflexkft.hu"],
        "businessCardUrl": "https://reflex-kft.uzleti.hu",
        "serviceArea": ["Tatabánya", "Budapest", "Esztergom"],
        "services": ["Autószerviz esztergom", "Renault haszongépjármű szerviz", "Autóalkatrész esztergom", "Ford transit szerviz"],
        "serviceTowns": ["Esztergom", "Tatabánya", "Dorog", "Budapest"],
        "openingHours": [
            { "day": "Monday", "opens": "06:00", "closes": "15:00" },
            { "day": "Tuesday", "opens": "06:00", "closes": "15:00" }
        ],
        "hoursNote": null,
        "videos": ["https://www.youtube.com/embed/Yjt9hB-mQ9E?si=DJZU0JiHu2N8DF91"]
    },
    "scrapedAt": "2026-11-01T12:00:00.000Z"
}

Aranyoldalak fields

field	what it is
id	the site's profile id (data-stat-name); one advertiser can have several
url	the company page on aranyoldalak.hu
name, description	as the card shows them (the card shortens long descriptions with "...")
categories	the category and keyword tags on the card, as the advertiser chose them
address, postalCode, city, street	the address in Hungarian order, also split
latitude, longitude	where the site pins the business
phone, phoneInternational	the card's phone as written, and in E.164 (+3633521210)
email	the card's email; with details the page's first one when the card has none
website	the company's own website or social page; never an uzleti.hu business card
businessCardUrl	the company's *.uzleti.hu one-page business card that Aranyoldalak hosts, when it has one
listingType	toprank, highlighted (paid placements) or standard; null for a company link
searchTerm, location, searchUrl, position	which search found it and where it was listed
details	the company page (with includeDetails or a company link), else null

Free rows say what happened to each search and link:

• rowType: search — one per term and town, or results link: status ok, no_results (the site has no company for it, or does not know the town), not_a_list, disallowed, blocked, not_searched (spending limit) or unreadable, with the site's own count (totalListed), the list it answered with and how it named the search.
• rowType: link — a company link that gave no business: invalid, not_found (the page was removed), already_delivered (a search of the run delivered it), blocked, not_read or unreadable, with the reason.

Pricing

Pay per event, no subscription:

event	price	when
business	US$0.001	a business from a results page
business-with-details	US$0.002	a business with its company page read (instead of business), and every company link

1,000 Hungarian businesses cost US$1, or US$2 with their company pages. Search rows, link rows, Toprank cards repeated on a page and businesses already delivered by an earlier search of the run are free. The run stops at your spending limit before reading any page it could not pay for.

Limits

• Speed: robots.txt asks for 3 seconds between requests, and the Actor keeps to it: about 400 businesses a minute from results lists (20 a page), about 20 a minute with company pages.
• Paid placements from nearby towns come first in every list, as on the site; filter on city if you need only the town itself.
• The tags (categories, details.services) are the advertiser's own keywords and can name other towns or brands.
• Town index pages (/telepulesek/) and .php pages are closed to automated readers by robots.txt and are free invalid rows; the Actor reads the site's default order.
• If the site refuses the connection or shows a bot check, the run stops asking, ends successfully and says so in free blocked rows; nothing is charged for them.

Is the Aranyoldalak scraper legal?

The Actor reads public business listings that Aranyoldalak publishes for anyone, without a login, only on paths its robots.txt allows, at the pace robots.txt asks, and never solves or bypasses a challenge. The data is about businesses, but a listing can name a person (sole traders, egyéni vállalkozók): if you process it in a way the GDPR covers, you are responsible for having a lawful basis, and Hungarian and EU rules on unsolicited marketing apply to how you contact them. Check the site's terms for your use case.

This Actor is unofficial and is not affiliated with, endorsed or sponsored by MTT Media Kft. or Aranyoldalak. Aranyoldalak is a trademark of its owner, named here only to say which site the Actor reads.

Feedback

Something missing or a page the Actor cannot read? Open an issue on the Actor's Issues tab; answers come within days.