Encar API

Encar API: listings, catalog, and landed cost for cars from Korea

One REST interface instead of your own parser. MotorFeed reads Encar, maps it to a stable schema, localizes the values, and returns ready-to-use JSON for a website, a CRM, or an internal dashboard.

Try the API Message us on Telegram

catalog levels for cascading filters

views per car: vehicle page, insurance history, inspection report

pricing markets: MD, RU, UA, and AE

quota spent on catalog reference endpoints

vehicle page

JSON

GET /vehicles/encar_42247740
  ?lang=ru-MD&country=UA&currency=USD

{
  "title": "Hyundai Palisade 3.8 GDi AWD",
  "vehicleIdentity": {
    "brand": "Hyundai",
    "model": "Palisade",
    "generation": "LX2",
    "modification": "3.8 GDi AWD"
  },
  "vehicleId": 42247740,
  "vin": "KMHR381EDMU0*****",
  "spec": {
    "yearMonth": 202108,
    "mileage": 41500,
    "displacement": 3778,
    "fuelName": "Бензин",
    "transmissionName": "Автомат",
    "bodyName": "Внедорожник",
    "colorName": "Белый"
  },
  "photos": [
    {
      "code": "001",
      "type": "main",
      "thumbnailUrl": "https://.../thumb.jpg",
      "heroUrl": "https://.../hero.jpg",
      "url": "https://.../full.jpg"
    }
  ],
  "pricing": {
    "country": "UA",
    "currency": "USD",
    "sourcePrice": 27350,
    "customsValue": 26100,
    "fees": [
      { "code": "logistics", "amount": 4900 },
      { "code": "customs_duty", "amount": 2610 },
      { "code": "excise_tax", "amount": 1893 },
      { "code": "vat", "amount": 7370 }
    ],
    "total": 44223,
    "ratesUsed": { "KRW": 1390.5, "UAH": 41.8 },
    "estimated": false
  }
}

What the API returns

What you get out of Encar

Every method returns finished fields instead of the raw upstream payload: values are localized, ids are stable, and the price is calculated under the rules of the target country.

Catalog

Reference data for filters

Brands, model groups, models, trims, and trim details in one cascade. Responses are cached for a day and never spend your request package.

Results through clear filters

POST /search accepts brand, model, modification, fuel, transmission, color, seat count, price, year, and an exact mileage range. The price range refers to the landed total in your currency, not to the raw listing price.

Vehicle

Everything about one car

A single prefixed id returns specs, the VIN when published, options, condition, the seller description, photos, and the landed-cost breakdown.

History

Insurance record

Owner changes, accident payouts, write-offs, and flood or theft records — what a buyer asks about before committing.

Inspection

Inspection report

Repaired and replaced body zones with their position on the damage drawings, plus the mechanical check results.

Pricing

Landed cost per market

country, currency, and your own rates produce a line-by-line total: shipping, duty, excise, VAT, and fees under the rules of Moldova, Russia, Ukraine, or the UAE.

Catalog

Brands, models, generations, and vehicles

The catalog is a cascade: every level takes the ids of the previous one, so your filter panel is built without hand-written dictionaries and without decoding Encar's internal syntax.

Brands

The list of manufacturers with the display order and a separate ranking for popular brands.

GET /catalog/manufacturers

Model groups

Model groups inside a brand — the top level of choice a visitor actually sees.

GET /catalog/model-groups

Models and generations

Models with production start and end dates, which is what forms the generation in the MotorFeed data model.

GET /catalog/models

Trims

Trims of the selected model and their details through /catalog/badge-details — the deepest filter level.

GET /catalog/badges

Vehicles

Listings for the ids you collected: the items, the total count, and filter facets with counters.

POST /search

Catalog endpoints are marked free of charge: they do not spend requests from the package. The package is only spent on search and vehicle pages, so building the filter panel costs nothing.

catalog cascade and search

HTTP

GET /catalog/manufacturers
GET /catalog/model-groups?manufacturerCd=001
GET /catalog/models
  ?manufacturerCd=001&modelGroupCd=019
GET /catalog/badges
  ?manufacturerCd=001&modelCd=136
GET /catalog/badge-details
  ?manufacturerCd=001&modelCd=136&badgeCd=008

POST /search
{
  "lang": "ru-MD",
  "country": "UA",
  "currency": "USD",
  "filters": {
    "saleOnly": true,
    "brandId": "001",
    "modificationId": "136",
    "gradePath": ["008"],
    "year": { "min": 2020 },
    "mileage": { "max": 100000 }
  },
  "sort": "newest",
  "limit": 20
}

Images

Photos with ready-made links

Every photo arrives as three links for different places in the interface, so you neither assemble upstream URLs by hand nor store the files yourself.

thumbnailUrl

The thumbnail for lists and search results.

heroUrl

The large frame for the vehicle page cover.

url

Full size for the gallery.

Type and order

Photos keep their code, type, description, and update time, so you can separate exterior from interior and skip outdated frames.

Inspection drawings

The inspection report returns body zones with their spot on the damage drawing, so repairs and replacements can be rendered on your own illustration.

Dealer photo

Search results carry the listing thumbnail and the seller photo as separate fields.

Specifications

What a vehicle response contains

The sections below make up the vehicle page. Dictionary values are localized by the lang parameter: ru-MD, ro-MD, en-US, or ko-KR.

Identity

A prefixed id such as encar_42247740
VIN and body number when published
Brand, model, generation, and modification in one structure
The link back to the source Encar record and the mapping status

Technical data

Model year and first registration date
Mileage in kilometers
Engine displacement and fuel type
Transmission, body style, color
Options and equipment from the listing

Listing

Upstream price in won and the converted amount in your currency
Region, dealer, and listing contacts
Publication date
Sales status, including cars already under deposit
Seller description

Condition and pricing

Insurance history and inspection report
Shipping, duty, excise, VAT, and fees line by line
The total and the exchange rates it was calculated with
An estimated flag wherever a value is approximated rather than known

Freshness

How the data is refreshed

Search and vehicle pages reach the source at call time, so the response carries the current price and status rather than yesterday's copy of a database.

Read at call time

Search results and vehicle pages are read from the source when you call them: price, availability, and listing status are correct as of the response.

Cache where it is safe

Catalog reference data is cached for a day; volatile data is not. That removes needless load without ever showing a stale price.

Sold and reserved cars

The saleOnly filter drops listings that are no longer available, and salesStatus flags a car that already has a deposit on it.

Fallback path

If the primary source of a vehicle page is unavailable, the service answers from a fallback path instead of failing your integration.

Documentation

Swagger UI and OpenAPI

Every method, parameter, and response code is documented in OpenAPI, so integration can start without a single email asking for examples.

Swagger UI at /docs: call the methods straight from the browser with your key.
The machine-readable schema at /docs-json — generate a client in your own language.
Errors are documented explicitly: 401 without a key, 402 without an active subscription, 403 from an untrusted IP, 429 over the rate limit.
Keys, trusted IPs, and request usage are visible in your account.

Pricing

Access to the Encar API

€149

per month, Start plan

Catalog, search, vehicle pages, documentation, and support are included in every plan. Paying yearly takes 15% off.

Start — up to 10,000 requests per month

Grow — up to 30,000 requests and priority support

Scale — up to 100,000 requests and up to 3 domains or IPs

Catalog reference endpoints never spend the package, on any plan

See all plans

Ready to connect the Encar API to your product?

Create an account and get a key, or message us on Telegram — we will point out which methods cover your scenario: a public showroom, a CRM, a manager dashboard, or an internal sourcing tool.

Try the API Message us on Telegram