API

API docs: endpoints and request examples

A reference for the MotorFeed endpoints: search, vehicle, and report request examples, localization parameters, exchange rates, per-country pricing (MD, RU, UA, AE), logistics overrides, and protected-access rules.

Swagger UI
OpenAPI JSON
History and inspection
MD · RU · UA · AE pricing
Client and bank rates
Any ISO currency
IP + x-api-key
Rate limiting

structured search

JSON
POST /search
{
  "lang": "ru-MD",
  "country": "UA",
  "customer": "individual",
  "currency": "USD",
  "exchangeRates": {
    "KRW": 1390.5,
    "UAH": 41.8,
    "EUR": 0.92
  },
  "logisticsTariff": {
    "basis": "price",
    "priceCurrency": "KRW",
    "tiers": [
      { "maxPrice": 16000000, "costUsd": 4900 },
      { "minPrice": 16000000, "costUsd": 4400 }
    ]
  },
  "powerHp": 150,
  "batteryCapacityKwh": 64,
  "customsClearanceYearBufferMonths": 3,
  "sort": "newest",
  "offset": 0,
  "limit": 20,
  "filters": {
    "saleOnly": true,
    "brandId": "002",
    "modificationId": "136",
    "gradePath": ["008"],
    "fuelTypeIds": ["001", "002"],
    "colorIds": ["흰색"],
    "seatingCapacityIds": ["5"],
    "price": { "min": 15000, "max": 35000 },
    "year": { "min": 2020, "max": 2026 },
    "mileage": { "max": 100000 }
  }
}

vehicle: country, currency, and overrides

HTTP
GET /vehicles/encar_42247740
  ?lang=ru-MD
  &country=UA
  &customer=individual
  &currency=USD
  &rates=KRW:1390.5,UAH:41.8
  &logisticsTariff=price,currency:KRW,0-16000000:4900,16000000-:4400
  &powerHp=150
  &batteryCapacityKwh=64
  &certificationCost=7000
  &customsClearanceYearBufferMonths=3

insurance history and inspection report

HTTP
GET /vehicles/encar_42247740/history
  ?lang=ru-MD
  &currency=USD
  &rates=KRW:1390.5

GET /vehicles/encar_42247740/inspection?lang=ru-MD

Catalog

Reference endpoints for filters: brands, model groups, models, trims, and trim details.

GET /catalog/manufacturersGET /catalog/model-groupsGET /catalog/modelsGET /catalog/badgesGET /catalog/badge-details

Search

Both methods accept lang, country, customer, currency, exchangeRates, the logistics and pricing overrides, a standardized sort key, and structured filters: sale-only, grade cascade, colors, seat counts, and exact mileage. The price range refers to the landed total in the selected currency, not the raw Encar listing price.

POST /search/contextPOST /search

Vehicle page and reports

The vehicle endpoint returns localized data and detailed pricing for the selected country rules, while history and inspection add the insurance record and the inspected body zones. Ids are returned prefixed, for example encar_42247740.

GET /vehicles/:id?country=UA&currency=USDGET /vehicles/:id/historyGET /vehicles/:id/inspection

Integration

What your team gets

MotorFeed handles data retrieval, normalization, and market-specific charges for every supported jurisdiction, so your team can assemble the user journey faster.

No need to parse Encar's internal responses. The service returns a clear structure for your application.

Search works through clear filters: brand, model, modification, category, fuel, transmission, seat count, color, grade cascade, price, year, and an exact mileage range in kilometers. Every id is taken from /search/context, and for colors and grades Encar publishes its own Korean values — "흰색" is the id of white, with the readable name next to it in the same facet.

sort uses standardized keys — newest, firstListed, priceAsc, priceDesc, yearDesc, mileageAsc, mileageDesc — that the service maps to the marketplace's own upstream sorting.

The lang parameter accepts ru-MD, ro-MD, en-US, or ko-KR and localizes search, filters, and vehicle pages for the required interface language.

Client-side rates can be passed to calculate by your own bank, while the server fills any missing values.

country selects the calculation module for the target market — MD, RU, UA, or AE — customer clarifies the importer type, while currency sets the output currency for every amount.

logisticsCost overrides the built-in shipping estimate, and logisticsTariff accepts a whole rate card: a flat cost per fuel kind, or price tiers written in the currency you quote in.

powerHp, batteryCapacityKwh, certificationCost, and expertExaminationCost replace what a jurisdiction can only estimate, and anything still estimated stays flagged in the response.

customsClearanceYearBufferMonths prices the car against the year it will actually clear customs, so an autumn purchase is not quoted at this year's age.

A vehicle page can be extended with the insurance history and the inspection report: owner changes, accident payouts, and the repaired or replaced body zones with their spot on the damage drawings.

OpenAPI documents 401, 402, 403, and 429, and access can be restricted by IP and x-api-key.

Caching reduces unnecessary source requests, and vehicle pages have a fallback if the primary details source is unavailable.

Next step

Choose an integration scenario

You can first review the business capabilities or go straight to Telegram and explain where Encar data should be connected.

Want to connect the API to an existing product?

Message us in Telegram with the target country and which data you need: catalog, search, vehicle pages, history and inspection reports, or the full integration flow.