# Encar Korea Used Car Listings API

> Encar: 200,000+ used cars for sale in South Korea with make, model, year, mileage and price

- Vendor: `encarkoreausedcarlistingsapi` · version 1.0 · category Listings · tags encar api, korea used cars api, korean car listings api, used car prices korea api, car export korea api, hyundai kia used cars api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/encarkoreausedcarlistingsapi
- This document: https://apiclay.com/docs/encarkoreausedcarlistingsapi.md
- OpenAPI 3.1: https://apiclay.com/api/encarkoreausedcarlistingsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `encarkoreausedcarlistingsapi`
- Updated: 2026-11-18

## About

## Encar Korea Used Car Listings API

The list search behind Encar, South Korea's largest used-car marketplace: about 200,000 cars for sale (domestic brands such as Hyundai, Kia, Genesis and KG Mobility, and imports), filterable by make, model group, model, fuel, price, year and mileage and sortable by date, price or mileage, each with id, make, model and trim (in Korean), fuel, first registration month, mileage, price, seller city, inspection and warranty marks, sale type and photo paths.

Data comes from **encar.com** (https://www.encar.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `POST /search?q=(And.Hidden.N._.CarType.Y._.Manufacturer.현대._.ModelGroup.쏘나타.)&amp;sr=|ModifiedDate|0|20`; the ad page is `https://fem.encar.com/cars/detail/`.

### Routes

#### POST `/search` - Search
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | yes | Encar query: `(And.Hidden.N._` then filters joined by `._`, then `.)`. Filters: `CarType.Y` domestic, `CarType.N` imported, `CarType.A` all; `Manufacturer.현대` (make in Korean, or `BMW`); `ModelGroup.쏘나타`; `Price.range(1000..2000)` (in 10,000 KRW); `Year.range(202300..)` (YYYYMM); `Mileage.range(..10000)` (km). E.g. `(And.Hidden.N._.CarType.Y._.Price.range(1000..2000).)`. |
| sr | query | string | no | Sort, offset and count, each after a pipe: `\|\|\|`; sort `ModifiedDate`, `PriceAsc`, `PriceDesc` or `MileageAsc`, e.g. `\|PriceAsc\|0\|50` (up to 50 a page). |

Returns: `Count` (total matches) and `SearchResults`: `Id`, `Manufacturer`, `Model`, `Badge` (trim), `GreenType`, `FuelType`, `Year` (YYYYMM), `FormYear`, `Mileage` (km), `Price` (10,000 KRW), `OfficeCityState`, `SellType`, `BuyType`, `Condition`, `Trust`, `ServiceMark`, `Photo` and `Photos`.

### Caveats

- Makes, models and fuels are in Korean, as on the site; `Price` 2099 means KRW 20,990,000.
- Listings are third-party ads; a car can sell at any time.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by encar.com.

## Pricing

- Pay as you go: 0.01 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### POST /search — Search
- Gateway: `POST https://api.apiclay.com/v1/api/encarkoreausedcarlistingsapi/search`
- Public query params: `q` (string, required), `sr` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X POST "https://api.apiclay.com/v1/api/encarkoreausedcarlistingsapi/search?q=<q>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
