Coches.net Used Car Scraper

Scrape coches.net — Spain's largest used-car marketplace. Search thousands of used-car listings by make, model, price range, registration year, mileage, power (hp), fuel type, transmission, body type, province and mainland-Spain-only, or fetch specific listings by URL. Get title, price, full spec, seller info, description and photos for every listing. HTTP-only, no login, no cookies, no residential proxy required.

What this actor does

• Two modes: search (filtered search across the whole catalog) and byUrls (fetch specific listing pages you already have links for)
• Rich filters: make, model, price range, year range, mileage range, power (horsepower) range, fuel type, transmission, body type, province, mainland-Spain-only, seller type (dealer vs. private), keyword search
• Full listing detail: price, make/model/year/mileage, fuel type, transmission, body type, location, seller type and name, description, up to 30 photos
• Sorting: relevance or price
• Empty fields are omitted — a listing with no description simply has no description key, never null

Output per listing

• listingId — coches.net's internal ad ID
• title — listing headline (make, model, trim)
• price, financedPrice, currency — asking price in EUR (and financed monthly-payment price if advertised)
• make, model, year — vehicle identity
• mileageKm — odometer reading in kilometers
• fuelType — Diesel / Gasoline / Electric / Hybrid / Plug-in hybrid / LPG / CNG / Other
• transmission — Manual / Automatic (only present when detail-page fetching is enabled)
• bodyType — Sedan / Coupe / Convertible / Estate / Minivan / SUV / Pick-up / Other
• horsePowerHp — engine power in hp, when advertised
• environmentalLabel — Spanish DGT eco-label (0, ECO, B, C)
• color — exterior color, when advertised (detail-page only)
• doors — number of doors, when advertised (detail-page only)
• province, city, region — listing location
• sellerType — dealer or private
• sellerName, sellerRating, sellerReviewCount — seller info, when available
• description — full free-text listing description (detail-page only)
• hasWarranty, isCertified, isFinanced — listing badges, when true
• publicationDate — when the listing was published/refreshed
• photos[], mainPhotoUrl — up to 30 photo URLs
• listingUrl — canonical coches.net URL for the listing
• recordType: "carListing", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search or byUrls
searchText	string	–	Keyword search across listing titles (mode=search)
makeIds	array (select)	–	One or more car makes (mode=search); empty = all makes
modelName	string	–	Free-text substring match on model name (mode=search)
minPrice / maxPrice	int	–	Price range in EUR
minYear / maxYear	int	–	Registration year range
minKm / maxKm	int	–	Mileage range in km
fuelType	string (select)	any	Diesel / Gasoline / Electric / Hybrid / Plug-in hybrid / LPG / CNG / Other
transmission	string (select)	any	Automatic / Manual
bodyType	string (select)	any	Sedan / Coupe / Convertible / Estate / Minivan / SUV / Pick-up / Other
minHp / maxHp	int	–	Engine power range in horsepower (hp/CV)
provinceId	string (select)	all Spain	Filter to one Spanish province
onlyPeninsula	boolean	false	Exclude Balearic Islands and Canary Islands listings, keeping mainland Spain (+ Ceuta/Melilla)
sellerType	string (select)	any	any / dealer / private
sortBy	string (select)	relevance	relevance or price (highest first)
fetchDetails	boolean	true	Also visit each listing's page for description + transmission (slower)
listingUrls	array	–	Listing URLs to fetch directly (mode=byUrls)
maxItems	int	10	Hard cap on returned listings (1–2000)

Example: search by make, price and year

{
  "mode": "search",
  "makeIds": ["4"],
  "minPrice": 5000,
  "maxPrice": 20000,
  "minYear": 2018,
  "maxYear": 2023,
  "maxItems": 50
}

Example: keyword search with fuel/transmission/province filters

{
  "mode": "search",
  "searchText": "audi a4",
  "fuelType": "1",
  "transmission": "2",
  "provinceId": "28",
  "maxItems": 30
}

Example: fast run without detail pages

{
  "mode": "search",
  "makeIds": ["15"],
  "bodyType": "6",
  "sellerType": "dealer",
  "fetchDetails": false,
  "maxItems": 100
}

Example: power range and mainland Spain only

{
  "mode": "search",
  "makeIds": ["1"],
  "minHp": 150,
  "maxHp": 300,
  "onlyPeninsula": true,
  "maxItems": 40
}

Example: fetch specific listings by URL

{
  "mode": "byUrls",
  "listingUrls": [
    "https://www.coches.net/audi-a4-2-0-tdi-150cv-s-line-5p-diesel-2020-en-madrid-70123456-covo.aspx"
  ]
}

Use cases

• Price research — track average asking prices for a make/model/year combo across Spain
• Dealer monitoring — see what dealers vs. private sellers list for a given segment
• Regional market analysis — compare listing volume and pricing province by province
• Lead generation — build a list of private-seller listings in a specific price band
• Fleet remarketing — benchmark used-vehicle pricing before setting resale prices

Limitations

• coches.net applies its own traffic-shaping to individual listing pages that fluctuates over time. The actor always returns the full requested maxItems count with all search-result fields (title, price, make, model, year, mileage, fuel type, body type, location, seller, photos), but on a small fraction of runs a handful of listings may be missing the detail-page-only fields (description, transmission, color, doors) if that listing's page was temporarily unavailable during the run. Re-running later typically fills in any gaps.
• Coverage is segunda-mano (used cars) only — coches.net's primary catalog. New-car and Km0 (zero-km) listings are out of scope.

FAQ

Is this affiliated with coches.net? No. This is an independent, third-party actor that reads coches.net's public listing pages. It is not affiliated with or endorsed by coches.net.

How fresh is the data? Every run fetches live listing pages at request time — there is no cache or delay beyond the run's own execution time.

Why are some fields missing on some listings? coches.net sellers don't fill out every field (e.g. horsepower, color, doors). This actor never fabricates data — a field is only present if the listing actually advertises it.

What's the difference between transmission and bodyType? transmission (Manual/Automatic) describes the gearbox; bodyType (Sedan, SUV, Estate, etc.) describes the vehicle's shape/category. Both are standard coches.net classifications.

Why does transmission and description only appear when fetchDetails is true? Those two fields are only shown on a listing's individual detail page, not in search results. Enabling fetchDetails (on by default) makes one extra request per listing to fetch them — disable it if you only need the search-result fields and want a faster run. Large maxItems values with fetchDetails enabled take proportionally longer (roughly a few seconds per listing) since each detail page is fetched politely, one at a time.

Does this cover new cars or Km0 (zero-km) vehicles? No — this actor covers segunda-mano (used/second-hand) listings only, which is coches.net's primary and largest catalog.

Can I search by an exact model, not just make? Use modelName for a case-insensitive substring match (e.g. "A4", "Golf"), or use searchText for a broader keyword search across the listing title.