Coches.net API: anuncios de coches en JSON
Coches.net no abre una API a desarrolladores. Lo que vuelve aquí es lo que el portal publica — marca, modelo, año, kilómetros, precio y vendedor — en JSON. Hay un endpoint que conviene usar antes que ningún otro: el vocabulario de filtros, que trae los 166 fabricantes tal y como el portal los escribe. Es lo que evita buscar una marca con una grafía que el sitio no reconoce.
Endpoints
| endpoint | Qué devuelve | Obligatorios |
|---|---|---|
| search | Búsqueda con los filtros del propio portal: texto libre, marca, modelo, año, kilómetros, precio y tipo de vendedor. | todos opcionales |
| listing | La ficha completa de un coche: todo lo de la fila de búsqueda más el anuncio íntegro del vendedor. | listing_id |
| reference | El vocabulario de filtros leído en vivo del origen: los 166 fabricantes con sus grafías exactas y el resto de valores admitidos. | todos opcionales |
Cada llamada se cobra en créditos. Las llamadas fallidas y bloqueadas son gratuitas.
Ejemplo que funciona
Pide reference primero. Una marca escrita de otra forma no da error: devuelve cero resultados, y eso se parece demasiado a 'no hay coches' como para fiarse.
curl -X POST https://api.reefapi.com/coches/v1/search \
-H "x-api-key: TU_CLAVE" \
-H "content-type: application/json" \
-d '{"make": "seat", "year_min": 2018, "price_max": 18000}'{
"ok": true,
"data": {
"results": [
{
"listing_id": "...",
"title": "SEAT León ...",
"year": 2019,
"mileage_km": 72000,
"price": 16900,
"currency": "EUR"
}
]
},
"meta": { "record_count": 30, "cache_hit": false, "mode": "live" }
}En lugar de tu propio scraper de Coches.net
Un scraper propio de coches.net funciona el primer día. Lo caro llega después: cuando cambia la estructura del listado, el parser devuelve una lista vacía en vez de un error, y en recorridos largos la protección anti-bot corta a mitad.
El vocabulario de marcas y modelos es el otro punto que se rompe solo: el portal lo cambia sin avisar y un script con las grafías escritas a mano deja de encontrar coches sin dar ninguna señal.
Para una extracción puntual tu script sale más barato y lo decimos claro. Para un seguimiento diario, lo caro son las averías silenciosas.
Límites y notas honestas
- No es la API oficial de coches.net y no tenemos acuerdo con coches.net.
- Las grafías de marca y modelo vienen del endpoint reference; inventarlas devuelve cero resultados, no un error.
- Si el anuncio no publica kilómetros o año, el campo viene vacío y no lo estimamos.
- Sin caché: cada llamada refleja el estado en ese momento.