# OcasionPlus Scraper - Spain Used Cars & Motorbikes (`normdata/ocasionplus-scraper`) Actor

Scrape used cars and motorbikes from OcasionPlus, a top Spanish dealer network. Get prices, financing, km, year, specs, dealer and photos, plus VIN, extras, full equipment, ITV and service history. Filter by brand, price, km, fuel, body, label and province. 1,000 cars in 3 seconds.

- **URL**: https://apify.com/normdata/ocasionplus-scraper.md
- **Developed by:** [Norm Data](https://apify.com/normdata) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 vehicles

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

![Norm Data](https://raw.githubusercontent.com/FabriAV/normdata/refs/heads/main/assets/banner_norm2.png)

## 🚗 OcasionPlus Scraper - Spain Used Cars & Motorbikes

Extract used cars and motorbikes from **OcasionPlus (ocasionplus.com)**, one of Spain's largest used-car dealer networks, with about 14,000 vehicles in stock across Spain and the Canary Islands. For each vehicle you get the **cash price, financed price, monthly payment, discounts, price without VAT, year, km, fuel, powertrain, gearbox, horsepower, body type, DGT label, plate, dealer with address and province**, and its photo. Turn on **car details** to also get the **VIN, full version, color, doors, seats, consumption, CO2, range, size, weight, trunk, top speed, extras, full equipment lists, ITV date, last service, every photo, the inspection report and service book, and the dealer's phone, WhatsApp, email, coordinates and opening hours**. It collects **1,000 cars in seconds** and can run on a schedule to send you **only new cars**.

### 🎯 Who uses it?

#### 🏪 Car dealers and traders

Track what OcasionPlus is selling, at what price and km, so you can price your own stock and spot cars to buy.

#### 📊 Market and pricing analysts

Build used-car price models for Spain by brand, model, year, km, fuel and province, with financed and cash prices side by side.

#### 🏦 Leasing, finance and insurance teams

Compare cash and financed prices, monthly payments and loan terms, and check VINs, ITV dates and service history.

#### 🔔 Car buyers and resellers

Get a daily list of new arrivals or price drops for the cars you want.

### ✨ What it does

- **Cars, motorbikes or both.** Every vehicle OcasionPlus lists, from Spain's mainland, the Balearics and the Canary Islands.
- **Sort like on the site.** Most relevant, newest, cheapest, most expensive, lowest monthly payment, lowest km, newest year, most powerful and more.
- **Many filters.** Brand, model, province, city or dealer, price, monthly payment, year, km, horsepower, fuel, powertrain, gearbox, body type, DGT label, condition (used, km 0, new), listed since, and only available, single owner, official warranty, VAT deductible, discounted, price dropped or 48-hour delivery.
- **Car details add-on:** opens each car page for the VIN, version, specs, extras, equipment, ITV, service history, every photo and the dealer contacts. Color, seats, 4x4, Carfax and service book filters use it too.
- **Or paste links.** Car pages, or listings like `/coches-segunda-mano/audi` or `/coches-segunda-mano/bmw/serie-3` (with their sort and page). Filters are not used with links.
- **Monitoring:** run it on a schedule with **Only new cars**, and each run saves only the vehicles you haven't received yet.

### 🏆 Why this scraper

- **Fast.** 1,000 cars in about 3 seconds, or about 15 seconds with car details.
- **Clean, typed data.** Prices, km, horsepower, sizes and consumption are numbers. Dates are `YYYY-MM-DD`. Fuel, body type, color and status are in English. Phones are in international format (+34...).
- **Financing in its own fields.** Cash price, financed price, financing discount, monthly payment and maximum term.
- **Everything the site shows on a car page.** VIN, equipment by group, ITV, last service with its km, warranty, inspection report and 360° view.
- **Nothing to set up.** No proxy, no login.

### 📦 What data you get

| Field | Description |
| --- | --- |
| `imageUrl` | Main photo. |
| `title` | Make, model and version as shown on the site. |
| `brand`, `model` | Brand and model. |
| `version` | *(Car details)* Full version name. |
| `vehicleType` | Car or Motorbike. |
| `condition` | Used, Km 0 or New. |
| `status` | Available or Reserved (a buyer has put down a deposit). |
| `price` | Cash price in euros. |
| `priceFinanced`, `financingDiscount` | Price when financed through the dealer, and the financing discount. |
| `totalDiscount`, `totalDiscountPercent` | Total discount in euros and percent. |
| `monthlyPayment`, `maxFinancingMonths` | Estimated monthly payment and the longest financing term in months. |
| `priceWithoutVat`, `vatDeductiblePercent` | Price without VAT and the deductible VAT percent, for cars sold with deductible VAT. |
| `newPrice`, `savingVsNew` | *(Car details)* Price of the same car new, and the saving against it. |
| `currency` | Always EUR. |
| `year` | First registration year. |
| `km` | Kilometers driven. |
| `fuel` | Petrol, Diesel, Hybrid, Plug-in hybrid, Electric, LPG or CNG. |
| `secondaryFuel` | *(Car details)* Second fuel of hybrids. |
| `powertrain` | Combustion, Mild hybrid, Full hybrid, Plug-in hybrid or Electric. |
| `transmission` | Manual or Automatic. |
| `gears` | *(Car details)* Number of gears. |
| `horsepower` | Engine power in CV. |
| `engineCc` | *(Car details)* Engine size in cc. |
| `bodyType` | Body type, like SUV, Hatchback or Van (Trail, Naked or Scooter for motorbikes). |
| `color`, `doors`, `seats` | *(Car details)* Color, doors and seats. |
| `environmentalLabel` | Spanish DGT environmental label: 0, ECO, C or B. |
| `keys` | *(Car details)* Number of keys. |
| `plate` | Number plate. |
| `vin` | *(Car details)* Vehicle identification number. |
| `consumptionCombined`, `consumptionCity`, `consumptionHighway` | *(Car details)* Fuel use in liters per 100 km: combined, city and highway. |
| `co2Emissions` | *(Car details)* CO2 emissions in g/km. |
| `electricRangeKm`, `rangeKm` | *(Car details)* Electric range and total range in km. |
| `lengthMm`, `widthMm`, `heightMm`, `weightKg` | *(Car details)* Length, width and height in mm, and weight in kg. |
| `trunkLiters`, `fuelTankLiters` | *(Car details)* Trunk and fuel tank in liters. |
| `topSpeedKmh`, `acceleration0to100` | *(Car details)* Top speed in km/h and 0 to 100 km/h in seconds. |
| `lastServiceKm` | *(Car details)* Km at the last service. |
| `visits24h` | People who viewed the car in the last 24 hours. |
| `notes` | *(Car details)* Dealer's notes on the car, when there are any. |
| `market` | Peninsula and Balearics, or Canary Islands. |
| `dealerName`, `dealerAddress`, `dealerCity`, `dealerProvince`, `dealerPostalCode` | Dealer name, address, city, province and postal code. |
| `dealerPhone`, `dealerWhatsapp`, `dealerEmail` | *(Car details)* Dealer phone and WhatsApp (international format) and email. |
| `dealerLatitude`, `dealerLongitude` | *(Car details)* Dealer map position. |
| `id` | The site's car ID. |
| `singleOwner` | Had one owner. |
| `financingAvailable` | The dealer offers financing. |
| `delivery48h` | Delivered in 48 hours (empty for car links). |
| `metallicPaint` | *(Car details)* Metallic paint. |
| `fourWheelDrive` | *(Car details)* Four-wheel drive. |
| `imported` | *(Car details)* Imported (not first registered in Spain). |
| `hasCarfaxReport` | *(Car details)* Has a Carfax history report. |
| `hasServiceBook` | *(Car details)* Has a photo of its service book. |
| `url` | Link to the car page. |
| `inspectionReportUrl`, `serviceBookUrl`, `view360Url` | *(Car details)* Photo of the dealer's inspection report, the service book and the 360 view. |
| `dealerMapsUrl` | *(Car details)* Dealer on Google Maps. |
| `images` | *(Car details)* Every photo, full size. |
| `bodyTypes` | *(Car details)* Every body type the site gives the car. |
| `extras` | *(Car details)* Extras fitted (beyond the standard equipment), like "Bluetooth". |
| `equipmentExterior`, `equipmentInterior`, `equipmentComfort`, `equipmentSafety` | *(Car details)* Standard equipment: exterior, interior, comfort and safety (in Spanish). |
| `dealerHours` | *(Car details)* Dealer opening hours: `{day, opens, closes}`. |
| `registrationDate` | First registration date. |
| `itvValidUntil` | *(Car details)* ITV (MOT) valid until. |
| `officialWarrantyUntil` | Maker's warranty valid until. |
| `lastServiceDate` | *(Car details)* Date of the last service. |
| `lastPriceDropDate` | When the price was last lowered. |
| `listedAt` | When the car was put on sale. |
| `updatedAt` | *(Car details)* When the site last updated the car. |
| `scrapedAt` | When this row was saved. |
| `error` | Only present when a row failed. The fields that loaded are still there. |

Fields marked *Car details* only appear when that add-on is on.

#### Example row (trimmed)

```json
{
  "imageUrl": "https://img.ocasionplus.com/DTiIV5lctL6gkQ5QmRwdBCfbC8DlEI4P7NTU0AAtYlw/mobilex2ao_auto/aHR0cHM6Ly9mb3Rvcy5lc3RhdGljb3NtZi5jb20vZm90b3NfYW51bmNpb3MvMDAvMjAvNDEvNjMvMzQvNS94MDEuanBnPzE1MjkzMzIwMjQ5",
  "title": "Seat Ibiza 1.0 TSI Style XL (110 CV)",
  "brand": "Seat",
  "model": "Ibiza",
  "version": "Seat Ibiza 1.0 TSI Style XL (110 CV)",
  "vehicleType": "Car",
  "condition": "Used",
  "status": "Available",
  "price": 13880,
  "priceFinanced": 12619,
  "financingDiscount": 1261,
  "totalDiscount": 1261,
  "totalDiscountPercent": 9.09,
  "monthlyPayment": 200,
  "maxFinancingMonths": 120,
  "priceWithoutVat": 11472,
  "vatDeductiblePercent": 100,
  "currency": "EUR",
  "year": 2023,
  "km": 91072,
  "fuel": "Petrol",
  "powertrain": "Combustion",
  "transmission": "Manual",
  "gears": 6,
  "horsepower": 110,
  "engineCc": 999,
  "bodyType": "Hatchback",
  "color": "White",
  "doors": 5,
  "seats": 5,
  "environmentalLabel": "C",
  "keys": 2,
  "plate": "6370MFW",
  "vin": "VSSZZZKJ1PR102449",
  "consumptionCombined": 5.1,
  "consumptionCity": 5.8,
  "consumptionHighway": 4,
  "co2Emissions": 116,
  "rangeKm": 784,
  "lengthMm": 4059,
  "widthMm": 1780,
  "heightMm": 1444,
  "weightKg": 1169,
  "trunkLiters": 355,
  "fuelTankLiters": 40,
  "topSpeedKmh": 195,
  "acceleration0to100": 10.3,
  "lastServiceKm": 61107,
  "visits24h": 72,
  "market": "Peninsula and Balearics",
  "dealerName": "Ciudad Real - Valdepeñas",
  "dealerAddress": "Av. Francia, 48",
  "dealerCity": "Valdepeñas",
  "dealerProvince": "Ciudad Real",
  "dealerPostalCode": "13300",
  "dealerPhone": "+34926262749",
  "dealerWhatsapp": "+34663695693",
  "dealerEmail": "comercialvaldepenas@ocasionplus.com",
  "dealerLatitude": 38.763499,
  "dealerLongitude": -3.411283,
  "id": "a06bK00000af02XQAQ",
  "singleOwner": true,
  "financingAvailable": true,
  "delivery48h": false,
  "metallicPaint": false,
  "fourWheelDrive": false,
  "imported": false,
  "hasCarfaxReport": false,
  "hasServiceBook": true,
  "url": "https://www.ocasionplus.com/coches-segunda-mano/seat-ibiza-10-tsi-style-xl-con-91072km-2023-af02xqaq",
  "inspectionReportUrl": "https://img.ocasionplus.com/auAIKbDUgTZ8DwNzzGnCmH2Og0GO9Do2jyDPqs2FJfo/normal_auto/aHR0cHM6Ly9mb3Rvcy5lc3RhdGljb3NtZi5jb20vZm90b3NfYW51bmNpb3MvMDAvMjAvNDEvNjMvMzQvNS94MjQuanBnPzE1MjkzMzIwNTgy",
  "serviceBookUrl": "https://img.ocasionplus.com/-yvdf67jAeNY9qxzqZ71ZB-8oa0LlOP53cHRdjQnGlI/normal_auto/aHR0cHM6Ly9mb3Rvcy5lc3RhdGljb3NtZi5jb20vZm90b3NfYW51bmNpb3MvMDAvMjAvNDEvNjMvMzQvNS94MjIuanBnPzE1MjkzMzIwNTU4",
  "view360Url": "https://img.ocasionplus.com/Y6etpGEB1eNrCjhnnhS8MJ-SEY9icQ4g3OlrN4N2yH4/image_360_auto/aHR0cHM6Ly9mb3Rvcy5lc3RhdGljb3NtZi5jb20vZm90b3MvMDAvMjAvNDEvNjMvMzQvNS81NDg4Nzc1NTYuanBn",
  "dealerMapsUrl": "https://www.google.com/maps?cid=9700900661531564292",
  "images": [
    "https://img.ocasionplus.com/Qq2ceg2_PMrg-qNX7NtrUwgxyodm8rz2KAaErhemXJE/fullscreen_cover_top_auto/aHR0cHM6Ly9mb3Rvcy5lc3RhdGljb3NtZi5jb20vZm90b3NfYW51bmNpb3MvMDAvMjAvNDEvNjMvMzQvNS ...",
    "https://img.ocasionplus.com/e588dbC27a8B7qEAbRBqGLocZ2nB4WxulqXI8XkS-dg/fullscreen_cover_top_auto/aHR0cHM6Ly9mb3Rvcy5lc3RhdGljb3NtZi5jb20vZm90b3NfYW51bmNpb3MvMDAvMjAvNDEvNjMvMzQvNS ...",
    "https://img.ocasionplus.com/vk47h9gVByjN9yHa6-x_ob5hdE9K14nL-LrEk-OwcX8/fullscreen_cover_top_auto/aHR0cHM6Ly9mb3Rvcy5lc3RhdGljb3NtZi5jb20vZm90b3NfYW51bmNpb3MvMDAvMjAvNDEvNjMvMzQvNS ..."
  ],
  "bodyTypes": ["Hatchback"],
  "extras": ["Car Play", "Cámara de marcha atrás", "Faros delanteros led"],
  "equipmentExterior": [
    "Carrocería tipo berlina con portón con 5 puertas, batalla corta, volante al lado izquierdo, código de plataforma: MQB A0, carrocería & puertas (local): berlina con portón de 5 puertas",
    "Puerta conductor, trasera (lado conductor), pasajero y trasera (lado pasajero) con bisagras delanteras",
    "Retrovisor exterior del conductor y acompañante pintado con ajuste eléctrico desempañable con intermitente integrado"
  ],
  "equipmentInterior": ["Acabados de lujo: pomo de la palanca de cambios en aluminio y cuero", "Toma/s de 12v en los asientos delanteros", "Cinco plazas ( 2+3 )"],
  "equipmentComfort": ["Limitador de velocidad", "Elevalunas eléctricos delanteros y traseros con dos de ellos de un solo toque", "Dirección asistida eléctrica con endurecimiento progresivo s/velocidad"],
  "equipmentSafety": ["Cuatro frenos de disco siendo dos ventilados", "ABS", "Control electrónico de tracción"],
  "dealerHours": [{ "day": "Monday", "opens": "09:30", "closes": "14:15" }],
  "registrationDate": "2023-03-30",
  "itvValidUntil": "2027-03-30",
  "officialWarrantyUntil": "2028-03-29",
  "lastServiceDate": "2025-06-30",
  "listedAt": "2026-10-16",
  "updatedAt": "2026-10-18T01:01:14.670Z",
  "scrapedAt": "2026-10-18T07:14:04.123Z"
}
```

### 💡 Use cases

**Diesel and hybrid SUVs under 25,000 EUR, 2021 or newer, with details:**

```json
{
  "fuels": ["Diesel", "Hybrid"],
  "bodyTypes": ["SUV"],
  "maxPrice": 25000,
  "minYear": 2021,
  "includeDetails": true,
  "maxItems": 500
}
```

**BMW Serie 3 and Audi A4 in Madrid and Barcelona:**

```json
{
  "brands": ["BMW", "Audi"],
  "models": ["Serie 3", "A4"],
  "locations": ["Madrid", "Barcelona"]
}
```

**Electric cars with the 0 label, cheapest monthly payment first:**

```json
{
  "environmentalLabels": ["0"],
  "sortBy": "lowerQuote",
  "maxMonthlyPayment": 300
}
```

**Price drops on single-owner cars:**

```json
{
  "onlyPriceDropped": true,
  "onlySingleOwner": true,
  "maxKm": 80000
}
```

**New arrivals every day (schedule this run):**

```json
{
  "sortBy": "lastPublished",
  "onlyNew": true,
  "monitorName": "daily-arrivals"
}
```

**Links (filters are not used):**

```json
{
  "startUrls": [
    { "url": "https://www.ocasionplus.com/coches-segunda-mano/audi" },
    { "url": "https://www.ocasionplus.com/coches-segunda-mano/bmw/serie-3?orderBy=lowerKm" },
    { "url": "https://www.ocasionplus.com/coches-segunda-mano/seat-ibiza-10-tsi-style-xl-con-91072km-2023-af02xqaq" }
  ],
  "includeDetails": true
}
```

### ⚙️ How the input is organised

| Section | What it's for |
| --- | --- |
| **Maximum results** | Always first, caps the whole run. Empty means no limit. |
| **What to scrape** | Vehicles, sort by, brands, models, provinces, cities or dealers and car details (VIN, extras, equipment, specs, dealer contacts). |
| **Filters** | Minimum price (EUR), maximum price (EUR), maximum monthly payment (EUR), from year, to year, minimum km, maximum km, minimum horsepower (CV), maximum horsepower (CV), fuel, powertrain, gearbox, body type, dGT environmental label, condition, listed since, only available, only single owner, only with official warranty, only VAT deductible, only discounted, only with a price drop, only 48-hour delivery, color, minimum seats, only 4x4, only with Carfax report and only with service book. |
| **Monitoring** | Only new cars and monitor name. |
| **Links** | Links instead of the fields above. Filters are ignored with links. |

### 💰 Pricing

Pay-per-event: a one-time **$0.003** when the run starts, plus a price per vehicle saved to your dataset. The price depends on your Apify plan tier:

| Your Apify plan | Price per vehicle |
| --- | --- |
| Free | $0.012 |
| Bronze | $0.011 |
| Silver | $0.0105 |
| Gold / Platinum / Diamond | $0.010 |

Approximate total cost:

| Vehicles collected | Free | Bronze | Silver | Gold+ |
| --- | --- | --- | --- | --- |
| 100 | $1.20 | $1.10 | $1.05 | $1.00 |
| 1,000 | $12.00 | $11.00 | $10.50 | $10.00 |
| 10,000 | $120.00 | $110.00 | $105.00 | $100.00 |

**Car details add-on:** when **Car details** is on (or a color, seats, 4x4, Carfax or service book filter turns it on), each vehicle whose car page was read adds one more charge:

| Your Apify plan | Car details, per vehicle |
| --- | --- |
| Free | $0.004 |
| Bronze | $0.0035 |
| Silver | $0.003 |
| Gold / Platinum / Diamond | $0.0025 |

Car pages that could not be read pay only the base price, and vehicles left out by filters are free. New Apify accounts start with $5 in free credit. On the Free plan, a run saves up to 10 vehicles.

### 🚀 Run it

1. Create a free Apify account with $5 in credit.
2. Open the OcasionPlus Scraper.
3. Choose cars or motorbikes, add filters (or keep it empty for everything), then click **Start**.
4. Export the results as CSV, Excel, JSON or XML from the Dataset tab.

### 🤖 Use with AI agents (MCP)

Connect the [Apify MCP server](https://mcp.apify.com) to Claude, ChatGPT, Cursor or any MCP client, then ask in plain words, for example: *"Get every hybrid Toyota under 20,000 EUR on OcasionPlus in Valencia, with VIN and equipment"*. The agent runs this Actor and reads the results.

### 🔧 Troubleshooting

- **Few or no results.** Brands, models and places are matched by name, so "Mercedes-Benz" finds Mercedes and "Bizkaia" finds Vizcaya. Check the spelling, or loosen a filter.
- **A run with a color, seats, 4x4, Carfax or service book filter is slower.** Those values are only on each car page, so every car that passes the other filters is opened. Add brand, price or year filters to keep it quick.
- **Some fields are empty.** They are empty on the site too: most cars have no factory price or price drop, VAT is deductible only on some cars, and motorbikes have no specs (size, weight, trunk, top speed).
- **A link was skipped.** The site's robots.txt does not allow its query filter links (like `?marca=audi`). Use path links like `/coches-segunda-mano/audi/a1`, or the filters.

### ❓ FAQ

**How many vehicles are there?** About 13,900 cars and 90 motorbikes as of October 2026.

**Why are the price sorts by financed price?** That is how the site sorts them. Both the cash and the financed price are in every row.

**Are extras priced?** No. The site shows placeholder prices for extras, so only their names are kept.

**Do I need a proxy?** No.

### 🛡️ Limits & responsible use

This Actor collects vehicle listings that OcasionPlus publishes on its website. It reads only pages the site's robots.txt allows and keeps a moderate pace. Use the data in line with the site's terms and Spanish and EU law. Dealer phones and emails are business contacts: follow anti-spam rules when you use them.

### 📧 Contact

Questions, bugs or a field you need: norm.data.scrapers@gmail.com

### 🧪 Local development

```bash
bun install
bun scripts/gen-schemas.mjs
sh test/run.sh first '{"maxItems":10}'
```

# Actor input Schema

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

Stop after this many cars in total. Leave empty for no limit. The Apify Free plan is always capped at 10.

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

Cars, motorbikes or both. Empty = cars.

## `sortBy` (type: `string`):

The order the site lists them in. Empty = most relevant.

## `brands` (type: `array`):

Only these brands, like "Toyota", "Volkswagen" or "Mercedes". Empty = every brand.

## `models` (type: `array`):

Only these models, like "Golf", "Serie 3" or "Toyota C-HR", in the site's own names. Empty = every model.

## `locations` (type: `array`):

Only cars at dealers in these places, like "Madrid", "Barcelona", "Las Palmas" or "Getafe". Empty = all of Spain.

## `includeDetails` (type: `boolean`):

Also read each car page for the VIN, version, color, doors, seats, gears, engine size, consumption, CO2, range, size, weight, trunk, top speed, extras, full equipment, ITV date, last service, every photo, the inspection report, 360 view, and the dealer phone, email, map position and hours. Charged per car as an add-on.

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

Cash price, as shown on the site.

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

Cash price, as shown on the site.

## `maxMonthlyPayment` (type: `integer`):

Keep only cars the site finances for at most this much a month.

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

First registration year, like 2018.

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

First registration year, like 2023.

## `minKm` (type: `integer`):

Kilometers driven.

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

Kilometers driven, like 100000.

## `minHorsepower` (type: `integer`):

Engine power in CV.

## `maxHorsepower` (type: `integer`):

Engine power in CV.

## `fuels` (type: `array`):

Keep only these fuels.

## `powertrains` (type: `array`):

Keep only these engine types.

## `transmissions` (type: `array`):

Keep only these gearboxes.

## `bodyTypes` (type: `array`):

Keep only these body types (the last ones are for motorbikes).

## `environmentalLabels` (type: `array`):

Keep only cars with these Spanish DGT labels.

## `conditions` (type: `array`):

Keep only used, Km 0 or new vehicles.

## `listedSince` (type: `string`):

Keep only cars put on sale on or after this date, like 2026-10-01 or "7 days".

## `onlyAvailable` (type: `boolean`):

Leave out cars already reserved by a buyer.

## `onlySingleOwner` (type: `boolean`):

Keep only cars the site marks as having had one owner.

## `onlyWithOfficialWarranty` (type: `boolean`):

Keep only cars still under the maker's warranty.

## `onlyVatDeductible` (type: `boolean`):

Keep only cars sold with deductible VAT (for companies and the self-employed).

## `onlyDiscounted` (type: `boolean`):

Keep only cars with a discount on the price.

## `onlyPriceDropped` (type: `boolean`):

Keep only cars whose price has been lowered.

## `onlyDelivery48h` (type: `boolean`):

Keep only cars the site delivers in 48 hours.

## `colors` (type: `array`):

Keep only these colors. Turns on car details.

## `minSeats` (type: `integer`):

Like 7 for a 7-seater. Turns on car details.

## `onlyFourWheelDrive` (type: `boolean`):

Keep only four-wheel drive cars. Turns on car details.

## `onlyWithCarfax` (type: `boolean`):

Keep only cars with a Carfax history report. Turns on car details.

## `onlyWithServiceBook` (type: `boolean`):

Keep only cars with a photo of their service book. Turns on car details.

## `onlyNew` (type: `boolean`):

Skip cars saved by earlier runs with the same monitor name.

## `monitorName` (type: `string`):

Runs with the same name share their history. Use a different name for each schedule.

## `startUrls` (type: `array`):

Car or motorbike pages (https://www.ocasionplus.com/coches-segunda-mano/audi-a1-...-con-99837km-2019-ztobjqaz) or listings by path, like https://www.ocasionplus.com/coches-segunda-mano/audi/a1 or https://www.ocasionplus.com/coches-segunda-mano/madrid.

## Actor input object example

```json
{
  "maxItems": 10
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("normdata/ocasionplus-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 = { "maxItems": 10 }

# Run the Actor and wait for it to finish
run = client.actor("normdata/ocasionplus-scraper").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 '{
  "maxItems": 10
}' |
apify call normdata/ocasionplus-scraper --silent --output-dataset

```

## MCP server setup

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

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/LKjb9cPgiXS6iyc0M/builds/vsSwIAGjmug8xa1Gc/openapi.json