{ "openapi": "3.0.1", "info": { "title": "Madlan Scraper - Real Estate Israel", "description": "Scrape sale and rental listings from madlan.co.il. Collect prices, areas, addresses, coordinates, images, and amenities. Search by city or coordinates with distance, budget, property type, rooms, and filters. Export JSON, CSV, or Excel for property research, valuation, and market analysis.", "version": "0.0", "x-build-id": "txJnmCFU3tjExu11c" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igolaizola~madlan-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igolaizola-madlan-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~madlan-scraper/runs": { "post": { "operationId": "runs-sync-igolaizola-madlan-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~madlan-scraper/run-sync": { "post": { "operationId": "run-sync-igolaizola-madlan-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": "Maximum listings", "minimum": 0, "type": "integer", "description": "Maximum number of listings to return. Use 0 to continue through all available pages.", "default": 100 }, "location": { "title": "City or area", "type": "string", "description": "City, neighborhood, or area name to search, for example תל אביב. Used when latitude and longitude are not provided." }, "locationType": { "title": "Location type", "enum": [ "", "city", "neighbourhood", "street", "address", "project", "commercialProject", "schoolDoc", "developer", "agent", "office", "customZone", "country", "borough", "county" ], "type": "string", "description": "Choose how a matching location suggestion is selected. Automatic uses the first suggestion.", "default": "" }, "latitude": { "title": "Latitude", "minimum": -90, "maximum": 90, "type": "number", "description": "Center latitude for a coordinate search. Use together with longitude; coordinates take precedence over the named location." }, "longitude": { "title": "Longitude", "minimum": -180, "maximum": 180, "type": "number", "description": "Center longitude for a coordinate search. Use together with latitude." }, "distanceKm": { "title": "Distance around point (km)", "minimum": 1, "type": "integer", "description": "Half-width of the square search area centered on the coordinate point, in kilometers.", "default": 20 }, "operation": { "title": "Listing type", "enum": [ "sale", "rent" ], "type": "string", "description": "Choose whether to find properties offered for sale or rent.", "default": "sale" }, "includeNewDevelopments": { "title": "Include new developments", "type": "boolean", "description": "Include new-development project listings in sale searches.", "default": true }, "minPrice": { "title": "Minimum price (ILS)", "minimum": 0, "type": "integer", "description": "Minimum asking price in Israeli shekels. Leave at 0 for no minimum.", "default": 0 }, "maxPrice": { "title": "Maximum price (ILS)", "minimum": 0, "type": "integer", "description": "Maximum asking price in Israeli shekels. Leave at 0 for no maximum.", "default": 0 }, "minPricePerSqm": { "title": "Minimum price per square meter (ILS)", "minimum": 0, "type": "integer", "description": "Minimum asking price per square meter in Israeli shekels. Leave at 0 for no minimum.", "default": 0 }, "maxPricePerSqm": { "title": "Maximum price per square meter (ILS)", "minimum": 0, "type": "integer", "description": "Maximum asking price per square meter in Israeli shekels. Leave at 0 for no maximum.", "default": 0 }, "minMonthlyTax": { "title": "Minimum monthly building tax (ILS)", "minimum": 0, "type": "integer", "description": "Minimum monthly building tax in Israeli shekels. Leave at 0 for no minimum.", "default": 0 }, "maxMonthlyTax": { "title": "Maximum monthly building tax (ILS)", "minimum": 0, "type": "integer", "description": "Maximum monthly building tax in Israeli shekels. Leave at 0 for no maximum.", "default": 0 }, "minRooms": { "title": "Minimum rooms", "minimum": 0, "type": "number", "description": "Minimum number of rooms. Half-room values are supported; leave at 0 for no minimum.", "default": 0 }, "maxRooms": { "title": "Maximum rooms", "minimum": 0, "type": "number", "description": "Maximum number of rooms. Half-room values are supported; leave at 0 for no maximum.", "default": 0 }, "minBathrooms": { "title": "Minimum bathrooms", "minimum": 0, "type": "number", "description": "Minimum number of bathrooms; leave at 0 for no minimum.", "default": 0 }, "maxBathrooms": { "title": "Maximum bathrooms", "minimum": 0, "type": "number", "description": "Maximum number of bathrooms; leave at 0 for no maximum.", "default": 0 }, "minArea": { "title": "Minimum area (m²)", "minimum": 0, "type": "integer", "description": "Minimum property area in square meters. Leave at 0 for no minimum.", "default": 0 }, "maxArea": { "title": "Maximum area (m²)", "minimum": 0, "type": "integer", "description": "Maximum property area in square meters. Leave at 0 for no maximum.", "default": 0 }, "minFloor": { "title": "Minimum floor", "type": "integer", "description": "Minimum floor number. Leave at 0 for no minimum.", "default": 0 }, "maxFloor": { "title": "Maximum floor", "type": "integer", "description": "Maximum floor number. Leave at 0 for no maximum.", "default": 0 }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Restrict results to the selected residential property types. Leave empty for all types.", "items": { "type": "string", "enum": [ "flat", "villa", "gardenApartment", "cottage", "dualCottage", "penthouse", "attic", "farmLand", "duplex", "land", "building" ], "enumTitles": [ "Apartment", "Villa", "Garden apartment", "Cottage", "Semi-detached cottage", "Penthouse", "Attic apartment", "Farm land", "Duplex", "Land", "Building" ] } }, "propertyConditions": { "title": "Property condition", "type": "array", "description": "Restrict results to the selected property conditions. Leave empty for all conditions.", "items": { "type": "string", "enum": [ "new", "asNew", "renovated", "preserved", "toRenovated" ], "enumTitles": [ "New", "Like new", "Renovated", "Preserved", "Needs renovation" ] } }, "sellerType": { "title": "Seller type", "enum": [ "", "developer" ], "type": "string", "description": "Restrict results to listings from a selected seller category.", "default": "" }, "parking": { "title": "Parking", "type": "boolean", "description": "Only include properties with parking.", "default": false }, "elevator": { "title": "Elevator", "type": "boolean", "description": "Only include properties in buildings with an elevator.", "default": false }, "balcony": { "title": "Balcony", "type": "boolean", "description": "Only include properties with a balcony.", "default": false }, "airConditioning": { "title": "Air conditioning", "type": "boolean", "description": "Only include properties with air conditioning.", "default": false }, "storage": { "title": "Storage", "type": "boolean", "description": "Only include properties with storage space.", "default": false }, "accessible": { "title": "Accessible property", "type": "boolean", "description": "Only include properties marked as accessible.", "default": false }, "securityBars": { "title": "Security bars", "type": "boolean", "description": "Only include properties marked as having security bars.", "default": false }, "protectedRoom": { "title": "Protected room or shelter", "type": "boolean", "description": "Only include properties with a protected room or listed shelter.", "default": false }, "attic": { "title": "Attic", "type": "boolean", "description": "Only include properties marked as having an attic.", "default": false }, "basement": { "title": "Basement", "type": "boolean", "description": "Only include properties marked as having a basement.", "default": false }, "buildingLaundry": { "title": "Building laundry", "type": "boolean", "description": "Only include properties in buildings with shared laundry facilities.", "default": false }, "ceilingFan": { "title": "Ceiling fan", "type": "boolean", "description": "Only include properties marked as having a ceiling fan.", "default": false }, "dishwasher": { "title": "Dishwasher", "type": "boolean", "description": "Only include properties marked as having a dishwasher.", "default": false }, "doorman": { "title": "Doorman", "type": "boolean", "description": "Only include properties in buildings with a doorman.", "default": false }, "fireplace": { "title": "Fireplace", "type": "boolean", "description": "Only include properties marked as having a fireplace.", "default": false }, "furnished": { "title": "Furnished", "type": "boolean", "description": "Only include furnished properties.", "default": false }, "garage": { "title": "Garage", "type": "boolean", "description": "Only include properties marked as having a garage.", "default": false }, "gym": { "title": "Gym", "type": "boolean", "description": "Only include properties in buildings with a gym.", "default": false }, "heating": { "title": "Heating", "type": "boolean", "description": "Only include properties marked as having heating.", "default": false }, "outdoorSpace": { "title": "Outdoor space", "type": "boolean", "description": "Only include properties marked as having outdoor space.", "default": false }, "pool": { "title": "Pool", "type": "boolean", "description": "Only include properties in buildings with a pool.", "default": false }, "roofDeck": { "title": "Roof deck", "type": "boolean", "description": "Only include properties marked as having a roof deck.", "default": false }, "unitLaundry": { "title": "In-unit laundry", "type": "boolean", "description": "Only include properties with laundry facilities in the unit.", "default": false }, "petsAllowed": { "title": "Pets allowed", "type": "boolean", "description": "Only include properties marked as allowing pets.", "default": false }, "includePriceDrops": { "title": "Recent price drops", "type": "boolean", "description": "Include only listings marked with a recent price drop.", "default": false }, "belowMarketPrice": { "title": "Below market estimate", "type": "boolean", "description": "Include only listings marked below Madlan's estimated market price.", "default": false }, "includeDiscountedProjects": { "title": "Discounted projects", "type": "boolean", "description": "Include discounted new-development projects in sale searches.", "default": false }, "immediateAvailability": { "title": "Immediate availability", "type": "boolean", "description": "Only include properties marked as immediately available.", "default": false }, "noBrokerFee": { "title": "No broker fee", "type": "boolean", "description": "Only include listings marked as having no broker fee.", "default": false } } }, "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 } } } } } } } } } }