# Homeless.co.il Real Estate Scraper (`swerve/homeless-scraper`) Actor Scrape real estate listings (rent & buy) from Homeless.co.il, one of Israel's oldest and largest classifieds boards. Listings include price, rooms, area, amenities, images, descriptions, and contact info across 127+ Israeli cities. - **URL**: https://apify.com/swerve/homeless-scraper.md - **Developed by:** [Swerve](https://apify.com/swerve) (community) - **Categories:** Real estate, Automation, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Homeless.co.il Real Estate Scraper Scrape real estate listings (rent & buy) from [Homeless.co.il](https://www.homeless.co.il), one of Israel's oldest and largest classifieds boards. Fast, reliable, and enrichment-ready. ### Why This Scraper? - **Fast & lightweight** — most queries return in under 10 seconds - **Full city coverage** — 127+ Israeli cities, Hebrew or English names - **Rich filters** — price range, rooms, neighbourhood/street - **Enrichment mode** — fetch full descriptions, amenities, area, and contact info - **Rent & Buy** — both deal types supported - **Structured output** — clean JSON with consistent field names ### Input | Field | Type | Description | |-------|------|-------------| | `city` | string | City name (Hebrew/English). Comma-separated or `"all"` | | `dealType` | string | `"rent"` or `"buy"` | | `maxItems` | integer | Max listings per city (default 200, max 500) | | `minPrice` | integer | Min price in ILS (optional) | | `maxPrice` | integer | Max price in ILS (optional) | | `minRooms` | number | Min rooms (optional) | | `maxRooms` | number | Max rooms (optional) | | `neighbourhood` | string | Filter by neighbourhood or street name in Hebrew (optional) | | `enrichListings` | boolean | Fetch contact info, description, amenities, and area sqm | #### Example Input ```json { "city": "Tel Aviv", "dealType": "rent", "maxItems": 100, "minRooms": 3, "maxPrice": 8000, "enrichListings": true } ```` ### Output Each listing includes: | Field | Type | Description | |-------|------|-------------| | `listingId` | string | Unique Homeless listing ID | | `url` | string | Direct link to listing on Homeless.co.il | | `dealType` | string | `"rent"` or `"buy"` | | `propertyType` | string | Property type (דירה, בית פרטי, דירת גג, etc.) | | `city` | string | City name in English | | `cityHebrew` | string | City name in Hebrew | | `neighbourhood` | string | Neighbourhood name | | `address` | string | Street name | | `price` | integer | Price in ILS | | `rooms` | number | Number of rooms | | `floor` | string | Floor number | | `areaSqm` | number | Area in sqm (requires `enrichListings`) | | `hasElevator` | boolean | Has elevator (requires `enrichListings`) | | `hasBalcony` | boolean | Has balcony (requires `enrichListings`) | | `hasParking` | boolean | Has parking (requires `enrichListings`) | | `hasSecureRoom` | boolean | Has safe room / mamad (requires `enrichListings`) | | `hasAC` | boolean | Has air conditioning (requires `enrichListings`) | | `isFurnished` | boolean | Has furniture (requires `enrichListings`) | | `isRenovated` | boolean | Recently renovated (requires `enrichListings`) | | `images` | array | Image URLs | | `coverImage` | string | Main listing image URL | | `listingDescription` | string | Full description (requires `enrichListings`) | | `contactName` | string | Contact person name (requires `enrichListings`) | | `contactPhone` | string | Contact phone number (requires `enrichListings`) | | `entryDate` | string | Move-in date | | `updatedAt` | string | When listing was last updated | | `scrapedAt` | string | When this data was scraped (ISO date) | #### Example Output ```json { "listingId": "738646", "url": "https://www.homeless.co.il/rent/viewad,738646.aspx", "dealType": "rent", "propertyType": "דירה", "city": "Tel Aviv", "cityHebrew": "תל אביב יפו", "neighbourhood": "נווה שרת", "address": "דרך נמיר", "price": 6500, "currency": "ILS", "rooms": 4, "floor": "3", "areaSqm": 95, "hasElevator": true, "hasParking": false, "hasBalcony": true, "hasSecureRoom": true, "hasAC": true, "isFurnished": false, "isRenovated": false, "images": [ "https://uploads.homeless.co.il/rent/202604/1200/nvFile5230481.jpg" ], "coverImage": "https://uploads.homeless.co.il/rent/202604/300/nvFile5230481.jpg", "listingDescription": "דירת 4 חדרים מרווחת בנווה שרת, קומה 3 עם מעלית. סלון גדול, מטבח מאובזר, ממ\"ד, מרפסת שמש. קרוב לתחבורה ציבורית ולפארק הירקון.", "contactName": "דוד", "contactPhone": "052-1234567", "entryDate": "מיידי", "updatedAt": "2026-04-10", "scrapedAt": "2026-04-10T21:01:23.000Z" } ``` ### Also Available - [Yad2.co.il Real Estate Scraper](https://apify.com/swerve/yad2-scraper) — Israel's #1 classifieds, 800+ listings per city - [Madlan.co.il Real Estate Scraper](https://apify.com/swerve/madlan-scraper) — Israel's largest property data platform - [Madlan.co.il Market Analytics](https://apify.com/swerve/madlan-analytics) — neighborhood-level market data, demographics, and insights ### Supported Cities (127+) Use English or Hebrew names. Partial names work too. Use `"all"` to scrape every city. **Major Cities:** Tel Aviv (תל אביב), Jerusalem (ירושלים), Haifa (חיפה), Beer Sheva (באר שבע), Rishon Lezion (ראשון לציון), Petah Tikva (פתח תקווה), Ashdod (אשדוד), Netanya (נתניה), Ashkelon (אשקלון), Holon (חולון), Ramat Gan (רמת גן), Bat Yam (בת ים), Rehovot (רחובות), Modiin (מודיעין), Bnei Brak (בני ברק) **Sharon & Center:** Raanana (רעננה), Herzliya (הרצליה), Kfar Saba (כפר סבא), Hod Hasharon (הוד השרון), Ramat Hasharon (רמת השרון), Givatayim (גבעתיים), Nes Ziona (נס ציונה), Rosh Haayin (ראש העין), Hadera (חדרה), Pardes Hana Karkur (פרדס חנה-כרכור) **North:** Nazareth (נצרת), Nof Hagalil (נוף הגליל), Tiberias (טבריה), Akko (עכו), Nahariya (נהריה), Carmiel (כרמיאל), Afula (עפולה), Kiryat Ata (קריית אתא), Kiryat Bialik (קריית ביאליק) **South:** Eilat (אילת), Kiryat Gat (קריית גת), Arad (ערד), Dimona (דימונה), Sderot (שדרות) # Actor input Schema ## `city` (type: `string`): City name in Hebrew or English (e.g. 'Tel Aviv', 'תל אביב', 'Haifa', 'Jerusalem'). Comma-separated for multiple cities, or 'all' for all cities. ## `dealType` (type: `string`): Type of listing to scrape ## `maxItems` (type: `integer`): Maximum listings per city. Tel Aviv has ~165 rental listings. ## `minPrice` (type: `integer`): Minimum price filter in ILS (optional) ## `maxPrice` (type: `integer`): Maximum price filter in ILS (optional) ## `minRooms` (type: `number`): Minimum number of rooms (optional) ## `maxRooms` (type: `number`): Maximum number of rooms (optional) ## `neighbourhood` (type: `string`): Filter by neighbourhood or street name in Hebrew (e.g. נווה צדק, הצפון הישן). Matches against neighbourhood and street fields. ## `enrichListings` (type: `boolean`): Fetch additional detail data for each listing (full description, amenities, area sqm, contact info). Takes longer but provides richer data. ## `proxyConfig` (type: `object`): Residential proxy recommended for Cloudflare bypass. Uses Apify residential proxy by default. ## Actor input object example ```json { "city": "Tel Aviv", "dealType": "rent", "maxItems": 200, "enrichListings": false } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "city": "Tel Aviv" }; // Run the Actor and wait for it to finish const run = await client.actor("swerve/homeless-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "city": "Tel Aviv" } # Run the Actor and wait for it to finish run = client.actor("swerve/homeless-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "city": "Tel Aviv" }' | apify call swerve/homeless-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=swerve/homeless-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Homeless.co.il Real Estate Scraper", "description": "Scrape real estate listings (rent & buy) from Homeless.co.il, one of Israel's oldest and largest classifieds boards. Listings include price, rooms, area, amenities, images, descriptions, and contact info across 127+ Israeli cities.", "version": "1.0", "x-build-id": "n7R5X4bBUmX5I1fhj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/swerve~homeless-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-swerve-homeless-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/swerve~homeless-scraper/runs": { "post": { "operationId": "runs-sync-swerve-homeless-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/swerve~homeless-scraper/run-sync": { "post": { "operationId": "run-sync-swerve-homeless-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": [ "city", "dealType" ], "properties": { "city": { "title": "City", "type": "string", "description": "City name in Hebrew or English (e.g. 'Tel Aviv', 'תל אביב', 'Haifa', 'Jerusalem'). Comma-separated for multiple cities, or 'all' for all cities." }, "dealType": { "title": "Deal Type", "enum": [ "rent", "buy" ], "type": "string", "description": "Type of listing to scrape", "default": "rent" }, "maxItems": { "title": "Max Listings Per City", "minimum": 1, "type": "integer", "description": "Maximum listings per city. Tel Aviv has ~165 rental listings.", "default": 200 }, "minPrice": { "title": "Min Price (₪)", "type": "integer", "description": "Minimum price filter in ILS (optional)" }, "maxPrice": { "title": "Max Price (₪)", "type": "integer", "description": "Maximum price filter in ILS (optional)" }, "minRooms": { "title": "Min Rooms", "type": "number", "description": "Minimum number of rooms (optional)" }, "maxRooms": { "title": "Max Rooms", "type": "number", "description": "Maximum number of rooms (optional)" }, "neighbourhood": { "title": "Neighbourhood / Street (שכונה / רחוב)", "type": "string", "description": "Filter by neighbourhood or street name in Hebrew (e.g. נווה צדק, הצפון הישן). Matches against neighbourhood and street fields." }, "enrichListings": { "title": "Enrich Listing Details", "type": "boolean", "description": "Fetch additional detail data for each listing (full description, amenities, area sqm, contact info). Takes longer but provides richer data.", "default": false }, "proxyConfig": { "title": "Proxy Configuration", "type": "object", "description": "Residential proxy recommended for Cloudflare bypass. Uses Apify residential proxy by default." } } }, "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 } } } } } } } } } } ```