# Yad2 Real Estate Listings Scraper

> Yad2 Real Estate Listings Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-02).

Fetches structured development property listings from Yad2 (Israel's major real estate platform) filtered by city, price, rooms, and amenities

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/yad2?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yad2-real-estate-listings-scraper-5678477d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TUmfDVzrT5k1s9Piq3tqd

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability yad2-real-estate-listings-scraper-5678477d -d '<json body>'
```

Example prompt: Search Yad2 for apartments for sale in Tel Aviv, between 2 and 4 rooms, priced between 1,500,000 and 3,000,000 ILS, and only show listings that have both parking and a balcony — give me up to 50 results.

## When to prefer this

Use this endpoint when you need structured, filterable property listing data from Yad2 — Israel's dominant real estate portal — especially for development listings, and when you want pay-per-call pricing with no charge on failed or empty runs. Prefer this over generic web scrapers when you need pre-parsed fields like listing ID, deal type, and amenity flags without writing custom extraction logic.

## Known failure modes

- Unsupported city name (only numeric city codes, search URLs containing city=, or 'Tel Aviv' are accepted — other names return no results)
- Sparse or empty result set when searching rental (rent) listings due to limited inventory on that feed
- Exceeding maxPages cap before reaching maxItems, causing fewer results than expected
- Invalid or non-existent region code returning empty feed
- Network or scraping timeout from Yad2 upstream returning an error response

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object containing a count of matched listings and an array of listing items, each with fields including listing ID, URL, city, Hebrew city name, ad type, deal type, agent flag, and property type. Failed or empty runs are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "city": {
   "type": "string",
   "default": "Tel Aviv",
   "description": "Numeric city code, a search URL containing city=, or Tel Aviv. Other city names are not resolved."
  },
  "region": {
   "type": "integer",
   "description": "Optional numeric region code for the listing feed. Tel Aviv uses region 3 automatically."
  },
  "dealType": {
   "enum": [
    "buy",
    "rent"
   ],
   "type": "string",
   "default": "buy",
   "description": "Sale or rental development listings; rent inventory can be sparse."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum matching development listings; 0 means no item cap."
  },
  "maxPages": {
   "type": "integer",
   "default": 20,
   "minimum": 1,
   "description": "Maximum feed pages to inspect (20 listings per page in the observed response)."
  },
  "maxPrice": {
   "type": "integer",
   "description": "Maximum asking price in ILS."
  },
  "maxRooms": {
   "type": "number",
   "description": "Maximum number of rooms."
  },
  "minPrice": {
   "type": "integer",
   "description": "Minimum asking price in ILS."
  },
  "minRooms": {
   "type": "number",
   "description": "Minimum number of rooms."
  },
  "neighbourhood": {
   "type": "string",
   "description": "Keep listings whose neighbourhood, street, or address includes this text."
  },
  "requireBalcony": {
   "type": "boolean",
   "default": false,
   "description": "Keep only listings explicitly marked as having a balcony."
  },
  "requireParking": {
   "type": "boolean",
   "default": false,
   "description": "Keep only listings explicitly marked as having parking."
  },
  "requireElevator": {
   "type": "boolean",
   "default": false,
   "description": "Keep only listings explicitly marked as having an elevator."
  },
  "requireSecureRoom": {
   "type": "boolean",
   "default": false,
   "description": "Keep only listings explicitly marked as having a secure room."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "url": null,
    "city": null,
    "adType": null,
    "dealType": null,
    "hasAgent": null,
    "listingId": null,
    "cityHebrew": null,
    "propertyType": null
   }
  ],
  "product": "yad2"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yad2-real-estate-listings-scraper-5678477d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)