{ "openapi": "3.0.1", "info": { "title": "ImmobilienScout24 Scraper - Real Estate Germany", "description": "Scrape ImmoScout24 listings in Germany for buy and rent. Filter by location, property type, price, rooms, size, energy class and more. Export clean JSON or CSV for market research, analytics, lead generation, and real estate monitoring.", "version": "0.0", "x-build-id": "FBiUG97HkmwCuyGfx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igolaizola~immobilienscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igolaizola-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/igolaizola~immobilienscout24-scraper/runs": { "post": { "operationId": "runs-sync-igolaizola-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/igolaizola~immobilienscout24-scraper/run-sync": { "post": { "operationId": "run-sync-igolaizola-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", "required": [ "maxItems" ], "properties": { "maxItems": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum number of properties to scrape", "default": 100 }, "location": { "title": "Location", "type": "string", "description": "Location to search" }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "type": "integer", "description": "Search radius in km when the location resolves to a radius search", "default": 20 }, "properties": { "title": "Property IDs", "type": "array", "description": "List of Immoscout24 property IDs to fetch directly. When set, location and all filters are ignored. Each result will include '_details'.", "default": [], "items": { "type": "string" } }, "operation": { "title": "Operation", "enum": [ "buy", "rent" ], "type": "string", "description": "Choose buy or rent", "default": "buy" }, "propertyType": { "title": "Property Type", "enum": [ "apartment", "house", "plot", "garage", "solid-prefab", "temporary-living", "shared-flat" ], "type": "string", "description": "Type shown in the app UI; mapped to the API automatically", "default": "house" }, "sortBy": { "title": "Sort By", "type": "string", "description": "Sorting mode (e.g. standard)", "default": "standard" }, "fetchDetails": { "title": "Fetch Details", "type": "boolean", "description": "Fetch detailed data per listing and store it under _details", "default": false }, "apartmentTypes": { "title": "Apartment Types", "type": "array", "description": "Apartment types filter", "items": { "type": "string", "enum": [ "apartment", "groundfloor", "halfbasement", "loft", "maisonette", "other", "penthouse", "raisedgroundfloor", "roofstorey", "terracedflat" ], "enumTitles": [ "Apartment", "Ground floor", "Half basement", "Loft", "Maisonette", "Other", "Penthouse", "Raised ground floor", "Roof storey", "Terraced flat" ] } }, "buildingTypes": { "title": "Building Types", "type": "array", "description": "Building types filter", "items": { "type": "string", "enum": [ "apartmentbuilding", "blockhouse", "bungalow", "cityvilla", "countryhouse", "familyhousewithlodgerflat", "farmhouse", "multifamilyhouse", "nondetachedhouse", "onefamilyhouse", "otherrealestate", "semidetachedhouse", "semidetachedhousepair", "singlefamilyhouse", "specialrealestate", "terracehouse", "tudorhouse", "villa", "woodenhouse" ], "enumTitles": [ "Apartment building", "Block house", "Bungalow", "City villa", "Country house", "Family house with lodger flat", "Farmhouse", "Multifamily house", "Non-detached house", "One family house", "Other real estate", "Semi-detached house", "Semi-detached house pair", "Single family house", "Special real estate", "Terrace house", "Tudor house", "Villa", "Wooden house" ] } }, "minRooms": { "title": "Min Rooms", "type": "integer", "description": "Minimum number of rooms" }, "maxRooms": { "title": "Max Rooms", "type": "integer", "description": "Maximum number of rooms" }, "minPrice": { "title": "Min Price", "type": "integer", "description": "Minimum price" }, "maxPrice": { "title": "Max Price", "type": "integer", "description": "Maximum price" }, "minLivingSpace": { "title": "Min Living Space", "type": "integer", "description": "Minimum living space in m2" }, "maxLivingSpace": { "title": "Max Living Space", "type": "integer", "description": "Maximum living space in m2" }, "minGround": { "title": "Min Ground", "type": "integer", "description": "Minimum ground size in m2" }, "maxGround": { "title": "Max Ground", "type": "integer", "description": "Maximum ground size in m2" }, "minConstructionYear": { "title": "Min Construction Year", "type": "integer", "description": "Minimum construction year" }, "maxConstructionYear": { "title": "Max Construction Year", "type": "integer", "description": "Maximum construction year" }, "energyEfficiencyClasses": { "title": "Energy Efficiency Classes", "type": "array", "description": "List of energy efficiency classes (e.g. a_plus, a, b)", "items": { "type": "string", "enum": [ "a_plus", "a", "b", "c", "d", "e", "f", "g", "h" ], "enumTitles": [ "A+", "A", "B", "C", "D", "E", "F", "G", "H" ] } }, "equipment": { "title": "Equipment", "type": "array", "description": "Equipment filters", "items": { "type": "string", "enum": [ "balcony", "builtInKitchen", "garden", "parking", "cellar", "lift", "guestToilet", "handicappedaccessible" ], "enumTitles": [ "Balcony/Terrace", "Fitted kitchen", "Garden", "Garage/Parking space", "Cellar", "Elevator", "Guest toilet", "Step-free access" ] } }, "publishedAfter": { "title": "Published After", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Only return listings published after this date (YYYY-MM-DD)" } } }, "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 } } } } } } } } } }