{ "openapi": "3.0.1", "info": { "title": "Immowelt Scraper - Real Estate Germany", "description": "Search immowelt.de for apartments, houses, plots, and commercial properties. Filter by city or coordinates, buy or rent, price, rooms, size, features, and energy rating. Export as JSON, CSV, or Excel, or connect via API and MCP for market research, lead generation, and price tracking with fresh data", "version": "0.0", "x-build-id": "TIqXChCcLTUFsPQzJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igolaizola~immowelt-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igolaizola-immowelt-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/igolaizola~immowelt-scraper/runs": { "post": { "operationId": "runs-sync-igolaizola-immowelt-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/igolaizola~immowelt-scraper/run-sync": { "post": { "operationId": "run-sync-igolaizola-immowelt-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": { "maxItems": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum number of listings to extract. Set to 0 or omit to collect all available listings. The Apify Console input defaults to 30. Unlimited searches and limits above 570 use a price sort.", "default": 30 }, "properties": { "title": "Property IDs", "type": "array", "description": "List of Immowelt property IDs to fetch directly. When set, location and filters are ignored. Each result includes '_details'.", "default": [], "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch Details", "type": "boolean", "description": "Fetch detailed data per listing and store it under _details.", "default": false }, "location": { "title": "Location", "type": "string", "description": "City, postcode, borough, or neighborhood. The actor resolves it to a location ID automatically." }, "locationID": { "title": "Location ID", "type": "string", "description": "Optional single location ID override" }, "locationType": { "title": "Location Type", "enum": [ "", "country", "state", "region", "city", "district", "neighborhood", "postal_code", "street", "house_number" ], "type": "string", "description": "Optional location type filter used when selecting a location suggestion.", "default": "" }, "latitude": { "title": "Latitude", "minimum": -90, "maximum": 90, "type": "number", "description": "Latitude of the center point for coordinate-based search. Use together with longitude. When set, this takes precedence over location and locationID." }, "longitude": { "title": "Longitude", "minimum": -180, "maximum": 180, "type": "number", "description": "Longitude of the center point for coordinate-based search. Use together with latitude." }, "distanceKm": { "title": "Distance (km)", "minimum": 1, "type": "integer", "description": "Search radius around the latitude/longitude point, in kilometers.", "default": 20 }, "order": { "title": "Sort Order", "enum": [ "default", "datedesc" ], "type": "string", "description": "Sort order. Above 570 items, non-price sorts are automatically overridden.", "default": "default" }, "operation": { "title": "Operation", "enum": [ "buy", "rent" ], "type": "string", "description": "Property operation.", "default": "buy" }, "estateType": { "title": "Estate Type", "enum": [ "house_or_apartment", "apartment", "house", "building", "senior", "plot", "parking", "investment", "office", "trading", "gastronomy_hotel", "storage_production", "agriculture_forestry", "miscellaneous" ], "type": "string", "description": "Property type." }, "subEstateTypes": { "title": "Sub Estate Types", "type": "array", "description": "Optional subtype filters.", "items": { "type": "string", "enum": [ "agriculture_company", "agriculture_forestry", "apartment", "apartment_house", "apart_hotel", "assisted_living", "atelier", "beach_house", "boat_dock", "box", "bungalow", "cafe_bar_pub", "carport", "car_park", "castle", "castle_manor_house", "chalet", "club_discotheque", "commercial", "commercial_parc", "corner_terrace_house", "coworking", "double_garage", "duplex", "duplex_garage", "end_terrace_house", "farmhouse", "farm_ranch", "finca", "fishing", "flatsharing_room", "forestry", "garage", "garage_area", "garage_repair", "gardening", "garden_house", "gite", "groundfloor", "hotel", "house", "house_park", "hunting", "industry", "kiosk", "lakeside_property", "leisure", "leisure_facility", "living", "living_and_commercial", "living_and_commercial_building", "loft", "logistics_center", "manor_house", "medical", "medical_building", "medical_care", "medical_floor", "mid_terrace_house", "miscellaneous", "misc_agriculture", "misc_storage", "mixed", "model_house", "mountain_hut", "multi_family_house", "multi_storey", "new_build_loft", "new_build_lots", "new_build_program_apartment", "new_build_program_house", "new_build_program_office", "new_build_program_parking", "new_home", "no_development", "office_building", "office_centre", "office_space", "office_storage_building", "open_space", "orchard", "outdoor_space", "outside", "parking_area", "parking_indoor", "parking_outdoor", "penthouse", "planned", "plot", "production_hall", "reference", "residential_complex", "restaurant", "riding", "rustico", "semidetached_house", "shared_office", "shopping_centre", "showroom_space", "show_house", "sales_area", "single_family_house", "single_multi_houses", "single_office", "special_real_estate", "special_use", "store", "street_parking", "studio", "terrace", "terrace_house", "town_house", "triplex", "unbuildable_land", "underground_garage", "underground_parking_space", "unfinished_attic_space", "unknown", "villa", "warehouse_hall", "winery" ], "enumTitles": [ "Agriculture / Forestry > Agriculture Company", "Agriculture / Forestry > Agriculture Forestry", "Apartment > Apartment", "Apartment > Apartment House", "Gastronomy / Hotel > Apart Hotel", "Building > Assisted Living", "Office > Atelier", "House > Beach House", "Parking > Boat Dock", "Parking > Box", "House > Bungalow", "Gastronomy / Hotel > Cafe Bar Pub", "Parking > Carport", "Parking > Car Park", "House > Castle", "House > Castle Manor House", "House > Chalet", "Gastronomy / Hotel > Club Discotheque", "Building > Commercial", "Building > Commercial Parc", "House > Corner Terrace House", "Office > Coworking", "Parking > Double Garage", "Apartment > Duplex", "Apartment > Duplex Garage", "House > End Terrace House", "House > Farmhouse", "Agriculture / Forestry > Farm Ranch", "House > Finca", "Plot > Fishing", "Apartment > Flatsharing Room", "Agriculture / Forestry > Forestry", "Parking > Garage", "Parking > Garage Area", "Parking > Garage Repair", "Plot > Gardening", "House > Garden House", "House > Gite", "Apartment > Groundfloor", "Gastronomy / Hotel > Hotel", "House > House", "House > House Park", "Plot > Hunting", "Storage / Production > Industry", "Trading > Kiosk", "Plot > Lakeside Property", "Miscellaneous > Leisure", "Miscellaneous > Leisure Facility", "Building > Living", "Building > Living and Commercial", "Building > Living and Commercial Building", "Apartment > Loft", "Storage / Production > Logistics Center", "House > Manor House", "Office > Medical", "Building > Medical Building", "Senior > Medical Care", "Office > Medical Floor", "House > Mid Terrace House", "Miscellaneous > Miscellaneous", "Agriculture / Forestry > Misc Agriculture", "Storage / Production > Misc Storage", "Miscellaneous > Mixed", "House > Model House", "House > Mountain Hut", "House > Multi Family House", "Apartment > Multi Storey", "Apartment > New Build Loft", "Plot > New Build Lots", "Apartment > New Build Program Apartment", "House > New Build Program House", "Investment > New Build Program Office", "Parking > New Build Program Parking", "House > New Home", "Plot > No Development", "Building > Office Building", "Office > Office Centre", "Office > Office Space", "Building > Office Storage Building", "Plot > Open Space", "Plot > Orchard", "Plot > Outdoor Space", "Miscellaneous > Outside", "Parking > Parking Area", "Parking > Parking Indoor", "Parking > Parking Outdoor", "Apartment > Penthouse", "Investment > Planned", "Plot > Plot", "Storage / Production > Production Hall", "Investment > Reference", "Building > Residential Complex", "Gastronomy / Hotel > Restaurant", "Plot > Riding", "House > Rustico", "House > Semidetached House", "Office > Shared Office", "Trading > Shopping Centre", "Office > Showroom Space", "House > Show House", "Trading > Sales Area", "House > Single Family House", "House > Single Multi Houses", "Office > Single Office", "Miscellaneous > Special Real Estate", "Miscellaneous > Special Use", "Trading > Store", "Parking > Street Parking", "Apartment > Studio", "Miscellaneous > Terrace", "House > Terrace House", "House > Town House", "Apartment > Triplex", "Plot > Unbuildable Land", "Parking > Underground Garage", "Parking > Underground Parking Space", "Apartment > Unfinished Attic Space", "Miscellaneous > Unknown", "House > Villa", "House > Warehouse Hall", "Agriculture / Forestry > Winery" ] } }, "features": { "title": "Features", "type": "array", "description": "Optional features.", "items": { "type": "string", "enum": [ "parking_garage", "balcony_terrace", "garden", "swimming_pool", "bathroom_window", "bathtub", "cellar", "furnished", "unfurnished", "kitchen_fully_equipped", "vacant", "to_renovate", "pets_allowed", "assisted_living", "reduce_mobility_access", "elevator" ], "enumTitles": [ "Parking Garage", "Balcony / Terrace", "Garden", "Swimming Pool", "Bathroom Window", "Bathtub", "Cellar", "Furnished", "Unfurnished", "Kitchen Fully Equipped", "Vacant", "To Renovate", "Pets Allowed", "Assisted Living", "Reduced Mobility Access", "Elevator" ] } }, "energyScores": { "title": "Energy Scores", "type": "array", "description": "Optional energy score filters.", "items": { "type": "string", "enum": [ "a_plus", "a", "b", "c", "d", "e", "f", "g", "h", "not_applicable", "none" ], "enumTitles": [ "A+", "A", "B", "C", "D", "E", "F", "G", "H", "Not Applicable", "None" ] } }, "furnished": { "title": "Furnished", "enum": [ "furnished", "unfurnished" ], "type": "string", "description": "Furnished status." }, "subsidized": { "title": "Subsidized", "type": "string", "description": "Optional subsidized filter value." }, "classifiedBusiness": { "title": "Classified Business", "enum": [ "professional_unitary", "professional", "private", "unknown" ], "type": "string", "description": "Business classification filter." }, "commissionFree": { "title": "Commission Free", "type": "boolean", "description": "Only commission-free listings." }, "radius": { "title": "Radius", "type": "number", "description": "Optional search radius." }, "minPrice": { "title": "Min Price", "type": "integer", "description": "Minimum price." }, "maxPrice": { "title": "Max Price", "type": "integer", "description": "Maximum price." }, "minRooms": { "title": "Min Rooms", "type": "number", "description": "Minimum rooms." }, "maxRooms": { "title": "Max Rooms", "type": "number", "description": "Maximum rooms." }, "minBedrooms": { "title": "Min Bedrooms", "type": "integer", "description": "Minimum bedrooms." }, "maxBedrooms": { "title": "Max Bedrooms", "type": "integer", "description": "Maximum bedrooms." }, "minFloors": { "title": "Min Floors", "type": "integer", "description": "Minimum number of floors." }, "maxFloors": { "title": "Max Floors", "type": "integer", "description": "Maximum number of floors." }, "minSpace": { "title": "Min Space (m2)", "type": "integer", "description": "Minimum living space in square meters." }, "maxSpace": { "title": "Max Space (m2)", "type": "integer", "description": "Maximum living space in square meters." }, "minPlotSpace": { "title": "Min Plot Space", "type": "integer", "description": "Minimum plot size." }, "maxPlotSpace": { "title": "Max Plot Space", "type": "integer", "description": "Maximum plot size." }, "minYearOfConstruction": { "title": "Min Year", "type": "integer", "description": "Minimum construction year." }, "maxYearOfConstruction": { "title": "Max Year", "type": "integer", "description": "Maximum construction year." }, "projectTypes": { "title": "Project Types", "type": "array", "description": "Optional project type filters.", "items": { "type": "string", "enum": [ "stock", "resale", "new_build", "projected", "foreclosure", "investment", "swap_apartment", "flatsharing", "short_time_rental", "life_annuity" ], "enumTitles": [ "Stock", "Resale", "New Build", "Projected", "Foreclosure", "Investment", "Swap Apartment", "Flatsharing", "Short Time Rental", "Life Annuity" ] } }, "locationsInBuilding": { "title": "Locations In Building", "type": "array", "description": "Optional in-building location filters.", "items": { "type": "string", "enum": [ "roof_storey", "groundfloor", "others" ], "enumTitles": [ "Roof Storey", "Groundfloor", "Others" ] } }, "classifiedDisplay": { "title": "Classified Display", "type": "array", "description": "Optional classified display filter.", "items": { "type": "string", "enum": [ "stock", "resale", "new_build", "projected", "foreclosure", "investment", "swap_apartment", "flatsharing", "short_time_rental", "life_annuity" ], "enumTitles": [ "Stock", "Resale", "New Build", "Projected", "Foreclosure", "Investment", "Swap Apartment", "Flatsharing", "Short Time Rental", "Life Annuity" ] } }, "energyHeating": { "title": "Energy Heating", "type": "array", "description": "Optional energy heating filter.", "items": { "type": "string", "enum": [ "coal", "district_heating", "electric", "gas", "geothermic_energy", "heat_pump", "liquid_gas", "oil", "solar", "wind", "wood", "pellets" ], "enumTitles": [ "Coal", "District Heating", "Electric", "Gas", "Geothermic Energy", "Heat Pump", "Liquid Gas", "Oil", "Solar", "Wind", "Wood", "Pellets" ] } }, "keywords": { "title": "Keywords", "type": "array", "description": "Optional search keywords.", "items": { "type": "string" } }, "matchAnyKeyword": { "title": "Match Any Keyword", "type": "boolean", "description": "If true, listing can match any keyword; otherwise all keywords should match." }, "isSaleGoodwill": { "title": "Is Sale Goodwill", "type": "boolean", "description": "Optional goodwill sale filter." }, "availableFromMax": { "title": "Available From Max", "type": "string", "description": "Optional latest availability date/value." }, "availableFromIsLooseMode": { "title": "Available From Loose", "type": "boolean", "description": "Optional loose-mode availability matching." }, "preferredWarmRent": { "title": "Preferred Warm Rent", "type": "boolean", "description": "Optional preferred warm-rent filter." } } }, "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 } } } } } } } } } }