# Homeless.co.il - Israel Real Estate (`swerve/homeless-scraper`) Actor

Scrape Homeless.co.il, one of Israel's oldest classifieds platforms. Real estate rent & buy listings across 127+ cities with prices, rooms, amenities, photos, and contact info.

- **URL**: https://apify.com/swerve/homeless-scraper.md
- **Developed by:** [Swerve](https://apify.com/swerve) (community)
- **Categories:** Real estate, Automation, Lead generation
- **Stats:** 10 total users, 5 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

### Use Cases

- **Real estate investors** diversifying deal sources beyond Yad2 to catch Homeless-exclusive private-owner listings in Tel Aviv, Ramat Gan, and Givatayim
- **Student housing platforms** monitoring affordable shared apartments and small units that Homeless's older audience frequently posts
- **Property managers** tracking rental market depth by combining Homeless data with Yad2 and Madlan feeds for a complete picture
- **Data aggregators** building a unified Israeli real estate dataset across all major classifieds sites (Yad2, Madlan, Homeless)
- **Price comparison tools** spotting the same listing across multiple sites to flag desperation pricing when sellers post everywhere
- **Local relocation services** helping renters find move-in-ready apartments filtered by furnished/renovated/AC status

### 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 (שדרות)

### Keywords

Homeless.co.il scraper, Israeli classifieds scraper, Israel real estate API, Tel Aviv apartments data, Hebrew property listings, Israel rental scraper, homeless scraper, Israeli housing listings, Jerusalem apartment data, Ramat Gan rentals, Israel property classifieds, private owner listings Israel

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# 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 <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Homeless.co.il - Israel Real Estate",
        "description": "Scrape Homeless.co.il, one of Israel's oldest classifieds platforms. Real estate rent & buy listings across 127+ cities with prices, rooms, amenities, photos, and contact info.",
        "version": "1.0",
        "x-build-id": "c5F6Kdn5RBjaYUWqs"
    },
    "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
