{ "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": "6jJ8fOeJ9wALRjfxU" }, "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.", "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" }, "order": { "title": "Sort Order", "enum": [ "Default", "DateDesc" ], "type": "string", "description": "Sort order.", "default": "Default" }, "distributionType": { "title": "Distribution Type", "enum": [ "BUY", "RENT" ], "type": "string", "description": "Transaction mode." }, "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": [ "ROOF_STOREY", "GROUNDFLOOR", "OTHERS" ], "enumTitles": [ "Roof Storey", "Groundfloor", "Others" ] } }, "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 } } } } } } } } } }