{ "openapi": "3.0.1", "info": { "title": "Immowelt Scraper - Real Estate Germany", "description": "Scrape Immowelt Germany real estate listings for apartments, houses, plots and commercial properties. Search by city or location ID, filter by buy/rent, price, rooms and area, and export clean JSON/CSV data for market analysis, lead generation and price monitoring.", "version": "0.0", "x-build-id": "gwKlDfhv7o5fSf2E2" }, "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", "required": [ "maxItems" ], "properties": { "maxItems": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum number of listings to extract. Above 570 items, the actor automatically uses 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": "" }, "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 } } }, "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 } } } } } } } } } }