Coches.net Scraper & Used Car Price Monitor (Spain)

Get used-car listings from coches.net, one of the biggest used-car sites in Spain, by make, model and province. One row per car: price in EUR, year, kilometres, fuel, power, environmental label, province and city, dealer or private seller, dealer name and rating, warranty, photos and link. Watch mode turns a search into a feed: run it on a schedule and each run returns only the cars listed since your watch started that you have not received yet, plus cars whose price went down.

No login, no cookies, no API key. It reads the public used-car list pages (/segunda-mano/) only.

What you can do with it

• Dealer stock and sourcing: watch toyota/corolla in madrid every hour and get only the new listings, with price, year and kilometres.
• Price tracking: watch mode returns a price-drop row with the previous price and the difference when a seller lowers the price. Rows also carry the site's own price-drop note (sitePriceDrop).
• Market research: how many cars the site lists for a make, model and province (listingsInSearch), prices by year and mileage, dealer versus private share.
• Lead lists of dealers: dealer name, rating and number of reviews for every dealer car. Private sellers' names and phone numbers are never returned.

Input

Field	What it does
makes	A make or make/model as written in coches.net addresses, one per line: toyota, toyota/corolla, volkswagen/golf, land_rover/range_rover_evoque.
provinces	Optional provinces or regions as written in coches.net addresses: madrid, barcelona, valencia, sta_c_tenerife, catalunya. Each make line is searched in each province. Empty = all of Spain.
searchUrls	Or paste a coches.net used-car list address, such as https://www.coches.net/toyota/corolla/segunda-mano/madrid/ or https://www.coches.net/toyota/segunda-mano/particulares/ (private sellers). Addresses with a ? part are refused.
maxResultsPerSearch	Cars per search, 1 to 175 (default 30).
minPrice / maxPrice	Price range in EUR.
minYear / maxYear	Registration year range.
maxKm	Highest mileage in km.
sellerType	any (default), dealer or private.
onlyNew	Watch mode (see below).
includePriceDrops	In watch mode, also return price drops (default on).
watchPages	In watch mode, how many pages (about 35 cars each) to read per check, 1 to 5 (default 5).
watchName	Keeps separate memories for separate schedules of the same search.
resetMonitoringState	Start a watch over.

The price, year, mileage and seller filters are applied to the pages read: coches.net's robots.txt does not allow its own filter parameters, so this Actor never sends them.

Example: { "makes": ["toyota/corolla"], "maxResultsPerSearch": 30 }

Watch example: { "makes": ["toyota/corolla"], "provinces": ["barcelona"], "onlyNew": true } on a schedule.

Output

One row per car (status: "ok"):

Field	Meaning
listingId	The site's listing number.
title	The listing title (make, model and version as the seller wrote it). Phone numbers and email addresses in it are replaced with [phone removed] / [email removed].
make, model, year, km	As the site lists them.
price, currency, includesTaxes	Price in EUR (null if the site shows none) and whether it includes VAT.
financedPrice	The lower price the site shows when the car is bought with the dealer's financing, when there is one.
sitePriceDrop	The site's own note when the seller lowered the price: originalPrice, percentage, daysSinceUpdate.
previousPrice, priceChange	Watch mode, price-drop rows only (prices seen by this Actor).
fuelType, hp, environmentalLabel, offerType	Fuel as the site writes it (Gasolina, Diésel, Híbrido, Híbrido enchufable, Eléctrico), power, the DGT label (0, ECO, C, B), and Ocasión or Km0.
province, region, city	Where the car is.
sellerType	dealer or private.
dealerName, dealerRating, dealerReviews	Dealer cars only. null for private sellers.
hasWarranty, warrantyMonths, isCertified, hasReservation	As shown on the site.
isPromoted	true for paid top listings (shown at the top of each page).
createdAt, publishedAt	When the listing was created and when it was last published, as the site gives them.
imageUrl, imageUrls, url	Photos and the link to the car.
positionInSearch, listingsInSearch	Position in the list read, and the total the site shows for the search.
changeType	Watch mode: first-check, new or price-drop.
searchMake, searchModel, searchProvince, searchUrl, watchName, checkedAt	Which search the row came from.

The gearbox (manual or automatic) is not on the list pages, so it is not returned.

In the pages read while building this Actor (312 cars, 9 pages, October 2026): 100% had a price, year, kilometres, fuel and photo; 97% had the power; 86% had the environmental label; 85% were dealer cars (one of the 9 pages was a private-sellers-only list).

Watch mode, and what "new" means here

The first run returns the cars it reads and remembers them (first-check). Every later run returns:

• new: a car you have not received that was listed after the watch started. The site numbers listings in the order they are created, so a listing whose number is higher than the highest number seen at the first check is new. An old listing that rises in the order is not called new.
• price-drop: a car you already received whose price went down. Price rises are remembered, not returned.

A check that finds nothing returns one free no-new-listings row and is charged as one small search-checked event. Cars that could not be returned because of your run's maximum charge are not marked as delivered, and the next run returns them.

What one run can read (please read before you schedule)

• coches.net lists cars by relevance, with paid top listings first, not by date, and its robots.txt does not allow the sort parameter. A new listing can sit on any page.
• Its robots.txt allows only the first 6 pages of a list, and the site shows a check page after about 5 list pages from one IP address. This Actor does not solve or bypass check pages and does not switch addresses to get around them, so one run reads at most 5 list pages in total (about 170 cars).
• So watch one make/model in one province per schedule. Most model and province lists are under 170 cars (for example, the Toyota Corolla is listed in 47 provinces and 46 of them had under 170 cars in October 2026), and then a watch sees the whole list. If a list is longer, the first check says so in a free watch-coverage row.
• Up to 10 searches per run are accepted, but searches after the 5-page limit come back as a free not-read-page-limit row. Make one schedule per search instead.

Rows that explain instead of data (never charged)

no-results, not-found (unknown make, model or province: the site answers with a different list, which this Actor does not sell), none-matching-filters, no-new-listings, watch-coverage, incomplete (a later page could not be read), blocked (the site showed a check page), not-read-page-limit, unreadable, not-allowed-by-robots-txt, bad-input, budget-reached, more-not-returned. Each has a note that says what happened.

Limits

• At most 5 list pages per run, about 35 cars per page.
• Pages are read one by one with a 3-second pause between them.
• The site's robots.txt is read on every run, and pages it does not allow are not requested.

Thanks for using this Actor

We build these tools for people who run them every day, and we improve them from what users tell us.

• Missing a field, or need another filter? Tell us in the Issues tab. If the data is there, we add it.
• Found a bug or a wrong value? Post the run ID in the Issues tab. Wrong data is the thing we fix first.

If this Actor saved you time, a short review helps other people find it.