E-commerce & Marketplaces

Encar API

The Encar API returns used-car listings from South Korea's largest car marketplace as clean JSON.

3 actionsLive JSON1,000 free creditsMCP-ready

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary search endpoint returns cars with id, make, model, trim, year, mileage in km, price in manwon and KRW, fuel type and transmission, and you can pull a detail and the makes tree. It is built for automotive pricing, dealer tools and Korean car-market analytics that need Encar data without a scraper. One ReefAPI key, one shared credit pool, the standard { ok, data, meta, error } envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/encar/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "make": "Hyundai",
    "size": 20
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "encar",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 926.6,
    "record_count": 20,
    "bytes": 19912,
    "cache_hit": false,
    "completeness_pct": 0.04,
    "stop_reason": "limit_reached",
    "method": "internal_json_api",
    "pagination": {
      "page": 1,
      "size": 20,
      "has_more": true,
      "next_page": 2
    },
    "total_results": 55814
  },
  "data": {
    "cars": [
      {
        "id": "42159812",
        "make": "현대",
        "model": "쏘나타 (DN8)",
        "trim": "2.0 LPG(렌터카용)",
        "year": 2022,
        "year_month": "2022-07",
        "form_year": "2022",
        "mileage_km": 56010,
        "price_manwon": 1900,
        "price_krw": 19000000,
        "fuel_type": "LPG(일반인 구입)",
        "transmission": null,
        "ev_type": "LPG",
        "green_type": "Y",
        "region": "부산",
        "sell_type": "일반",
        "trust_flags": [
          "ExtendWarranty",
          "HomeService"
        ],
        "condition_flags": [
          "Inspection",
          "Record",
          "Resume"
        ],
        "service_marks": [
          "EncarMeetgo",
          "EncarDiagnosisP1"
        ],
        "thumbnail": "https://ci.encar.com/carpicture05/pic4215/42159518_001.jpg",
        "photos": [
          "https://ci.encar.com/carpicture05/pic4215/42159518_001.jpg",
          "https://ci.encar.com/carpicture05/pic4215/42159518_003.jpg",
          "https://ci.encar.com/carpicture05/pic4215/42159518_004.jpg"
        ],
        "url": "https://www.encar.com/dc/dc_cardetailview.do?carid=42159812"
      },
      {
        "id": "42065320",
        "make": "현대",
        "model": "그랜저 (GN7)",
        "trim": "2.5 가솔린 2WD",
        "year": 2024,
        "year_month": "2024-01",
        "form_year": "2024",
        "mileage_km": 25924,
        "price_manwon": 2950,
        "price_krw": 29500000,
        "fuel_type": "가솔린",
        "transmission": null,
        "ev_type": null,
        "green_type": "N",
        "region": "부산",
        "sell_type": "일반",
        "trust_flags": [
          "ExtendWarranty",
          "HomeService"
        ],
        "condition_flags": [
          "Inspection",
          "Record",
          "Resume"
        ],
        "service_marks": [
          "EncarMeetgo",
          "EncarDiagnosisP1"
        ],
        "thumbnail": "https://ci.encar.com/carpicture06/pic4206/42062531_001.jpg",
        "photos": [
          "https://ci.encar.com/carpicture06/pic4206/42062531_001.jpg",
          "https://ci.encar.com/carpicture06/pic4206/42062531_003.jpg",
          "https://ci.encar.com/carpicture06/pic4206/42062531_004.jpg"
        ],
        "url": "https://www.encar.com/dc/dc_cardetailview.do?carid=42065320"
      },
      {
        "id": "42028592",
        "make": "현대",
        "model": "싼타페 TM",
        "trim": "디젤 2.2 2WD",
        "year": 2018,
        "year_month": "2018-05",
        "form_year": "2019",
        "mileage_km": 54404,
        "price_manwon": 1980,
        "price_krw": 19800000,
        "fuel_type": "디젤",
        "transmission": null,
        "ev_type": null,
        "green_type": "N",
        "region": "부산",
        "sell_type": "일반",
        "trust_flags": [
          "ExtendWarranty",
          "HomeService"
        ],
        "condition_flags": [
          "Inspection",
          "Record"
        ],
        "service_marks": [
          "EncarMeetgo",
          "EncarDiagnosisP1"
        ],
        "thumbnail": "https://ci.encar.com/carpicture02/pic4202/42026408_001.jpg",
        "photos": [
          "https://ci.encar.com/carpicture02/pic4202/42026408_001.jpg",
          "https://ci.encar.com/carpicture02/pic4202/42026408_003.jpg",
          "https://ci.encar.com/carpicture02/pic4202/42026408_004.jpg"
        ],
        "url": "https://www.encar.com/dc/dc_cardetailview.do?carid=42028592"
      }
    ]
  }
}

Actions

What the Encar API does

Action	Description	Concrete use case	Key params
search	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.	Pricing teams call search to search live Encar used-car listings by structured filters.	make, model, trim, car_type, fuel, ...
detail	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.	Marketplace operators call detail to get full detail for one car by `id`.	id
makes	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).	Catalog enrichment teams call makes to get browse all Korean (domestic) and imported makes available on Encar, each with its live listin….	car_type

Code samples

Call search from your stack

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}'

import requests

r = requests.post(
    "https://api.reefapi.com/encar/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "make": "Hyundai",
  "size": 20
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/encar/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "make": "Hyundai",
  "size": 20
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.encar.search with {"make":"Hyundai","size":20}.

Use cases

Who uses this API and why

Automotive pricing tools call search to track Korean used-car prices by make, model and mileage.
Dealer-intelligence products use detail to assess a specific listing's condition and spec.
Market analysts use makes and search to size supply and price ranges across the Korean market.

FAQ

Questions developers ask before integrating

What is the Encar API?

Encar API is a ReefAPI endpoint group for encar It returns live JSON through POST requests under /encar/v1.

Is the Encar API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Encar calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Encar login or account?

No login to Encar is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Encar data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Encar API use?

Encar actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call Encar from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call encar actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Encar API a Encar scraper?

It is the managed alternative to a DIY Encar scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same encar back as clean JSON.

Why does my Encar scraper keep getting blocked?

Most Encar scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / encar

Encar

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
}