Parámetros de búsqueda — GET /cars
Combínalos como quieras en una sola llamada. La respuesta lleva total, page, count y results[], así que puedes paginar sobre total sin una segunda petición.
| parameter | what it does |
|---|---|
| manufacturer | Brand, as Encar writes it: BMW, Hyundai, Kia, Genesis, Mercedes-Benz, Audi. |
| model | Model name, e.g. X5 (G05). Partial names match, and a generation name narrows further: model=The New Carnival returns that generation alone, not the whole nameplate. |
| q | Free-text search across brand, model and badge. Aliases: keyword, search. |
| fuel | diesel · gasoline · hybrid · electric · lpg. |
| transmission | automatic · manual. |
| color | Exterior colour. |
| seats | Seat count: 5, 7, 9. Several at once as seats=7,9. The two ends are ranges, not counts — 2 means two seats or fewer and 10 means ten or more, which is how the source files them. A car's own figure comes back as details.seats from /car. |
| yearFrom / yearTo | Model year bounds, as plain years: 2018, 2024. |
| mileageFrom / mileageTo | Odometer bounds in kilometres. |
| priceFrom / priceTo | Price bounds in EUR — converted for you, not won. |
| sort | priceAsc or priceDesc. Left out, results come back newest first. |
| page | Page index, zero-based. Default 0. |
| count | Listings per page. Default 24, maximum 500. |
Los parámetros desconocidos se ignoran en vez de rechazarse, así que añadir un filtro que tu plan no admite no romperá una integración existente: simplemente no acotará el resultado.
Un ejemplo resuelto
BMW X5 diésel por debajo de 40.000 €, los más baratos primero, 24 por página. Toda la consulta es la URL.
curl -H "x-api-key: avg_free_..." \
"https://api.encar-api.com/api/cars?manufacturer=BMW&model=X5\
&fuel=diesel&priceTo=40000&sort=priceAsc&count=24"Consigue tu clave API
Gratis · 100 peticiones al día
Sigue leyendo
Los datos vienen de una fuente coreana, así que cuatro de estos campos se leen mal por defecto. Cada fallo es silencioso: tu página se renderiza, simplemente es incorrecta.
Cada respuesta lleva X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset, así que ves venir un límite en vez de descubrirlo.
Si falta algo, escríbenos: el número de abajo lo contesta una persona.