# Ingatlan.com Property Scraper (dev probe) (`sian.agency/ingatlan-property-scraper`) Actor

Scrape ingatlan.com, Hungary's largest property portal: asking price or rent, price per m², floor area, rooms, photos and owner or agency for every listing, plus full adverts on demand. Sale and rent, all of Hungary.

- **URL**: https://apify.com/sian.agency/ingatlan-property-scraper.md
- **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community)
- **Categories:** Real estate, Lead generation, Business
- **Security:** Limited permissions
- **Stats:** 7 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.76 / 1,000 property searches

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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

## Ingatlan.com Scraper - Hungary Property Listings & Prices 🏠

[![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Otodom Property Scraper](https://img.shields.io/badge/Store-Otodom%20Property%20Scraper-1AE392)](https://apify.com/sian.agency/otodom-property-scraper?fpr=sian) [![Willhaben Property Scraper](https://img.shields.io/badge/Store-Willhaben%20Property%20Scraper-1AE392)](https://apify.com/sian.agency/willhaben-property-scraper?fpr=sian) [![Imobiliare.ro Scraper](https://img.shields.io/badge/Store-Imobiliare.ro%20Scraper-1AE392)](https://apify.com/sian.agency/imobiliare-property-scraper?fpr=sian)

#### 🎉 Every listing on Hungary's largest property portal, as clean rows: price, price per m², area, rooms, photos and seller

##### For investors, agencies, valuers and proptech teams who need Hungarian property data without copying it by hand

### 🔎 What is the Ingatlan.com Scraper — and when should you use it?

The **Ingatlan.com Scraper** turns any ingatlan.com search, from Hungary's largest property portal into clean, structured rows you can filter, export and feed straight into a spreadsheet, database or AI agent. No account, no portal API key, no browser automation to maintain.

**Use it when you need:** asking prices or monthly rents in forints, price per square metre, floor area, lot size, rooms, balcony size, photos, and whether a private owner or an agency posted each listing, anywhere in Hungary. Full details add the advert text, every photo, condition, year built, floor, heating, energy rating, parking, the street's map position and the agency.

**Use something else when:** the property is outside Hungary. Use [Imobiliare.ro Scraper](https://apify.com/sian.agency/imobiliare-property-scraper?fpr=sian) for Romania. Use [Willhaben Property Scraper](https://apify.com/sian.agency/willhaben-property-scraper?fpr=sian) for Austria. Use [Otodom Property Scraper](https://apify.com/sian.agency/otodom-property-scraper?fpr=sian) for Poland. This actor reads live ingatlan.com adverts only: no sold prices, no price history, and no other Hungarian portal such as Jófogás or Zenga. Map positions are the centre point of the street or neighbourhood the advert is filed under, not the building.

### 🤖 Use with AI agents

Already connected to the [Apify MCP server](https://mcp.apify.com)? Just ask for this Actor by name: sian.agency/ingatlan-property-scraper

**Your agent can pay for its own runs.** This Actor is eligible for [agentic payments](https://docs.apify.com/platform/actors/publishing/monetize), so an agent can discover it, run it and settle the bill over [x402](https://www.x402.org/) (USDC on Base) or [Skyfire](https://www.skyfire.xyz/) — without an Apify account or API token of its own. Billing is the same either way: per successful row, never for errors.

Otherwise copy this prompt into Claude, ChatGPT, Cursor or any MCP-enabled assistant:

```text
I want to research the Hungarian property market, for sale or to rent, from the portal most Hungarians use using the Apify Actor `sian.agency/ingatlan-property-scraper`.

Use it when I need: asking prices or monthly rents in forints, price per square metre, floor area, lot size, rooms, balcony size, photos, and whether a private owner or an agency posted each listing, anywhere in Hungary. Full details add the advert text, every photo, condition, year built, floor, heating, energy rating, parking, the street's map position and the agency.

Don't use it when: the property is outside Hungary — use imobiliare-property-scraper or willhaben-property-scraper or otodom-property-scraper instead.

How to call it: leave `operation` on `search`, give `locations` one or more of the offered places (`budapest`, a district such as `xiii-ker`, a county such as `pest-megye`, `balaton`, a city such as `debrecen`, or `magyarorszag` for the whole country), then set `dealType` to `elado` (for sale) or `kiado` (for rent) and `propertyType` to one of `lakas`, `haz`, `telek`, `garazs`, `nyaralo`, `iroda`, `uzlethelyiseg`, `vendeglato`, `ipari`, `mezogazdasagi` or `intezmeny`. Narrow with `minPrice`, `maxPrice` (forints), `minArea`, `maxArea`, `minRooms`, `maxRooms` and `newBuildOnly`; ingatlan.com applies them itself. `includeDetails` opens each advert as well, for an extra charge per listing. For a town not in the list, paste its ingatlan.com page into `searchUrls`. To expand known adverts, set `operation` to `detail` and list links or IDs in `listingUrls`.

Start with this input:
{
  "operation": "search",
  "locations": [
    "budapest"
  ],
  "dealType": "elado",
  "propertyType": "lakas",
  "minRooms": 2,
  "maxPrice": 80000000,
  "maxResults": 100
}

Ask me which city, district or county they want, whether they are buying or renting, and which kind of property, then run the Actor and summarise the results as a table.
```

**Things you can ask your agent for:**

- *Pull two-room apartments for sale under 80 million forints in Budapest's XIII. district and rank them by price per square metre.*
- *Compare asking rents for one- and two-room flats in Debrecen and Szeged and tell me which city is cheaper per square metre.*
- *List houses for sale around Lake Balaton with their lot size, then open the full advert for the ten cheapest per square metre.*
- *Find new-build apartments for sale in Budapest and show which developers' agencies list the most of them.*

Machine-readable API, MCP config and OpenAPI definition for this Actor are published at [apify.com/sian.agency/ingatlan-property-scraper.md](https://apify.com/sian.agency/ingatlan-property-scraper.md).

### 📋 Overview

**Ingatlan.com Scraper** turns ingatlan.com searches into property data you can sort, chart and load into a spreadsheet or database. Pick a location, sale or rent, and a property type, and every matching listing comes back with its asking price, price per square metre, floor area, rooms and photos.

**What you get:**

- ✅ **Deep searches**: the actor keeps paging, so a Budapest apartment search can reach all of its 35,000+ listings.
- 🎯 **ingatlan.com's own filters**: price, floor area, rooms and new builds are applied by the site before anything is read, so a narrow search stays fast and cheap.
- 👤 **Owner or agency on every row**: each listing says whether a private owner or an estate agency posted it, at no extra cost.
- 📄 **Full adverts when you need them**: one switch adds the description, every photo, condition, year built, floor, heating, energy rating, parking and the agency.
- 💰 **Pay only for listings you get**: no charge for searches that match nothing, listings outside your bounds, or pages that would not load.
- 🗺️ **84 ready-made places**: Budapest and its 23 districts, every county, Lake Balaton and 32 major towns, plus any other ingatlan.com page you paste.

***

### ✨ Features

- 🏙️ **Location picker**: all of Hungary, Budapest, the Buda and Pest sides, the agglomeration, 23 districts, 19 counties, Lake Balaton and its shores, and 32 towns.
- 🤝 **Sale and rent**: rent rows carry the monthly rent and say so in `pricePeriod`.
- 🏠 **11 property types**: apartments, houses, plots, garages, holiday homes, offices, shops, hospitality units, industrial, agricultural and institutional property.
- 🎚️ **Server-side filters**: minimum and maximum price, floor area and rooms, and new builds only.
- 📐 **Typed numbers**: price, price per m², floor area, lot size, balcony, rooms and half-rooms come back as numbers, ready to calculate with.
- 🖼️ **Photos**: a thumbnail on every row, and the full photo set with full details.
- 📄 **Property Detail mode**: paste advert links or IDs to expand specific listings.
- 📊 **Run report**: every run saves a readable summary with the listings, any inputs that need a fix, and what you paid.

***

### 🎬 Quick Start

Choose a location, sale or rent, and a property type, then press Start. The first 20 listings arrive within a minute; later pages follow as the search walks forward. Export as JSON, CSV or Excel, or pull the rows over the API.

```bash
curl -X POST "https://api.apify.com/v2/acts/sian.agency~ingatlan-property-scraper/runs?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"locations": ["budapest"], "dealType": "elado", "propertyType": "lakas", "maxResults": 100}'
```

***

### 🚀 Getting Started (3 Simple Steps)

#### Step 1: Pick where and what

Choose one or more locations, sale or rent, and a property type.

#### Step 2: Narrow it (optional)

Set a price band, floor area, room count or new builds only, and decide how many listings you want.

#### Step 3: Run and export

Press Start, then download the dataset or open the run report.

**That's it. In a few minutes you'll have:**

- Every matching listing with price, price per m², area and rooms
- Whether each one comes from a private owner or an agency
- A thumbnail and an advert link for every listing

***

### 📥 Input Configuration

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `operation` | string | No | `search` (default) for listings by location, `detail` for full adverts by link or ID |
| `locations` | array | No | Places from the list, e.g. `budapest`, `xiii-ker`, `pest-megye`, `debrecen`, `magyarorszag` (all of Hungary) |
| `dealType` | string | No | `elado` for sale (default) or `kiado` for rent |
| `propertyType` | string | No | `lakas` (default), `haz`, `telek`, `garazs`, `nyaralo`, `iroda`, `uzlethelyiseg`, `vendeglato`, `ipari`, `mezogazdasagi`, `intezmeny` |
| `maxResults` | integer | No | Listings to return across the whole run (default 100) |
| `minPrice` / `maxPrice` | integer | No | Price band in forints (monthly rent for rentals) |
| `minArea` / `maxArea` | integer | No | Floor area band in m² |
| `minRooms` / `maxRooms` | integer | No | Room count band |
| `newBuildOnly` | boolean | No | Only new construction |
| `includeDetails` | boolean | No | Open each advert for the full details (extra charge per listing) |
| `searchUrls` | array | No | ingatlan.com location pages for places not in the list |
| `listingUrls` | array | No | Advert links or IDs for the `detail` operation |

**Example: two-room-plus apartments under 80 million forints in Budapest**

```json
{
  "operation": "search",
  "locations": ["budapest"],
  "dealType": "elado",
  "propertyType": "lakas",
  "minRooms": 2,
  "maxPrice": 80000000,
  "maxResults": 200
}
```

**Example: full adverts for listings you already have**

```json
{
  "operation": "detail",
  "listingUrls": ["https://ingatlan.com/35590543", "35490844"]
}
```

***

### 📤 Output

Results are saved to the Apify dataset with **45+ fields**. Search rows carry the card fields; full details add the rest.

| Field | Type | Description |
|-------|------|-------------|
| `listingId` | number | ingatlan.com advert ID |
| `thumbnailUrl` | string | Main photo |
| `address` | string | Street or area as published |
| `price` | number | Asking price, or monthly rent, in HUF |
| `pricePeriod` | string | `month` on rentals |
| `pricePerSqm` | number | Asking price per m² (sale listings) |
| `floorArea` / `lotArea` | number | Floor area and lot size in m² |
| `rooms` / `halfRooms` | number | Whole rooms and half-rooms |
| `balconyArea` | number | Balcony size in m² |
| `sellerType` | string | `private` or `agency` |
| `labels` | array | Highlights such as "Dunai panoráma" (Danube view) |
| `condition`, `yearBuilt`, `floor`, `heating`, `energyCertificate`, `parking` | mixed | From the full advert |
| `descriptionText`, `photoUrls` | string, array | Full advert text and every photo |
| `agencyName`, `agentName`, `agencyUrl` | string | Who is selling or letting |
| `latitude`, `longitude`, `postalCode`, `district` | mixed | Location of the street or neighbourhood |
| `attributes` | object | Every parameter on the advert, keyed by its Hungarian label |

**Example (search row with full details):**

```json
{
  "listingId": 35590543,
  "url": "https://ingatlan.com/xiii-ker/elado+lakas/tegla-lakas/35590543",
  "thumbnailUrl": "https://ip.ingatlancdn.com/resize/office/800x800/...",
  "propertyTitle": "Eladó tégla lakás",
  "address": "Budapest XIII. kerület, Danubius utca",
  "price": 148800000,
  "currency": "HUF",
  "priceText": "148,80 millió Ft",
  "pricePerSqm": 1825766,
  "floorArea": 76,
  "rooms": 3,
  "halfRooms": 0,
  "balconyArea": 11,
  "dealType": "sale",
  "propertyType": "apartment",
  "city": "Budapest",
  "district": "Budapest XIII. kerület",
  "postalCode": "1138",
  "latitude": 47.547712,
  "longitude": 19.065914,
  "yearBuilt": 2012,
  "condition": "újszerű",
  "floor": "9",
  "heating": "házközponti egyedi méréssel",
  "parking": "teremgarázs hely - megvásárolható",
  "labels": ["Dunai panoráma"],
  "photoCount": 26,
  "sellerType": "agency",
  "agencyName": "Otthon 13 Kft.",
  "agentName": "Sebestyén Roland",
  "agencyUrl": "https://iroda.ingatlan.com/w-end",
  "status": "success"
}
```

Values the site writes in words, such as condition and heating, stay in Hungarian exactly as published.

***

### 💼 Use Cases & Examples

#### 1. Budapest price-per-square-metre tracking

**Investors and analysts follow asking prices district by district.**

**Input:** one or more Budapest districts, `elado`, `lakas`
**Output:** price, price per m², area and rooms for every apartment for sale
**Use:** chart the median price per m² by district each week

#### 2. Rental yield across Hungarian cities

**Buy-to-let investors compare what a flat costs with what it rents for.**

**Input:** the same city twice, once `elado` and once `kiado`, with the same size band
**Output:** asking prices on one side, monthly rents on the other
**Use:** divide median rent by median price to rank cities by gross yield

#### 3. Owner-listed property sourcing

**Buyers and agencies looking for listings without an agent behind them.**

**Input:** any search
**Output:** `sellerType` on every row
**Use:** keep the `private` rows for for-sale-by-owner leads, or count `agency` rows to see who holds stock

#### 4. Valuation comparables

**Surveyors and bank valuers need like-for-like properties with their condition.**

**Input:** a district with an area and room band, `includeDetails` on
**Output:** condition, year built, floor, heating and energy rating next to each price
**Use:** build the comparables table for a valuation report

#### 5. New-build pipeline monitoring

**Developers and market researchers watch what is being built and at what price.**

**Input:** `newBuildOnly` on, Budapest or the whole country
**Output:** developer listings with price per m² and location
**Use:** track new supply and pricing by area month by month

#### 6. Relocation and lettings shortlists

**Relocation agencies and HR teams find rentals for incoming staff.**

**Input:** `kiado`, a rent ceiling and a minimum room count in several locations
**Output:** monthly rent, size, rooms, photos and advert links
**Use:** send a ready shortlist instead of browsing for hours

***

### 🔗 Integration Examples

#### JavaScript/Node.js

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('sian.agency/ingatlan-property-scraper').call({
  locations: ['budapest'],
  dealType: 'elado',
  propertyType: 'lakas',
  maxResults: 100,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);
```

#### Python

```python
from apify_client import ApifyClient
client = ApifyClient('YOUR_API_TOKEN')

run = client.actor('sian.agency/ingatlan-property-scraper').call(run_input={
    'locations': ['debrecen'],
    'dealType': 'kiado',
    'propertyType': 'lakas',
    'maxResults': 100,
})

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item['price'], item['floorArea'], item['address'])
```

#### cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/sian.agency~ingatlan-property-scraper/run-sync-get-dataset-items?token=YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"locations": ["pest-megye"], "dealType": "elado", "propertyType": "haz", "maxResults": 50}'
```

#### Automation Workflows (N8N / Zapier / Make)

1. **Trigger**: a schedule, for example every Monday morning
2. **HTTP Request**: start the actor with your saved input
3. **Process**: read the dataset rows as JSON
4. **Action**: append new listings to Google Sheets, a CRM or a database, or send an alert

***

### 📊 Performance & Pricing

#### FREE Tier (Try It Now)

- **25 listings** per run, with every field
- No credit card required
- Enough to test a search before you schedule it

#### PAID Tier (Production Ready)

- **Unlimited** listings per run
- Pay per result: **$2.00 per 1,000 listings**, plus a small start fee per run
- Full advert details are optional, at **$40 per 1,000 adverts**, because each one is a separate page

The first page of each search arrives within seconds. Later pages take from a few seconds to about a minute each, because ingatlan.com is careful about automated traffic. Full adverts are slower: in our test runs they averaged about 35 seconds per listing, so 100 listings with full details take close to an hour. Pages that fail are retried and never billed.

🔗 [View current pricing](https://apify.com/sian.agency/ingatlan-property-scraper?fpr=sian)

***

### ❓ Frequently Asked Questions

**Q: Do I need a proxy, cookies or an ingatlan.com account?**
A: No. There is no proxy setting and no login. The actor handles access to the site itself, and pages that fail to load are retried at no charge.

**Q: How many listings can one search return?**
A: As many as ingatlan.com lists for it. Budapest apartments for sale alone run past 35,000. `maxResults` stops the run at your budget, and the filters let you split a big market into smaller searches.

**Q: Are prices in forints?**
A: Yes, as numbers in HUF. Sale rows hold the asking price; rent rows hold the monthly rent and say so in `pricePeriod`. The price as printed on the site is kept in `priceText`.

**Q: What does "Add full details" add?**
A: It opens each advert for the full description, every photo, condition, year built, floor, heating, energy rating, parking, the map position and the agency. It is billed as one Property Detail per listing on top of the listing row, so leave it off when the search row is enough.

**Q: Can I scrape a town that is not in the location list?**
A: Yes. Open the town or neighbourhood on ingatlan.com, copy the page address (for example https://ingatlan.com/szentendre/elado+haz) and paste it into Search addresses.

**Q: How accurate is the map position?**
A: ingatlan.com publishes the position of the street or neighbourhood an advert is filed under, not the building. Treat latitude and longitude as the area's centre point.

**Q: How long does a run take?**
A: A 100-listing search without full details took 85 seconds in our tests. With full details, allow about 35 seconds per listing; the default run timeout is two hours, and a run that nears it stops cleanly with the listings already saved.

**Q: What output formats are available?**
A: JSON, CSV, Excel, XML and HTML, straight from the Apify dataset, or over the API.

**Q: Is the data in Hungarian?**
A: Field names are English. Values the site writes in words, such as condition, heating and the advert text, stay in Hungarian exactly as published.

***

### 🐛 Troubleshooting

**A search returned no listings**

- Check the run log: if it says the search has 0 results, loosen the price, area or room filters.
- Make sure the property type exists for that deal type. Plots, for example, are rarely offered for rent.

**A pasted address was refused**

- Paste a location page such as https://ingatlan.com/szentendre/elado+haz. Addresses under ingatlan.com/lista or /szukites come from the site's search form and are not read; open the place's own page instead.

**An advert came back as "not found"**

- The advert has been sold, let or taken down since you saved the link. It is not billed.

**Some pages said "temporarily unavailable"**

- ingatlan.com occasionally turns requests away. The listings already saved are kept, nothing failed was billed, and running the same input again usually picks up the rest.

***

### ⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

Ingatlan.com is a trademark of ingatlan.com Zrt. This actor is not affiliated with, endorsed by, or sponsored by ingatlan.com Zrt.

***

### 🤝 Support

**Questions, ideas or a field you need?**

- Open an issue on the [actor page](https://apify.com/sian.agency/ingatlan-property-scraper/issues)
- Browse more tools in the [SIÁN Agency Store](https://apify.com/sian.agency?fpr=sian)
- 📧 <apify@sian-agency.online>

***

**Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)**

# Changelog

This Actor's version history is a separate document: https://apify.com/sian.agency/ingatlan-property-scraper/changelog.md

# Actor input Schema

## `operation` (type: `string`):

Property Search reads ingatlan.com result pages for the location, deal type and property type below, 20 listings per page. Property Detail opens the adverts you list in Advert links or IDs and returns the full advert for each.

## `locations` (type: `array`):

Where in Hungary to search. Each value is ingatlan.com's own area page: all of Hungary, Budapest, one of its 23 districts, the Buda or Pest side, a county, Lake Balaton or a major town. Several locations run as separate searches. For a smaller town or a neighbourhood, paste its ingatlan.com page into Search addresses.

## `dealType` (type: `string`):

Sale listings carry an asking price in forints; rental listings carry the monthly rent in the same field, flagged as per month.

## `propertyType` (type: `string`):

Which ingatlan.com category to read. One type per run keeps every row comparable; run again for another type.

## `maxResults` (type: `integer`):

Stop after this many listings across the whole run, not per location. A page holds 20 listings.

## `minPrice` (type: `integer`):

Skip listings priced below this, in forints. For rentals this is the monthly rent. Leave empty for no lower bound.

## `maxPrice` (type: `integer`):

Skip listings priced above this, in forints. For rentals this is the monthly rent. Leave empty for no upper bound.

## `minArea` (type: `integer`):

Skip listings smaller than this. Leave empty for no minimum.

## `maxArea` (type: `integer`):

Skip listings larger than this. Leave empty for no maximum.

## `minRooms` (type: `integer`):

At least this many rooms, as ingatlan.com counts them. Leave empty for any.

## `maxRooms` (type: `integer`):

At most this many rooms. Leave empty for any.

## `newBuildOnly` (type: `boolean`):

Keep only listings ingatlan.com marks as new construction (új építésű).

## `includeDetails` (type: `boolean`):

Open each listing's own advert page to add the full description, every photo, condition, heating, floor, energy rating, parking, map position and the agency. One extra page per listing, billed as one Property Detail on top of the listing row.

## `searchUrls` (type: `array`):

Paste ingatlan.com location pages, e.g. https://ingatlan.com/szentendre/elado+haz or https://ingatlan.com/budateteny/kiado+lakas. The place, deal and type are read from the address. Filters already in the address are kept; otherwise the filters above are added. Pages under ingatlan.com/lista or /szukites are not accepted.

## `listingUrls` (type: `array`):

Used by Property Detail: one ingatlan.com advert per line, as a link such as https://ingatlan.com/35590543 or https://ingatlan.com/xiii-ker/elado+lakas/tegla-lakas/35590543, or just the numeric ID (35590543).

## Actor input object example

```json
{
  "operation": "search",
  "locations": [
    "budapest"
  ],
  "dealType": "elado",
  "propertyType": "lakas",
  "maxResults": 100,
  "newBuildOnly": false,
  "includeDetails": false,
  "searchUrls": [],
  "listingUrls": [
    "https://ingatlan.com/35590543"
  ]
}
```

# Actor output Schema

## `ingatlanComListings` (type: `string`):

Every listing this run returned.

## `scrapingSummary` (type: `string`):

HTML summary showing successful and failed results with key metrics

# 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 = {
    "operation": "search",
    "locations": [
        "budapest"
    ],
    "dealType": "elado",
    "propertyType": "lakas",
    "maxResults": 100,
    "newBuildOnly": false,
    "includeDetails": false,
    "searchUrls": [],
    "listingUrls": [
        "https://ingatlan.com/35590543"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("sian.agency/ingatlan-property-scraper").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 = {
    "operation": "search",
    "locations": ["budapest"],
    "dealType": "elado",
    "propertyType": "lakas",
    "maxResults": 100,
    "newBuildOnly": False,
    "includeDetails": False,
    "searchUrls": [],
    "listingUrls": ["https://ingatlan.com/35590543"],
}

# Run the Actor and wait for it to finish
run = client.actor("sian.agency/ingatlan-property-scraper").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 '{
  "operation": "search",
  "locations": [
    "budapest"
  ],
  "dealType": "elado",
  "propertyType": "lakas",
  "maxResults": 100,
  "newBuildOnly": false,
  "includeDetails": false,
  "searchUrls": [],
  "listingUrls": [
    "https://ingatlan.com/35590543"
  ]
}' |
apify call sian.agency/ingatlan-property-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sian.agency/ingatlan-property-scraper"
        }
    }
}
```

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/TIoEe6JBLip4UwcDY/builds/1vp9Zzxp0QAoBwEBg/openapi.json