# Yad2 Vehicles - Israel Car Listings (`swerve/yad2-vehicles`) Actor

Used by Israeli used-car dealerships monitoring competitor inventory, insurance teams pricing risk by make and model, fleet operators tracking resale values, and arbitrage traders scanning for underpriced vehicles. Returns make, model, year, price, mileage, photos, and seller contact info.

- **URL**: https://apify.com/swerve/yad2-vehicles.md
- **Developed by:** [Swerve](https://apify.com/swerve) (community)
- **Categories:** E-commerce, Automation, Lead generation
- **Stats:** 81 total users, 10 monthly users, 95.3% runs succeeded, 0 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Yad2.co.il Vehicle Scraper

Scrape vehicle listings (cars, motorcycles, scooters) from [Yad2.co.il](https://www.yad2.co.il), Israel's #1 classifieds platform. Fast, reliable, and feature-rich.

### Why This Scraper?

- **Full detail enrichment** - every listing includes km, color, gearBox, horsePower, seats, doors, bodyType, city, description, test date, and more
- **50+ manufacturers** - server-side filtering for Toyota, Hyundai, Kia, Tesla, BMW, Mercedes, BYD, and dozens more
- **Model filtering** - narrow down to a specific model (e.g. "Corolla", "Tucson", "Model 3")
- **City & area filtering** - search by any Israeli city name or by region (Tel Aviv, Jerusalem, Haifa, Center, Sharon, Shfela, South, North)
- **Agent detection** - each listing tagged with `isAgent: true/false`
- **Works out of the box** - no proxy configuration needed

### Use Cases

- **Car dealerships and leasing companies** tracking market inventory, competitor pricing, and trade-in benchmarks for Toyota Corolla, Hyundai Tucson, and Kia Sportage in Israel
- **Used-car arbitrage traders** scanning for underpriced vehicles (low km, first hand, private sellers) across Tel Aviv, Sharon, and Center regions
- **Insurance and valuation platforms** building Israeli used-car pricing models with manufacturer, year, km, and condition data points
- **Fleet managers** monitoring resale values for cars and commercial vehicles to optimize lease-end disposition and replacement timing
- **Auto journalists and market analysts** tracking the Israeli EV transition - Tesla, BYD, and Chinese brand inventory growth week over week
- **Mechanics and importers** sourcing vehicles for refurbishment, parts harvesting, or export based on test-expiry dates and condition signals

### Input

| Field | Type | Description |
|-------|------|-------------|
| `vehicleType` | string | `"cars"`, `"motorcycles"`, `"scooters"`, or `"all"` (default: `"cars"`) |
| `maxItems` | integer | Max listings to return (default 200, max 1000) |
| `manufacturer` | string | Filter by manufacturer - English or Hebrew (e.g. `"Toyota"`, `"טויוטה"`) |
| `model` | string | Filter by model name (e.g. `"Corolla"`, `"Tucson"`) |
| `city` | string | Filter by Israeli city - English or Hebrew (e.g. `"Raanana"`, `"רעננה"`) |
| `area` | string | Filter by region: `"Tel Aviv"`, `"Jerusalem"`, `"Haifa"`, `"Center"`, `"Sharon"`, `"Shfela"`, `"South"`, `"North"` |
| `minPrice` | integer | Min price in ILS (optional) |
| `maxPrice` | integer | Max price in ILS (optional) |
| `minYear` | integer | Min year of production (optional) |
| `maxYear` | integer | Max year of production (optional) |
| `maxKm` | integer | Max kilometers driven (optional) |
| `maxHand` | integer | Max previous owners - 1 = first hand only (optional) |
| `excludeAgents` | boolean | Only private sellers, exclude dealers (default: false) |

#### Example Input

```json
{
  "vehicleType": "cars",
  "manufacturer": "Toyota",
  "model": "Corolla",
  "city": "Raanana",
  "maxItems": 100,
  "minYear": 2020,
  "maxKm": 80000
}
```

### Output

Results are sorted by most recent first. Each listing includes:

| Field | Description |
|-------|-------------|
| `listingId` | Unique Yad2 listing ID |
| `url` | Direct link to the listing |
| `vehicleType` | `"cars"`, `"motorcycles"`, or `"scooters"` |
| `adType` | Listing type (e.g. `"ad"`) |
| `isAgent` | `true` (dealer) or `false` (private seller) |
| `manufacturer`, `manufacturerEn` | Manufacturer in Hebrew and English |
| `model`, `modelEn` | Model in Hebrew and English |
| `subModel` | Sub-model / trim level |
| `year` | Year of production |
| `km` | Kilometers driven |
| `hand` | Number of previous owners |
| `color`, `colorEn` | Color in Hebrew and English |
| `engineVolume` | Engine volume in cc |
| `horsePower` | Horse power |
| `gearBox` | Transmission type (e.g. `"אוטומט"`) |
| `engineType` | Fuel type (e.g. `"בנזין"`, `"היברידי"`) |
| `seats` | Number of seats |
| `doors` | Number of doors |
| `bodyType` | Body type (e.g. `"סדאן"`, `"קרוסאובר"`) |
| `city`, `cityEn` | City in Hebrew and English |
| `area`, `areaEn` | Region in Hebrew and English |
| `price` | Price in ILS |
| `currency` | Currency code |
| `images` | Array of image URLs |
| `coverImage` | Main image URL |
| `listingDescription` | Full listing text |
| `testDate` | Vehicle test expiry date |
| `updatedAt` | When the listing was last updated |
| `scrapedAt` | When the data was retrieved |

Motorcycle/scooter-specific: `motorcycleType`, `licenseType`.

#### Example Output

```json
{
  "listingId": "gludk5",
  "url": "https://www.yad2.co.il/vehicles/item/gludk5",
  "vehicleType": "cars",
  "adType": "ad",
  "isAgent": false,
  "manufacturer": "טויוטה",
  "manufacturerEn": "Toyota",
  "model": "קורולה",
  "modelEn": "Corolla",
  "subModel": "GLI Premium",
  "year": 2021,
  "km": 42000,
  "hand": 2,
  "color": "לבן",
  "colorEn": "White",
  "engineVolume": 1597,
  "horsePower": 122,
  "gearBox": "אוטומט",
  "engineType": "בנזין",
  "seats": 5,
  "doors": 4,
  "bodyType": "סדאן",
  "city": "רעננה",
  "cityEn": "Raanana",
  "area": "שרון",
  "areaEn": "Sharon",
  "price": 119000,
  "currency": "ILS",
  "images": [
    "https://img.yad2.co.il/Pic/202501/28/2_3/o/y2_1pa_010725_20250128140318.jpeg",
    "https://img.yad2.co.il/Pic/202501/28/2_3/o/y2_1pa_010725_20250128140319.jpeg"
  ],
  "coverImage": "https://img.yad2.co.il/Pic/202501/28/2_3/o/y2_1pa_010725_20250128140318.jpeg",
  "listingDescription": "רכב שמור במצב מצוין, יד שנייה, טסט חדש. שירות מלא בהסדר.",
  "testDate": "2026-01-15",
  "updatedAt": "2026-03-25T10:30:00.000Z",
  "scrapedAt": "2026-03-26T08:15:22.431Z"
}
```

### How it works

This scraper reads from Yad2's own vehicle feed for the core listing data (make, model, year, price, mileage, hand), then enriches each vehicle with its full spec sheet - engine, gearbox, color, seats, test date, and more. Yad2 blocks datacenter traffic, so every request goes through Israeli residential IPs with a real browser fingerprint and a fresh session per retry, keeping runs reliable.

Results are written to the dataset incrementally in chunks, so a long run never loses what it already collected. There are no hidden caps: leave `maxItems` blank and it scrapes every matching listing.

### Supported Manufacturers

All major brands available in the Israeli market are supported. Use English or Hebrew names.

**Popular**: Toyota, Hyundai, Kia, Mazda, Honda, Nissan, Suzuki, Subaru, Volkswagen, Skoda, Tesla, BYD

**European**: BMW, Mercedes, Audi, Volvo, Peugeot, Citroen, Renault, Fiat, Opel, Seat, Porsche, Jaguar, Land Rover, Alfa Romeo, Mini, Cupra

**American**: Ford, Chevrolet, Jeep, Chrysler, Dodge, Cadillac, Lincoln, Buick

**Chinese**: BYD, Geely, Chery, GWM, Maxus, Voyah, Zeekr

**Luxury**: Lexus, Infiniti, Maserati, Lamborghini, Ferrari, Bentley, Rolls Royce, Aston Martin

### Also Available

- [Yad2.co.il Real Estate Scraper](https://apify.com/swerve/yad2-scraper) - scrape rent & buy listings from Yad2
- [Madlan.co.il Real Estate Scraper](https://apify.com/swerve/madlan-scraper) - scrape Israel's largest property listing site

### Keywords

Yad2 cars scraper, Israeli used car API, Israel vehicle listings, Toyota Corolla Israel price, Yad2 vehicles API, Israeli car market data, used car scraper Israel, Yad2 motorcycles, Tesla Israel listings, Israeli car dealership data, yad2.co.il vehicles, Hebrew car listings scraper

# Actor input Schema

## `vehicleType` (type: `string`):

Type of vehicle to scrape

## `maxItems` (type: `integer`):

Optional cap on results. Leave blank to scrape ALL matching results (recommended); set a number only to limit cost.

## `minPrice` (type: `integer`):

Minimum price filter in ILS (optional)

## `maxPrice` (type: `integer`):

Maximum price filter in ILS (optional)

## `minYear` (type: `integer`):

Minimum year of production (optional)

## `maxYear` (type: `integer`):

Maximum year of production (optional)

## `maxKm` (type: `integer`):

Maximum km driven (optional)

## `maxHand` (type: `integer`):

Maximum number of previous owners (1 = first hand only, 2 = up to second hand, etc.)

## `manufacturer` (type: `string`):

Filter by manufacturer name (Hebrew or English, e.g. 'Toyota' or 'טויוטה'). Uses server-side filtering when possible. Leave empty for all.

## `model` (type: `string`):

Filter by model name (e.g. 'Corolla', 'קורולה'). Client-side filter.

## `city` (type: `string`):

Filter by city name in Hebrew or English (e.g. 'רעננה', 'תל אביב', 'Tel Aviv'). Returns only listings from this specific city.

## `area` (type: `string`):

Filter by region. Returns listings from all cities in the selected area. Use 'city' for a specific city instead.

## `excludeAgents` (type: `boolean`):

Only return listings from private sellers (exclude commercial/dealer listings)

## `enrichDetails` (type: `boolean`):

On: also fetch each car's mileage, color, city, description, test date, and gearbox (one extra request per car, so large runs take longer). Off: return only the basics already in the listing feed (make, model, year, price, previous owners, engine, photos, area) and the dealer/private flag, which is much faster. Enabled by default.

## `cfWorkerUrl` (type: `string`):

URL of a CF Worker proxy to bypass Radware. Recommended for reliable scraping.

## `cfWorkerToken` (type: `string`):

Bearer token for CF Worker authentication (optional)

## `proxyConfig` (type: `object`):

Proxy configuration (optional). Yad2 APIs work without proxy from Apify infrastructure. Only enable if you experience blocks.

## Actor input object example

```json
{
  "vehicleType": "cars",
  "excludeAgents": false,
  "enrichDetails": true
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("swerve/yad2-vehicles").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("swerve/yad2-vehicles").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call swerve/yad2-vehicles --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,swerve/yad2-vehicles"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/wkStYrzSne06xQqAI/builds/xrhKpwn8rwqNzLiOY/openapi.json