Ingatlan APIingatlan.com ↗
Search and retrieve Hungarian real estate listings from ingatlan.com. Get prices, addresses, sizes, room counts, and development projects via 3 endpoints.
What is the Ingatlan API?
The ingatlan.com API provides access to Hungary's largest property listing site through 3 endpoints covering listing search, listing detail retrieval, and new development project discovery. The search_listings endpoint returns up to 20 properties per query with price, address, floor area, and room count. The get_listing_details endpoint exposes structured attribute tables in Hungarian, year built, and full description text by numeric listing ID.
curl -X GET 'https://api.parse.bot/scraper/4d45a3e8-ac62-4a2f-87c8-883c3f88c583/search_listings?query=budapest&property_type=elado%2Blakas' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace ingatlan-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.ingatlan_com_api_scraper import Ingatlan, Listing, ListingDetail, Project, PropertyType, ProjectType
client = Ingatlan()
# Search for apartments for sale in Budapest
for listing in client.listings.search(query="budapest", property_type=PropertyType.APARTMENTS_FOR_SALE):
print(listing.id, listing.price, listing.address, listing.size, listing.rooms)
# Get detailed info for this listing
detail = listing.details.get()
print(detail.title, detail.location, detail.price_currency, detail.year_built)
break
# Search for development projects filtered by flat type
for project in client.projects.search(property_type=ProjectType.FLAT):
print(project.title, project.description, project.url)
Search for real estate listings on ingatlan.com by location and property type. Returns up to 20 listings per request with price, address, size, room count, and listing URL. Results are from the first page of the search.
| Param | Type | Description |
|---|---|---|
| query | string | Search query, typically a city or district name (e.g. 'budapest', 'debrecen', 'szeged'). |
| property_type | string | Property type expression used in the URL path. Values: 'elado+lakas' (apartments for sale), 'kiado+lakas' (apartments for rent), 'elado+haz' (houses for sale), 'kiado+haz' (houses for rent). |
{
"type": "object",
"fields": {
"total": "integer count of listings returned in this page",
"listings": "array of listing objects each containing id, price, address, size, rooms, url"
},
"sample": {
"data": {
"total": 20,
"listings": [
{
"id": "35421043",
"url": "https://ingatlan.com/35421043",
"size": "63 m2",
"price": "118,80 M Ft",
"rooms": "2 + 1 fél",
"address": "Budapest XIII. kerület, Tutaj utca"
}
]
},
"status": "success"
}
}About the Ingatlan API
Searching Listings
The search_listings endpoint accepts a query parameter (typically a Hungarian city or district name such as budapest or debrecen) and a property_type path expression. Supported property_type values include elado+lakas for apartments for sale and kiado+lakas for apartments to rent. Each response includes a total count and a listings array where every object carries an id, price, address, size, rooms, and a direct url to the listing on ingatlan.com. Results reflect the first page of matches — up to 20 listings.
Listing Details
Pass any id from a search_listings response to get_listing_details to retrieve the full record for that property. The response includes size (floor area with unit, e.g. 63 m²), price (numeric value in HUF minor units), price_currency, rooms, year_built, location, a free-text description, and a features object. The features object contains key-value pairs of property attributes as they appear on the site — labels and values are in Hungarian.
Development Projects
The search_projects endpoint returns promoted new-build development projects. It accepts an optional property_type filter (flat or house) and returns a projects array. Each project object includes a title, short description, url, and image URL. This endpoint is scoped to promoted listings and does not overlap with resale or rental inventory returned by search_listings.
The Ingatlan API is a managed, monitored endpoint for ingatlan.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ingatlan.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ingatlan.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Aggregate Hungarian apartment-for-sale listings by city to build a cross-location price comparison tool.
- Track price changes on specific ingatlan.com listings by polling
get_listing_detailswith known listing IDs. - Extract
year_builtandsizefields to build a filterable dataset of Budapest properties by construction era. - Pull
featuresattribute tables to normalize Hungarian property characteristics (e.g. floor, condition, heating type) into a structured database. - Discover new-build development projects in Hungary by property type using
search_projectsto feed a project tracker. - Compile address and price data from
search_listingsresults to produce rental yield estimates by district. - Seed a property alert system by regularly searching specific queries and comparing returned listing IDs against previously stored results.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ingatlan.com have an official developer API?+
What does `get_listing_details` return that `search_listings` does not?+
search_listings returns a summary set: id, price, address, size, rooms, and URL. get_listing_details adds year_built, a description text block, a structured features object with all property attributes in Hungarian, and the explicit price_currency field. The features object is only available through the detail endpoint.Does `search_listings` support pagination beyond the first page?+
Can I filter listings by price range, floor area, or number of rooms?+
search_listings endpoint accepts query and property_type as filters; price range, size, and room-count filters are not currently exposed as parameters. You can fork this API on Parse and revise it to add those filter inputs to the search endpoint.Are commercial properties or land listings covered?+
property_type values cover residential apartments (for sale and for rent). Commercial properties, land parcels, and office or industrial listings are not currently returned. You can fork this API on Parse and revise it to add the corresponding property type expressions for those categories.