Co APIyad2.co.il ↗
Search and retrieve Yad2 apartment rentals, sales, and car listings. Filter by price, rooms, year, and location. Reveal seller contact details per listing.
What is the Co API?
The Yad2 API provides 6 endpoints covering Israel's largest classifieds marketplace, exposing apartment rental and sale listings, car listings, and seller contact details. search_cars returns paginated results with manufacturer, model, year, price, and engine type, while get_apartment_listing_details delivers full property data including room count, square meters, coordinates, and entrance date for any listing token.
curl -X GET 'https://api.parse.bot/scraper/665f0deb-f68c-43a6-a1b2-b66e972e5888/search_apartments_for_rent?page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for apartments for rent on Yad2. Returns ONE page of rental listings per call: the site's private and agency listings for that page (about 40 per page, fewer on the last page) plus the promoted listings the site shows alongside them (platinum and booster, which can repeat listings that also appear in the regular pages). pagination.total is the site's total count of matching listings and pagination.totalPages the number of pages; to obtain all matching listings call the endpoint once for every page from 1 to pagination.totalPages (page beyond totalPages returns an empty items list). Yad2 organises listings into 8 search regions and every city belongs to exactly one of them. When city is given, the city's region is resolved automatically: the given region (if any) is tried first, then the remaining regions in turn (up to 8 upstream requests; a city with no listings anywhere costs all 8 and returns an empty items list), so a city paired with the wrong region still returns that city's listings. Without city, region restricts results to that region and defaults to region 1 (Center & Sharon); the site has no nationwide search, so a search without city covers a single region. Supports filtering by price range and room count, applied by the site. Each item's address.region.id reports the region actually matched.
| Param | Type | Description |
|---|---|---|
| city | string | Yad2 city ID as a numeric string (e.g. 6600 for Holon, 5000 for Tel Aviv, 0070 for Ashdod). Site IDs are 4-digit zero-padded; a shorter value such as 70 is padded to 0070 (Ashdod) automatically. Non-numeric values are rejected. |
| page | integer | Result page number, 1-based. Each page holds about 40 listings; valid pages run from 1 to pagination.totalPages of any response for the same filters. |
| region | string | Yad2 search region ID, 1-8 (1 Center & Sharon, 2 South, 3 Tel Aviv & surroundings, 4 Judea/Samaria/Jordan Valley, 5 Northern coastal plain, 6 Jerusalem & surroundings, 7 North & valleys, 8 Jerusalem). Without city it restricts results to that region; with city it is the first region tried, and other regions are checked if it yields nothing. Other values are rejected. |
| 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 number of items returned on this page (regular plus promoted listings)",
"items": "array of rental listing objects (private, agency, platinum and booster buckets) with token, adType, price, address (region, city, area, neighborhood, street, house, coords), additionalDetails, metaData, tags",
"pagination": "object with total (site's total matching listings) and totalPages (number of pages to iterate)"
},
"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 Co API
Real Estate Endpoints
search_apartments_for_rent and search_apartments_for_sale both return paginated arrays of listing objects scoped to a region (default: Center, region 1). Each item includes a token, price in ILS, an address object with city and neighborhood, additionalDetails with room count and square meters, metaData, and tags. Filter results with city (e.g. 5000 for Tel Aviv), price_min/price_max, and rooms_min/rooms_max — the latter supports half-room increments such as 2.5 or 4.5. The pagination object in each response carries total and totalPages so you can walk through the full result set with the page parameter.
get_apartment_listing_details accepts the 8-character alphanumeric token from any search result and returns the complete listing record: address with street-level coordinates (coords), additionalDetails covering roomsCount, squareMeter, property, propertyCondition, and entranceDate, plus a dates object with createdAt, updatedAt, and endsAt timestamps.
Vehicle Endpoints
search_cars returns up to 40 items per page. Each item exposes manufacturer, model, price, hand (ownership history), engineType, vehicleDates, and geographic address. Filter by manufacturer ID (e.g. 21 for Hyundai), model ID, year_min/year_max, price_min/price_max, and area. get_car_listing_details takes a listing token and returns km (odometer), color, gearBox, engineType, full address, and a metaData object that includes a coverImage, an images array, and a text description.
Contact Reveal
reveal_contact_phone takes a listing token and a category value of either realestate or vehicles and returns the seller's name and phone number. For dealer listings it also returns agencyName and agencyLogo. The isVirtualPhoneNumber boolean indicates whether the number is a forwarding line rather than a direct contact.
The Co API is a managed, monitored endpoint for yad2.co.il — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when yad2.co.il changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official yad2.co.il API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a Tel Aviv rental price tracker by querying search_apartments_for_rent with city=5000 and storing price per square meter over time.
- Aggregate Yad2 car listings by manufacturer and year to generate used-car market price distributions in Israel.
- Create a listing alert service that polls search_apartments_for_sale for new tokens matching a room count and budget range.
- Populate a CRM with seller contact details by calling reveal_contact_phone after each new listing token is discovered.
- Compare property entrance dates and listing durations using the createdAt and endsAt fields from get_apartment_listing_details.
- Build a neighborhood-level real estate dashboard by grouping listing coordinates from the address.coords field.
- Monitor specific car models for price drops by periodically fetching get_car_listing_details for tracked tokens.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.