# Coches.net Scraper — Spain Cars, EV Battery & Dealers (`memo23/coches-net-scraper`) Actor

Coches.net scraper for Spain's car market. One row per car with battery kWh, WLTP range and consumption, charging times, equipment, every photo, the VIN where published, and the dealer block with address, coordinates, website and phone. Searches past the 9,990-car limit are split by price.

- **URL**: https://apify.com/memo23/coches-net-scraper.md
- **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community)
- **Categories:** E-commerce, Lead generation, AI
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.40 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## Coches.net Scraper — Spain Cars, EV Battery & Dealers

Turn any [coches.net](https://www.coches.net) search into clean, structured data. Spain's largest car marketplace, one flat row per car: battery capacity, WLTP range, consumption and charging times as numbers, the fitted-equipment list, every photo, the chassis number where the dealer published it, and the dealer's block with address, postcode, city, coordinates, website and phone.

![How the Coches.net Scraper works](https://raw.githubusercontent.com/muhamed-didovic/muhamed-didovic.github.io/main/assets/how-it-works-coches.png)

#### ✨ Why use this scraper

- **Figures, not display strings**: the site prints `14,9 kWh/100 km` and `Autonomía 436 km`. The row carries `consumptionWhPerKm: 149` and `rangeKm: 436`, so a Spanish dataset merges with any other market without cleanup.
- **Past the 9,990-car limit**: coches.net shows at most 333 pages of 30 cars for any one search. A larger search is split by price and put back together, so it comes back whole instead of stopping at 9,990. The electric dealer segment (about 3,950 cars) fits in one search. Featured ads that repeat on every page are delivered once.
- **The dealer on every row**: id, name, address, postcode, city, province, coordinates, website and phone, as coches.net gives them, with no second table to join.
- **A short run says so**: every search is compared against the site's own count, and a run that comes up short ends FAILED with the shortfall recorded. You never get a half dataset that looks complete.

#### 🎯 Use cases

| Who | What for |
|---|---|
| EV analyst | Track used electric prices against battery capacity, range and real consumption |
| Dealer group | Watch competitors' stock, pricing and how many cars each one lists |
| Lead generation | A dealer directory with address, coordinates, website and phone, built from live stock |
| Price monitoring | Follow a model's asking price, and coches.net's own reference price, across Spain |
| Market research | Segment by body type, drivetrain, year, province or price |

#### 📥 Supported inputs

- A search URL: `https://www.coches.net/electrico/segunda-mano/profesionales/`, `https://www.coches.net/kia/ev3/segunda-mano/`
- A direct ad URL: `https://www.coches.net/kia-ev3-earth-standard-range-5p-electrico-hibrido-2025-en-a-coruna-71904478-covo.aspx`
- No URL at all: set make, model, fuel, seller, price, year or mileage and the search is built for you. With nothing set, the run covers electric cars sold by dealers.

#### ⚙️ How it works

A search is read page by page to its end, 30 cars a page. A search holding more than 9,990 cars is first split into price ranges that each fit, and every range is read in turn. Each car's own ad is then read for everything the results list does not show: the battery and charging figures, the equipment, the dealer's address and point, and the chassis number. Ads load in parallel, and one that fails to load is retried automatically.

At the end of the run the number of cars delivered is compared with the number coches.net reported for the search, and the comparison is saved to the run's key-value store as `COMPLETENESS`.

#### ⚙️ Input parameters

| Field | Type | Default | Notes |
|---|---|---|---|
| `startUrls` | array | — | Search or ad URLs |
| `make` / `model` | string | — | As coches.net names them, e.g. `KIA` / `EV3` |
| `fuelType` | enum | — | `electric`, `plugInHybrid`, `hybrid`, `petrol`, `diesel`, `lpg`, `cng` |
| `sellerType` | enum | `all` | `dealer`, `private` or `all` |
| `priceFrom` / `priceTo` | integer | — | EUR |
| `yearFrom` / `yearTo` | integer | — | |
| `maxMileageKm` | integer | — | |
| `includeDetails` | boolean | `true` | Off returns only what the results list shows |
| `enrichEmails` | boolean | `false` | Look up each dealer's email on their own site |
| `maxItems` | integer | `100` | Always set it; the EV dealer search alone runs to about 4,000 cars |
| `maxPages` | integer | `0` | 0 reads the whole search |
| `maxConcurrency` | integer | `5` | Ads read at once |
| `failOnIncomplete` | boolean | `true` | Fail rather than return a short dataset |
| `completenessTolerancePercent` | integer | `1` | The larger of this and the absolute tolerance applies |
| `completenessToleranceAbsolute` | integer | `25` | Covers ads added and withdrawn mid-run |

#### 📊 Output overview

One row per car. Nested objects keep related values together: `price` carries the amount and currency, `dealer` the seller block exactly as coches.net gives it, and `location` the point as numbers with the place names.

#### 📦 Output sample

```json
{
  "adId": "71904478",
  "url": "https://www.coches.net/kia-ev3-earth-standard-range-5p-electrico-hibrido-2025-en-a-coruna-71904478-covo.aspx",
  "title": "KIA EV3 Earth Standard Range",
  "make": "KIA",
  "model": "EV3",
  "version": "Earth Standard Range",
  "year": 2025,
  "bodyType": "4x4",
  "offerType": "Ocasión",
  "price": { "amount": 29900, "currency": "EUR" },
  "financedPrice": 27900,
  "referencePrice": 28700,
  "newPrice": 37686,
  "mileageKm": 25000,
  "fuel": "Eléctrico",
  "transmission": "automatic",
  "drivetrain": "front",
  "environmentalLabel": "0",
  "batteryCapacityKwh": 58.3,
  "rangeKm": 436,
  "consumptionWhPerKm": 149,
  "chargingAcKw": 11,
  "chargingDcKw": 101,
  "chargingTimeDcMin": 28,
  "chargingDcFromPercent": 10,
  "chargingDcToPercent": 80,
  "powerHp": 204,
  "powerKw": 150,
  "colour": "Gray",
  "warrantyMonths": 12,
  "vin": "KNAFD81B3S6043158",
  "equipment": ["Seis altavoces", "Equipo de audio con radio AM/FM, radio digital y pantalla táctil", "…"],
  "imageUrls": ["https://pro.fastly.ccdn.es/pro/pro/vehicles/images/89/894246ae-8658-41a4-a248-90b7f9122cf9/1920x1440/"],
  "sellerType": "dealer",
  "dealer": {
    "id": "77858",
    "name": "Breogán Ocasión",
    "externalContractId": "900616001531",
    "location": {
      "address": "Sede principal: C/ Severo Ochoa, 14",
      "postalCode": "15008",
      "city": "Coruña (A)",
      "province": "A Coruña",
      "coordinates": { "lat": "43.335058", "lng": "-8.425192" }
    },
    "phoneNumber": "881550885",
    "externalPageUrl": "https://www.breoganocasion.com/",
    "stockPageUrl": "/concesionario/breoganocasion/",
    "hasCallTrackingService": true
  },
  "phone": "881550885",
  "location": { "lat": 43.335058, "lon": -8.425192, "zipCode": "15008", "city": "Coruña (A)", "province": "A Coruña", "region": "Galicia" },
  "publishedAt": "2026-11-11T11:21:01+01:00",
  "searchMatchCount": 3956
}
```

#### 🗂 Key output fields

| Field | What it holds |
|---|---|
| `adId` / `url` | The site's own id and the ad URL |
| `make` / `model` / `version` / `year` / `bodyType` | What the car is |
| `offerType` | `Ocasión`, `Km0`, `Demostración`, `Gerencia` or `Sustitución` |
| `price` | `{ amount, currency }` in EUR; `financedPrice` is the dealer's finance price where it differs |
| `referencePrice` / `priceRank` | coches.net's own reference price for comparable cars, and its 1 to 5 rating of this ad |
| `newPrice` | List price of the version when new |
| `batteryCapacityKwh` / `rangeKm` / `consumptionWhPerKm` | Pack size, WLTP range, WLTP consumption |
| `chargingAcKw` / `chargingDcKw` | On-board charger and peak DC power |
| `chargingTimeDcMin` + `chargingDcFromPercent` / `chargingDcToPercent` | DC charge time between the two stated levels (10 to 80% on most cars) |
| `chargingTimeAcMin` + its percentages | AC charge time on a household socket |
| `equipment` / `optionalEquipment` | The version's fitted equipment, and the extras the dealer lists on top |
| `vin` | The chassis number, where the dealer published one |
| `imageUrls` | Every gallery photo in the ad's order, at up to 960x720. No dealer logo, no video |
| `dealer` | `{ id, name, externalContractId, location { address, postalCode, city, province, coordinates }, phoneNumber, externalPageUrl, stockPageUrl, hasCallTrackingService }`, unchanged from the ad page |
| `phone` | The number the search list shows for the car |
| `contactEmail` | The dealer's email, when `enrichEmails` ran. `contactWebsite` names the site it came from |
| `location` | `{ lat, lon, zipCode, city, province, region }` |
| `searchMatchCount` | What the site reported for the search this row came from |

#### ❓ FAQ

**How often are the fields actually populated?** Measured over the whole electric dealer segment on 16 November 2026: 3,957 cars from 1,340 dealers. Price, mileage, year, colour, phone, the dealer block with postcode and province: 100%. Power 99.7%, equipment 99.7% (a median of 42 lines), photos 99.6% (median 23), dealer address 99.6%, version 98.4%, dealer coordinates 98.5%, description 97.8%, AC charger power 94.7%, range 91.4%, consumption 85.7%, battery capacity 85.5%, DC charge time 84.1%, DC power 80.8%, dealer website 66.7%, the dealer block's own city 65.6% (the row's `location.city` 99.4%), AC charge time 57.7%, VIN 43.6%. Where a field is empty it is empty on the site too.

**Why is the battery capacity empty on some electric cars?** Because coches.net does not publish it for those versions. Tesla and several Mercedes-Benz EQ models carry range and consumption but no battery figure anywhere on the ad. The field is left empty rather than estimated.

**Is the phone number the dealer's own line?** It is the number coches.net shows buyers on the ad. Most dealers use the site's call tracking, so the number can be a forwarding line that rings the dealer rather than their direct number.

**Why is `vin` empty on most rows?** Dealers choose whether to publish the chassis number, and most do not. Plates and company tax numbers are not published on coches.net at all.

**Can I get the dealers' email addresses?** Switch on `enrichEmails`. Each dealer's own website is read once per run, however many cars they list, and the best address found is written to `contactEmail`. A lookup that finds nothing costs nothing, and a dealer is charged once rather than once per car.

**Why are some photos smaller than others?** Most photos come at up to 960x720. Older ads keep their photos on a second image host that serves one size only, about a third of all photos, and those arrive at the size the dealer uploaded.

**Are Km0 cars included?** The used-car searches include the Km0, demonstration and manager cars coches.net files there, flagged in `offerType`: in the electric dealer segment 3,604 Ocasión, 290 Km0, 54 Demostración, 7 Gerencia, 2 Sustitución. The site's separate Km0 section (`https://www.coches.net/km-0/electrico/`) works as a start URL too.

#### 💬 Support

Issues and feature requests go to the Issues tab on the actor's page.

#### 🤖 For AI Agents & LLM Apps

**Purpose:** scrape coches.net, Spain's largest car marketplace, into one flat row per car, including numeric EV figures, the equipment list, the dealer block and the phone number.

**Output fields:** `adId`, `url`, `title`, `make`, `model`, `version`, `year`, `bodyType`, `offerType`, `price {amount, currency}`, `financedPrice`, `priceIncludesVat`, `referencePrice`, `priceRank`, `newPrice`, `mileageKm`, `fuel`, `transmission`, `drivetrain`, `environmentalLabel`, `batteryCapacityKwh`, `batteryType`, `rangeKm`, `consumptionWhPerKm`, `chargingAcKw`, `chargingDcKw`, `chargingTimeDcMin`, `chargingDcFromPercent`, `chargingDcToPercent`, `chargingTimeAcMin`, `chargingAcFromPercent`, `chargingAcToPercent`, `chargingConnectors`, `powerHp`, `powerKw`, `accelerationSec`, `topSpeedKmh`, `weightKg`, `lengthMm`, `widthMm`, `heightMm`, `bootLiters`, `seats`, `doors`, `colour`, `hasWarranty`, `warrantyMonths`, `isCertified`, `vin`, `description`, `equipment`, `optionalEquipment`, `imageUrls`, `hasVideo`, `sellerType`, `dealer {id, name, externalContractId, location {address, postalCode, city, province, coordinates {lat, lng}}, phoneNumber, externalPageUrl, stockPageUrl, hasCallTrackingService}`, `phone`, `contactEmail`, `contactWebsite`, `emailEnrichment`, `location {lat, lon, zipCode, city, province, region}`, `publishedAt`, `createdAt`, `searchMatchCount`, `detailScraped`, `sourceUrl`, `scrapedAt`.

**Behaviours an agent should know:**

- Always set `maxItems`; the electric dealer search alone runs to about 4,000 cars.
- `dealer` is copied unchanged from the site, so its coordinates are strings (`"43.335058"`) and `stockPageUrl` is a site path; `location.lat`/`location.lon` carry the same point as numbers.
- Prices are EUR. `consumptionWhPerKm` is WLTP, converted from the site's kWh per 100 km.
- `chargingTimeDcMin` only means something with `chargingDcFromPercent` and `chargingDcToPercent`; the stated window differs between cars.
- A run that cannot reach the site's reported count ends FAILED by design; set `failOnIncomplete: false` if a partial dataset is acceptable.
- `enrichEmails` is off by default and billed per address found, not per car.

### ⚠️ Disclaimer

This scraper collects only publicly available information from coches.net. It does not log in, bypass any paywall, or collect personal data beyond the business contact details that sellers publish on their own listings. You are responsible for using the output in line with coches.net's terms and with applicable law, including GDPR where the data concerns identifiable people. Dealer contact details are published by the dealers themselves for the purpose of being contacted about their stock.

### SEO Keywords

coches.net scraper, coches.net api, spain car scraper, spanish used car data, coches.net listings export, scrape spanish car marketplace, spain ev listings, electric car data spain, coches.net dealer data, spanish car dealer leads, coches de segunda mano datos, coches.net price monitoring, used car data spain, car listings json spain, coches.net phone numbers, spanish vehicle specifications, ev battery capacity spain, wltp range data, car market analysis spain, coches.net bulk export

# Actor input Schema

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

coches.net search or ad URLs. Search pages such as https://www.coches.net/electrico/segunda-mano/profesionales/ or https://www.coches.net/kia/ev3/segunda-mano/, and single ads such as https://www.coches.net/kia-ev3-earth-standard-range-5p-electrico-hibrido-2025-en-a-coruna-71904478-covo.aspx. Leave empty to use the filter fields below.

## `make` (type: `string`):

Car make as coches.net names it, for example KIA, BMW, TESLA, MERCEDES-BENZ. Used only when Start URLs is empty.

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

Model within the make, for example EV3, iX, Model 3. Needs Make.

## `fuelType` (type: `string`):

Leave unset for every fuel.

## `sellerType` (type: `string`):

Dealers only, private sellers only, or both.

## `priceFrom` (type: `integer`):

Lowest asking price in euros.

## `priceTo` (type: `integer`):

Highest asking price in euros.

## `yearFrom` (type: `integer`):

Oldest year to include.

## `yearTo` (type: `integer`):

Newest year to include.

## `maxMileageKm` (type: `integer`):

Highest odometer reading to include.

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

Most cars to return. Each car is one charged result, so set this on your first run. The electric dealer segment alone holds about 4,000 cars.

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

On: battery, range, consumption, charging, equipment, the dealer's address and coordinates, the chassis number where published. Off: only what the search list shows (price, mileage, year, photos, phone, dealer name).

## `enrichEmails` (type: `boolean`):

Look up each dealer's email address on their own website. Charged only per address found, and a dealer is looked up once per run however many cars they list.

## `maxPages` (type: `integer`):

Stop after this many search pages (about 30 cars each). 0 reads the whole search.

## `maxConcurrency` (type: `integer`):

How many ads to read at once.

## `failOnIncomplete` (type: `boolean`):

End the run as FAILED when it delivers fewer cars than coches.net reported for the search, instead of returning a short dataset that looks complete. Runs that stop at Max results or Max search pages are never failed for this.

## `completenessTolerancePercent` (type: `integer`):

How far below the site's own count a run may land before it fails, as a percentage. The larger of this and the absolute tolerance applies.

## `completenessToleranceAbsolute` (type: `integer`):

How many cars a run may miss before it fails. Covers ads published and withdrawn while the run is in flight.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.coches.net/electrico/segunda-mano/profesionales/"
    }
  ],
  "sellerType": "all",
  "maxItems": 100,
  "includeDetails": true,
  "enrichEmails": false,
  "maxPages": 0,
  "maxConcurrency": 5,
  "failOnIncomplete": true,
  "completenessTolerancePercent": 1,
  "completenessToleranceAbsolute": 25
}
```

# 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 = {
    "startUrls": [
        {
            "url": "https://www.coches.net/electrico/segunda-mano/profesionales/"
        }
    ],
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("memo23/coches-net-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 = {
    "startUrls": [{ "url": "https://www.coches.net/electrico/segunda-mano/profesionales/" }],
    "maxItems": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("memo23/coches-net-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 '{
  "startUrls": [
    {
      "url": "https://www.coches.net/electrico/segunda-mano/profesionales/"
    }
  ],
  "maxItems": 100
}' |
apify call memo23/coches-net-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,memo23/coches-net-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/vFNJ05VrPNatecTlz/builds/qwofXqpU5YGZz7sWE/openapi.json
