문서
검색 파라미터 — GET /cars
한 번의 호출에서 자유롭게 조합할 수 있습니다. 응답에 total, page, count, results[]가 있으므로 두 번째 요청 없이 total로 페이지를 넘길 수 있습니다.
| 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. |
알 수 없는 파라미터는 거부되지 않고 무시됩니다. 플랜이 지원하지 않는 필터를 추가해도 기존 연동이 깨지지 않으며, 단지 결과가 좁혀지지 않을 뿐입니다.
실제 예시
4만 유로 이하 BMW X5 디젤, 저렴한 순, 페이지당 24건. 질의 전체가 곧 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"API 키 받기
무료 · 하루 100회 요청