yad2.co.il APIyad2.co.il ↗
Access Yad2 apartment and car listings via API. Search rentals, sales, and vehicles with filters. Retrieve full details and reveal seller contact info.
curl -X GET 'https://api.parse.bot/scraper/665f0deb-f68c-43a6-a1b2-b66e972e5888/search_apartments_for_rent?city=5000&price_max=8000' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for apartments for rent on Yad2 with optional filters. Returns a list of rental listings matching the criteria.
| Param | Type | Description |
|---|---|---|
| city | string | City ID (e.g. 5000 for Tel Aviv). |
| price_max | integer | Maximum monthly rent in ILS. |
| price_min | integer | Minimum monthly rent in ILS. |
| rooms_max | number | Maximum number of rooms (supports half-rooms, e.g. 4.5). |
| rooms_min | number | Minimum number of rooms (supports half-rooms, e.g. 2.5). |
{
"type": "object",
"fields": {
"count": "integer total number of items returned",
"items": "array of rental listing objects with token, price, address, additionalDetails, metaData, tags"
},
"sample": {
"data": {
"count": 20,
"items": [
{
"price": 8000,
"token": "jhootgb9",
"adType": "private",
"address": {
"city": {
"text": "תל אביב יפו"
},
"house": {
"floor": 4,
"number": 36
},
"street": {
"text": "דפנה"
}
},
"additionalDetails": {
"property": {
"text": "דירה"
},
"roomsCount": 3.5,
"squareMeter": 130
}
}
]
},
"status": "success"
}
}About the yad2.co.il API
This API exposes 6 endpoints covering Yad2's real estate and vehicle marketplace, letting you search apartments for rent or sale, search used cars, and retrieve full listing details. The search_apartments_for_rent endpoint accepts city IDs and price/rooms filters and returns structured listing objects with address, price, and tags. A dedicated reveal_contact_phone endpoint returns the seller's name and phone number for any listing token across both real estate and vehicle categories.
Real Estate Endpoints
The search_apartments_for_rent and search_apartments_for_sale endpoints accept overlapping filter sets: a numeric city ID (e.g. 5000 for Tel Aviv), price_min/price_max in ILS, and rooms_min/rooms_max with half-room precision (e.g. 2.5, 4.5). Both return a count and an items array where each object includes a token, price, address, additionalDetails, metaData, and tags. Use the token from these results to call get_apartment_listing_details, which returns the full record: address.coords, address.neighborhood, metaData.images, metaData.description, additionalDetails.squareMeter, additionalDetails.propertyCondition, and additionalDetails.entranceDate.
Vehicle Endpoints
The search_cars endpoint filters by manufacturer (numeric ID, e.g. 21 for Toyota), model (numeric ID), city, price range, and manufacturing year. Year filtering requires both year_min and year_max to be supplied together. Each result item carries token, price, manufacturer, model, vehicleDates, address, metaData, and tags. Calling get_car_listing_details with a token returns deeper specs: km (odometer reading), gearBox, engineType, color, vehicleDates.testDate, and a specification object covering safety features such as airBags and abs.
Contact Reveal
The reveal_contact_phone endpoint takes a listing token and a category value of either realestate or vehicles. It returns the contact's name, phone, and integer id. Real estate responses may include a brokerPhone field; vehicle responses may include an isVirtualPhoneNumber flag. This endpoint works against any token returned by the four search and detail endpoints.
- Build a rental price tracker that monitors ILS rent changes for a specific city ID over time using
search_apartments_for_rent - Aggregate for-sale listings by neighborhood using the
address.neighborhoodfield fromget_apartment_listing_details - Filter used cars by manufacturer and year range with
search_carsto power an inventory comparison tool - Pull full vehicle specs including mileage and safety features from
get_car_listing_detailsfor a car-buying decision tool - Automate lead generation for real estate agents by surfacing new listings and resolving seller phone numbers via
reveal_contact_phone - Cross-reference apartment floor area (
additionalDetails.squareMeter) and price to compute per-sqm costs across cities - Monitor listing freshness using
dates.createdAtanddates.updatedAtfromget_apartment_listing_detailsto detect newly added or recently updated properties
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Yad2 offer an official developer API?+
How does the city filter work, and where do I get valid city IDs?+
city parameter in all search endpoints accepts a numeric string ID. For example, 5000 corresponds to Tel Aviv. Yad2 uses its own internal city taxonomy, so you need to know the numeric ID for the city you want to query. The API does not currently expose a city-lookup or autocomplete endpoint. You can fork this API on Parse and revise it to add a city reference endpoint.Does the API return pagination or only the first page of results?+
count field indicating total matches, but the current endpoints do not expose a page or offset parameter. Only one page of results is returned per call. You can fork this API on Parse and revise it to add pagination parameters if deeper result sets are needed.Does `get_car_listing_details` cover commercial vehicles or motorcycles?+
search_cars. Commercial vehicles, motorcycles, and other vehicle categories are not covered by the existing endpoints. You can fork this API on Parse and revise it to add endpoints targeting those additional vehicle categories.What does the `reveal_contact_phone` endpoint return differently for real estate versus vehicle listings?+
id, name, and phone. When category is realestate, the response may include a brokerPhone field for agent-mediated listings. When category is vehicles, the response may include an isVirtualPhoneNumber boolean indicating whether the displayed number is a forwarding number rather than the seller's direct line.