Paramètres de recherche — GET /cars
Combinez-les librement en un seul appel. La réponse porte total, page, count et results[], vous pouvez donc paginer sur total sans seconde requête.
| 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. |
Les paramètres inconnus sont ignorés plutôt que rejetés : ajouter un filtre que votre offre ne gère pas ne cassera pas une intégration existante, cela ne réduira simplement pas le résultat.
Un exemple détaillé
BMW X5 diesel sous 40 000 €, les moins chères d'abord, 24 par page. Toute la requête tient dans l'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"Obtenez votre clé API
Gratuit · 100 requêtes par jour
À lire ensuite
Les données viennent d'une source coréenne : quatre de ces champs sont donc lus de travers par défaut. Chaque erreur est silencieuse — votre page s'affiche, elle est simplement fausse.
Chaque réponse porte X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset : vous voyez une limite venir au lieu de la découvrir.
S'il manque quelque chose, écrivez-nous : le numéro en bas est répondu par un humain.