Encar API 문서
엔드포인트 세 개, 헤더 하나, JSON 출력. 아래가 전체 레퍼런스이며, 유료로 공개되는 두 번째 문서는 없습니다.
기본 URL
https://api.encar-api.com/api인증
모든 요청에 x-api-key 헤더로 키를 보내세요. OAuth 단계도, 갱신할 토큰도 없습니다. 키가 없거나 알 수 없으면 401로 응답합니다.
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"세 개의 엔드포인트
| endpoint | what it does |
|---|---|
| GET /cars | 필터로 매물을 검색합니다. total, page, count, results[]를 반환합니다. |
| GET /car?id= | 차량 한 대의 전체 정보. 요청 시점에 판매 여부를 실시간 확인합니다. |
| GET /count | 필터 조건에 맞는 매물 수를, 매물을 가져오지 않고 셉니다. |
레퍼런스
각 섹션은 여기서 열리며, 각 제목은 링크하고 저장할 수 있는 별도 페이지이기도 합니다.
검색 파라미터 — 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. |
매물은 이렇게 생겼습니다
더 읽기
데이터가 한국어 원본에서 오기 때문에 이 중 네 필드는 기본적으로 잘못 읽힙니다. 모두 조용히 실패합니다. 페이지는 잘 그려지고, 다만 틀립니다.
| field | meaning |
|---|---|
| Id | Encar listing id. Pass it to /car to get the full vehicle. |
| Manufacturer / Model / Badge | Korean source values. Badge is partly Korean — prefer the de / en block below. |
| de / en | The same car translated: manufacturer, modelGroup, model, badge, fuelType. Render these. |
| Price | In units of 10,000 KRW. EUR ≈ Price × 6.7, so 4339 is about €29,070 — not €4,339. |
| Year | YYYYMM, not a year: 201902 is February 2019. FormYear holds the plain "2019". |
| Mileage | Kilometres, as an integer. |
| FuelType | Korean. The translated value is in de.fuelType / en.fuelType. |
| Photo / Photos[] | Relative paths. Prefix them with the image host; with Photo, append 001.jpg. |
| priceDrop | Present when the seller cut the price: previousPrice, droppedAt. |
| powerPs / powerKw | Engine output, where the trim is known. |
| OfficeCityState | Where the car stands, as a Korean region name. |
요청 한도와 오류
더 읽기
모든 응답에 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset이 들어 있어, 한도를 맞닥뜨리는 대신 다가오는 것을 볼 수 있습니다.
| status | meaning |
|---|---|
| 200 | A normal answer. Check X-RateLimit-Remaining while you are here. |
| 400 | A parameter could not be parsed — a non-numeric yearFrom, for instance. |
| 401 | Missing or unknown key. Send it as the x-api-key header. |
| 404 SOLD_OR_REMOVED | From /car: the vehicle is gone from Encar. Drop it on your side. |
| 429 | Daily allowance spent. X-RateLimit-Remaining tells you before it happens. |
| 503 | The Korean source did not answer in time. Retry once, then fall back. |
API 키 받기
무료 · 하루 100회 요청
이어서 읽기
한 번의 호출에서 자유롭게 조합할 수 있습니다. 응답에 total, page, count, results[]가 있으므로 두 번째 요청 없이 total로 페이지를 넘길 수 있습니다.
데이터가 한국어 원본에서 오기 때문에 이 중 네 필드는 기본적으로 잘못 읽힙니다. 모두 조용히 실패합니다. 페이지는 잘 그려지고, 다만 틀립니다.
모든 응답에 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset이 들어 있어, 한도를 맞닥뜨리는 대신 다가오는 것을 볼 수 있습니다.