GET
/api/v2/encar/offers

List offers

Filtered, paginated list — newest-changed first. Returns offer envelopes + pagination meta.

Query parameters
FieldTypeDescription
page intPage number (1-based). Default 1. OFFSET paging — fine for shallow pages; for deep/bulk download use after_change_id (constant-time).
limit intPage size. Default 20, max 1000.
after_change_id · cursorint64Keyset cursor for fast deep/bulk download: pass the previous response meta.next_cursor; O(1) at any depth. next_cursor=0 = last page.
mark · makestringMake / brand (case-insensitive). Chinese sources: canonical English (original in extra_prep.make_zh).
model stringModel.
transmission_type stringe.g. automatic, manual.
color stringColour.
body_type stringBody shape.
fuel_type · engine_typestringFuel / engine type, e.g. petrol, diesel, ev.
year_from · year_to intYear range.
price_from · price_to intPrice range, EUR.
km_age_from · km_age_to · km_from · km_tointMileage range, km.
lang stringValue language: lang=ru returns characteristic values (body/fuel/transmission/drive/colour/seller) in Russian + a labels map. Brands/models stay English. Default English.
Request
curl -s 'https://global-auto-hub.ru/api/v2/encar/offers?page=1&mark=Hyundai&api_key=YOUR_API_KEY'
import requests
r = requests.get("https://global-auto-hub.ru/api/v2/encar/offers?page=1&mark=Hyundai&api_key=YOUR_API_KEY")
print(r.json())
const r = await fetch("https://global-auto-hub.ru/api/v2/encar/offers?page=1&mark=Hyundai&api_key=YOUR_API_KEY");
const data = await r.json();
console.log(data);
Response
{
  "result": [
    {
      "id": 3219435,
      "inner_id": "40427050",
      "change_type": "added",
      "created_at": "2026-06-16T12:02:03Z",
      "data": {
        "inner_id": "40427050",
        "url": "https://www.encar.com/...",
        "source": "encar",
        "mark": "Hyundai",
        "model": "Palisade",
        "year": 2021,
        "body_type": "SUV",
        "fuel_type": "diesel",
        "transmission": "automatic",
        "km_age": 92842,
        "color": "Black",
        "price": {
          "raw": 31900000,
          "currency": "KRW",
          "usd": 23100,
          "eur": 21300
        },
        "city": "Busan",
        "is_dealer": true,
        "images": [
          "https://cdn.encar.com/.../001.jpg",
          "…25 photos"
        ],
        "status": "active"
      }
    }
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20,
    "next_cursor": 18202296
  }
}
We reply in 2 min