{ "openapi": "3.0.1", "info": { "title": "Immoscout24 Scraper with Contacts | All In One", "description": "Extract ImmobilienScout24 listings across Germany, Austria, and Switzerland with rich property detail, agency contacts, media, development data, and flexible market filters. Built for enterprise-grade real estate intelligence, lead enrichment, and automated analytics pipelines.", "version": "0.0", "x-build-id": "RMT5AbRCszgJRNTdr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~immobilienscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-immobilienscout24-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/fatihtahta~immobilienscout24-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-immobilienscout24-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/fatihtahta~immobilienscout24-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-immobilienscout24-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": { "start_url": { "title": "Add ImmoScout24 Search URLs", "type": "array", "description": "Optional ImmoScout24 search results URLs from https://www.immobilienscout24.de or https://www.immobilienscout24.at. Use this for saved searches or complex website filters; Max results applies separately to each URL.", "items": { "type": "string" } }, "deal_type": { "title": "Choose Buy or Rent Listings", "enum": [ "buy", "rent" ], "type": "string", "description": "Select whether the actor should collect properties offered for purchase or for rent.", "default": "buy" }, "property_type": { "title": "Choose Property Type", "enum": [ "apartment", "house", "house_and_apartment", "land", "new_development", "garage_parking", "investment_property", "foreclosure_auction", "office", "industrial", "retail", "hospitality", "special_purpose", "commercial_land" ], "type": "string", "description": "Select the property segment that best matches your use case. Broader options can discover more listings, while narrower options keep the dataset focused.", "default": "apartment" }, "country": { "title": "Choose Country", "enum": [ "germany", "austria", "spain", "italy" ], "type": "string", "description": "Choose the ImmoScout24 country to search. Direct Start URLs are detected from their URL country path.", "default": "germany" }, "location": { "title": "Add a Location", "type": "string", "description": "Enter a city, state, ZIP code, neighborhood, or market to search on ImmobilienScout24. Leave this empty when you want a broad country-wide search or when your Start URLs already contain the desired location." }, "min_price": { "title": "Set Minimum Price", "minimum": 0, "type": "integer", "description": "Enter the minimum listing price in euros. Leave empty to include listings below any price threshold." }, "max_price": { "title": "Set Maximum Price", "minimum": 0, "type": "integer", "description": "Enter the maximum listing price in euros. Leave empty to include listings above any price threshold." }, "min_floor_area": { "title": "Set Minimum Floor Area", "minimum": 0, "type": "integer", "description": "Enter the minimum usable floor area in square meters. Leave empty to include smaller listings." }, "max_floor_area": { "title": "Set Maximum Floor Area", "minimum": 0, "type": "integer", "description": "Enter the maximum usable floor area in square meters. Leave empty to include larger listings." }, "min_bedroom": { "title": "Set Minimum Rooms", "minimum": 0, "type": "integer", "description": "Enter the minimum number of rooms to include. Leave empty to avoid applying a lower room-count filter." }, "max_bedroom": { "title": "Set Maximum Rooms", "minimum": 0, "type": "integer", "description": "Enter the maximum number of rooms to include. Leave empty to avoid applying an upper room-count filter." }, "excluded_listing_conditions": { "title": "Exclude Listing Conditions", "type": "array", "description": "Select any listing conditions you want removed from the result set. Leave empty to keep all supported listing conditions.", "items": { "type": "string", "enum": [ "new_development", "foreclosure_auction", "off_market_accepting_offers" ], "enumTitles": [ "New developments | exclude", "Foreclosure auctions | exclude", "Off-market offers | exclude" ] }, "default": [] }, "only_plus_listings": { "title": "Include Only Search+ Verified Listings", "type": "boolean", "description": "Turn this on to save only listings marked as Search+ verified on ImmoScout24. Leave it off to keep both verified and non-verified listings.", "default": false }, "only_immoscout24": { "title": "Include Only ImmoScout24-Published Listings", "type": "boolean", "description": "Turn this on to save only listings published directly on ImmoScout24. Leave it off to include all supported listing sources.", "default": false }, "unit_amenities": { "title": "Require Amenities", "type": "array", "description": "Select one or more amenities that each listing should include. More required amenities usually produce a narrower, more targeted dataset.", "items": { "type": "string", "enum": [ "balcony", "garden", "garage_parking", "fitted_kitchen", "elevator", "basement_storage", "guest_bathroom" ], "enumTitles": [ "Balcony", "Garden", "Garage or parking space", "Fitted kitchen", "Elevator", "Basement storage", "Guest bathroom" ] }, "default": [] }, "energy_efficiency_class": { "title": "Require Energy Classes", "type": "array", "description": "Choose one or more energy efficiency classes to include. Leave empty to avoid filtering by energy class.", "items": { "type": "string", "enum": [ "a_plus", "a", "b", "c", "d", "e", "f", "g", "h" ], "enumTitles": [ "A+", "A", "B", "C", "D", "E", "F", "G", "H" ] }, "default": [] }, "sort_by": { "title": "Choose Result Order", "enum": [ "default", "price_desc", "price_asc", "newest" ], "type": "string", "description": "Select how structured searches should be ordered. Direct Start URL inputs keep the sorting already present in each URL.", "default": "default" }, "publication_date": { "title": "Choose Publication Window", "enum": [ "24_hours", "3_days", "7_days", "2_weeks", "1_month" ], "type": "string", "description": "Only collect listings first published within the selected timeframe. This is useful for monitoring fresh inventory rather than reviewing the full market." }, "enrich_data": { "title": "Collect Richer Property Listing Details", "type": "boolean", "description": "Enable this for more complete property listings. This may make the run slower because the actor may spend more time collecting details for each result. Turn it off for faster runs when the standard result fields are enough.", "default": false }, "limit": { "title": "Set Max Results", "minimum": 1, "type": "integer", "description": "Set the maximum number of listings to save for each structured search or direct Start URL. Leave empty to collect as many matching listings as are available." } } }, "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 } } } } } } } } } }