TopReality Real Estate Scraper

An Apify Actor for scraping real estate listings from TopReality.sk using Crawlee and Playwright.

The scraper allows you to filter results by language, listing type, real estate kind, price, area, villages, and more.
It saves results into the Apify dataset, which you can export in CSV, JSON, Excel, or any other supported format.

---

Features

• Supports multiple languages: sk, cz, pl, hu, en.
• Filter by transaction type: sell, buy, rent, looking-for-rent, exchange, auction.
• Filter by real estate kind:
  • Flats (studio, 1–5 rooms, etc.)
  • Houses (family house, villa, etc.)
  • Premises (offices, commercial, restaurants, warehouses, etc.)
  • Objects (tenement houses, office buildings, hotels, factories, etc.)
  • Plots (garden, arable land, industrial zone, etc.)
• Fulltext search support.
• Price and area filters (including price per m²).
• Option to scrape only private listings.
• Option to scrape only new buildings.
• Sort results by price, date, or ID.
• Filter by village(s).

---

Input

The actor uses an ./input_schema.json.
All fields are optional.

maxRequestsPerCrawl (integer)

Maximum number of requests the crawler should process in one run.
Default: 10.

language (string)

Language of the site to scrape. One of:

• sk (Slovak, default)
• cz (Czech)
• en (English)
• pl (Polish)
• hu (Hungarian)

onlyPrivateListings (boolean)

Whether to include only private listings (exclude agency listings).
Default: false.

type (string)

Transaction type. One of:

• all (default)
• sell
• buy
• rent
• looking-for-rent
• exchange
• auction

kind (object)

Specify the kinds of real estate to scrape. Each category is an array of strings.
If the array contains "all", all subtypes from that category are included.

• flats:
  "studio", "1 room flat", "2 room flat", "3 room flat", "4 room flat", "5 room flat and more", "other flat"
• houses:
  "garden cottage", "family house", "villa", "former agricultural homestead", "other object for housing and recreation"
• premises:
  "offices, administrative premises", "commercial premises", "restaurant premises", "sporting areas", "other commercial premises", "manufactural area", "warehousing area", "repair area", "other operating area"
• objects:
  "tenement house", "office building", "polyfunctional object", "commercial object", "restaurant", "hotel, boarding house", "balneal object", "sporting object", "other commercial object", "production object", "warehousing object", "operating area", "agricultural object", "repair facility", "filling station", "other operating object", "individual garage", "hard surfaces", "small power station", "sporting area and racecourse", "historical object", "other object", "apartment building"
• plots:
  "recreation plot", "plot for family houses", "plot for housing project", "commercial zone", "industrial zone", "garden", "orchard", "meadow, grassland", "arable land", "hop field, vinery", "woodland", "water area", "other agricultural plot"

Example:

"kind": {
  "flats": ["2 room flat", "3 room flat"],
  "houses": [],
  "premises": [],
  "objects": [],
  "plots": []
}

text (string)

Fulltext search query.
Example: "Bratislava"

priceFrom (integer)

Minimum price filter.
Default: 0 (no minimum).

priceTo (integer)

Maximum price filter.
Default: 0 (no maximum).

pricePerArea (boolean)

Whether to filter and sort by price per square meter.
Default: false.

areaFrom (integer)

Minimum area in m².
Default: 0.

areaTo (integer)

Maximum area in m².
Default: 0.

newBuildings (boolean)

Whether to include only new buildings.
Default: false.

sort (string)

Sort order of results. One of:

• price_asc
• price_desc
• price_m2_asc
• price_m2_desc
• date_desc
• date_asc
• id_desc
• id_asc

village (array of strings)

A list of village names to search for. The scraper will resolve them into location IDs automatically.
Example: ["Bratislava", "Kosice"]

---

Example INPUT.json

{
  "maxRequestsPerCrawl": 1,
  "language": "sk",
  "onlyPrivateListings": false,
  "type": "sell",
  "kind": {
    "flats": ["2 room flat", "3 room flat"],
    "houses": [],
    "premises": [],
    "objects": [],
    "plots": []
  },
  "text": "Bratislava",
  "priceFrom": 100000,
  "priceTo": 350000,
  "pricePerArea": false,
  "areaFrom": 40,
  "areaTo": 120,
  "newBuildings": false,
  "sort": "date_desc",
  "village": ["Bratislava"]
}