{ "openapi": "3.0.1", "info": { "title": "Ingatlan.com Property Scraper (dev probe)", "description": "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.", "version": "1.0", "x-build-id": "1vp9Zzxp0QAoBwEBg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~ingatlan-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-ingatlan-property-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sian.agency~ingatlan-property-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-ingatlan-property-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sian.agency~ingatlan-property-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-ingatlan-property-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "operation": { "title": "🎯 What to fetch", "enum": [ "search", "detail" ], "type": "string", "description": "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.", "default": "search" }, "locations": { "title": "📍 Locations", "uniqueItems": true, "type": "array", "description": "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.", "items": { "type": "string", "enum": [ "magyarorszag", "budapest", "budapest-budai-oldal", "budapest-pesti-oldal", "budapesti-agglomeracio", "i-ker", "ii-ker", "iii-ker", "iv-ker", "v-ker", "vi-ker", "vii-ker", "viii-ker", "ix-ker", "x-ker", "xi-ker", "xii-ker", "xiii-ker", "xiv-ker", "xv-ker", "xvi-ker", "xvii-ker", "xviii-ker", "xix-ker", "xx-ker", "xxi-ker", "xxii-ker", "xxiii-ker", "bacs-kiskun-megye", "baranya-megye", "bekes-megye", "borsod-abauj-zemplen-megye", "csongrad-csanad-megye", "fejer-megye", "gyor-moson-sopron-megye", "hajdu-bihar-megye", "heves-megye", "jasz-nagykun-szolnok-megye", "komarom-esztergom-megye", "nograd-megye", "pest-megye", "somogy-megye", "szabolcs-szatmar-bereg-megye", "tolna-megye", "vas-megye", "veszprem-megye", "zala-megye", "balaton", "balaton-deli-part", "balaton-eszaki-part", "debrecen", "szeged", "miskolc", "pecs", "gyor", "nyiregyhaza", "kecskemet", "szekesfehervar", "szombathely", "szolnok", "tatabanya", "kaposvar", "erd", "veszprem", "bekescsaba", "zalaegerszeg", "sopron", "eger", "nagykanizsa", "dunaujvaros", "hodmezovasarhely", "szentendre", "budaors", "vac", "godollo", "siofok", "balatonfured", "keszthely", "esztergom", "cegled", "salgotarjan", "szekszard" ], "enumTitles": [ "🇭🇺 All of Hungary — Magyarország", "🏙️ Budapest (all districts)", "🏙️ Budapest, Buda side — budai oldal", "🏙️ Budapest, Pest side — pesti oldal", "🏘️ Budapest agglomeration — agglomeráció", "📍 Budapest I. district — I. kerület", "📍 Budapest II. district — II. kerület", "📍 Budapest III. district — III. kerület", "📍 Budapest IV. district — IV. kerület", "📍 Budapest V. district — V. kerület", "📍 Budapest VI. district — VI. kerület", "📍 Budapest VII. district — VII. kerület", "📍 Budapest VIII. district — VIII. kerület", "📍 Budapest IX. district — IX. kerület", "📍 Budapest X. district — X. kerület", "📍 Budapest XI. district — XI. kerület", "📍 Budapest XII. district — XII. kerület", "📍 Budapest XIII. district — XIII. kerület", "📍 Budapest XIV. district — XIV. kerület", "📍 Budapest XV. district — XV. kerület", "📍 Budapest XVI. district — XVI. kerület", "📍 Budapest XVII. district — XVII. kerület", "📍 Budapest XVIII. district — XVIII. kerület", "📍 Budapest XIX. district — XIX. kerület", "📍 Budapest XX. district — XX. kerület", "📍 Budapest XXI. district — XXI. kerület", "📍 Budapest XXII. district — XXII. kerület", "📍 Budapest XXIII. district — XXIII. kerület", "🗺️ Bács-Kiskun county — Bács-Kiskun vármegye", "🗺️ Baranya county — Baranya vármegye", "🗺️ Békés county — Békés vármegye", "🗺️ Borsod-Abaúj-Zemplén county — Borsod-Abaúj-Zemplén vármegye", "🗺️ Csongrád-Csanád county — Csongrád-Csanád vármegye", "🗺️ Fejér county — Fejér vármegye", "🗺️ Győr-Moson-Sopron county — Győr-Moson-Sopron vármegye", "🗺️ Hajdú-Bihar county — Hajdú-Bihar vármegye", "🗺️ Heves county — Heves vármegye", "🗺️ Jász-Nagykun-Szolnok county — Jász-Nagykun-Szolnok vármegye", "🗺️ Komárom-Esztergom county — Komárom-Esztergom vármegye", "🗺️ Nógrád county — Nógrád vármegye", "🗺️ Pest county — Pest vármegye", "🗺️ Somogy county — Somogy vármegye", "🗺️ Szabolcs-Szatmár-Bereg county — Szabolcs-Szatmár-Bereg vármegye", "🗺️ Tolna county — Tolna vármegye", "🗺️ Vas county — Vas vármegye", "🗺️ Veszprém county — Veszprém vármegye", "🗺️ Zala county — Zala vármegye", "🌊 Lake Balaton (all shores) — Balaton", "🌊 Lake Balaton, south shore — déli part", "🌊 Lake Balaton, north shore — északi part", "🏙️ Debrecen (city)", "🏙️ Szeged (city)", "🏙️ Miskolc (city)", "🏙️ Pécs (city)", "🏙️ Győr (city)", "🏙️ Nyíregyháza (city)", "🏙️ Kecskemét (city)", "🏙️ Székesfehérvár (city)", "🏙️ Szombathely (city)", "🏙️ Szolnok (city)", "🏙️ Tatabánya (city)", "🏙️ Kaposvár (city)", "🏙️ Érd (city)", "🏙️ Veszprém (city)", "🏙️ Békéscsaba (city)", "🏙️ Zalaegerszeg (city)", "🏙️ Sopron (city)", "🏙️ Eger (city)", "🏙️ Nagykanizsa (city)", "🏙️ Dunaújváros (city)", "🏙️ Hódmezővásárhely (city)", "🏙️ Szentendre (city)", "🏙️ Budaörs (city)", "🏙️ Vác (city)", "🏙️ Gödöllő (city)", "🏙️ Siófok (city)", "🏙️ Balatonfüred (city)", "🏙️ Keszthely (city)", "🏙️ Esztergom (city)", "🏙️ Cegléd (city)", "🏙️ Salgótarján (city)", "🏙️ Szekszárd (city)" ] }, "default": [ "budapest" ] }, "dealType": { "title": "🤝 For sale or for rent", "enum": [ "elado", "kiado" ], "type": "string", "description": "Sale listings carry an asking price in forints; rental listings carry the monthly rent in the same field, flagged as per month.", "default": "elado" }, "propertyType": { "title": "🏠 Property type", "enum": [ "lakas", "haz", "telek", "garazs", "nyaralo", "iroda", "uzlethelyiseg", "vendeglato", "ipari", "mezogazdasagi", "intezmeny" ], "type": "string", "description": "Which ingatlan.com category to read. One type per run keeps every row comparable; run again for another type.", "default": "lakas" }, "maxResults": { "title": "🔢 Max listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many listings across the whole run, not per location. A page holds 20 listings.", "default": 100 }, "minPrice": { "title": "💵 Min price (HUF)", "minimum": 0, "type": "integer", "description": "Skip listings priced below this, in forints. For rentals this is the monthly rent. Leave empty for no lower bound." }, "maxPrice": { "title": "💰 Max price (HUF)", "minimum": 0, "type": "integer", "description": "Skip listings priced above this, in forints. For rentals this is the monthly rent. Leave empty for no upper bound." }, "minArea": { "title": "📐 Min floor area (m²)", "minimum": 0, "type": "integer", "description": "Skip listings smaller than this. Leave empty for no minimum." }, "maxArea": { "title": "📏 Max floor area (m²)", "minimum": 0, "type": "integer", "description": "Skip listings larger than this. Leave empty for no maximum." }, "minRooms": { "title": "🛏️ Min rooms", "minimum": 1, "maximum": 20, "type": "integer", "description": "At least this many rooms, as ingatlan.com counts them. Leave empty for any." }, "maxRooms": { "title": "🛏️ Max rooms", "minimum": 1, "maximum": 20, "type": "integer", "description": "At most this many rooms. Leave empty for any." }, "newBuildOnly": { "title": "🏗️ New builds only", "type": "boolean", "description": "Keep only listings ingatlan.com marks as new construction (új építésű).", "default": false }, "includeDetails": { "title": "📄 Add full details", "type": "boolean", "description": "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.", "default": false }, "searchUrls": { "title": "🌐 Search addresses", "type": "array", "description": "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.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "listingUrls": { "title": "🏠 Advert links or IDs", "type": "array", "description": "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).", "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }