docs / encar

Encar API

base /encar/v13 endpoints

post/encar/v1/search1 credit

Search live Encar used-car listings by structured filters: make, model, trim, car_type (domestic/imported), fuel, transmission, region, price_min/max (in 만원 = 10,000 KRW), year_min/max and mileage_min/max. Sortable + paginated. Returns rich cards with price (native 만원 + KRW), year, mileage, fuel, transmission, region, trust/condition flags, thumbnail and photos.

Parameter		Allowed / range	Description
make	optional	—	Vehicle make. English names (Hyundai, Kia, BMW, Mercedes-Benz, Audi, Toyota, Tesla, Genesis…) are auto-translated to Encar's Korean brand; you may also pass the exact Korean name from a search result.
model	optional	—	Model name — use the EXACT model string returned by `search` (Korean, e.g. '더 뉴 아반떼'). Pair with `make`.
trim	optional	—	Trim / badge — the exact value from a search result's `trim`.
car_type	optional	domestic · imported	Limit to domestic Korean or imported cars. Omit for both.
fuel	optional	gasoline · diesel · lpg · hybrid · electric · hydrogen · gasoline_hybrid · cng	Fuel / powertrain type.
transmission	optional	automatic · manual	Transmission type.
region	optional	—	Dealer region (Korean province/city: 서울 Seoul, 경기 Gyeonggi, 부산 Busan, 인천 Incheon, 대구 Daegu…).
price_min	optional	0–	Minimum price in 만원 (10,000 KRW). 1000 = ₩10,000,000.
price_max	optional	0–	Maximum price in 만원 (10,000 KRW). 4000 = ₩40,000,000.
year_min	optional	1980–2030	Minimum model year (e.g. 2020). YYYYMM also accepted (202006).
year_max	optional	1980–2030	Maximum model year (e.g. 2024). YYYYMM also accepted (202412).
mileage_min	optional	0–	Minimum odometer reading in kilometres.
mileage_max	optional	0–	Maximum odometer reading in kilometres.
sort = newest	optional	newest · price_asc · price_desc · mileage_asc · mileage_desc · year_desc · year_asc	Result ordering.
page = 1	optional	1–	Page number (1-based).
size = 20	optional	1–50	Results per page (1–50). Defaults to 20.

Try in playground →

post/encar/v1/detail1 credit

Full detail for one car by `id`: price (만원 + KRW), make/model/grade (Korean + English), year, mileage, displacement, transmission, fuel, color, seats, body type, options, warranty, inspection & accident-record availability, seizing/pledge counts, VIN (when public), all photos, view count, free-text description and the selling dealer's firm. Dealer personal data (name/phone/id/address) is redacted unless include_pii is set.

Parameter		Allowed / range	Description
id	required	—	Encar car id — the number in a dc_cardetailview carid= URL or a search result's `id`.

Try in playground →

post/encar/v1/makesfree

Browse all Korean (domestic) and imported makes available on Encar, each with its live listing count. Use a returned make name with `search`'s `make` filter. Counts are pulled live from the search API (not a stale list).

Parameter		Allowed / range	Description
car_type	optional	domestic · imported	Limit to domestic Korean or imported cars. Omit for both.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/encar/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"make":"Hyundai","size":20}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}