Global Auto Hub — Список объявлений

GET

/api/v2/encar/offers

Список объявлений

Фильтруемый постраничный список — сначала недавно изменённые. Возвращает конверты объявлений и мету пагинации.

Параметры запроса

Поле	Тип	Описание
page	int	Номер страницы (с 1). По умолч. 1. OFFSET — ок для мелких страниц; для глубокой/массовой выкачки используйте after_change_id (константное время).
limit	int	Размер страницы. По умолч. 20, макс 1000.
after_change_id · cursor	int64	Keyset-курсор для быстрой глубокой/массовой выкачки: подставьте meta.next_cursor из прошлого ответа; O(1) на любой глубине. next_cursor=0 = последняя страница.
mark · make	string	Марка / бренд (без регистра). Китайские источники: каноничный English (оригинал в extra_prep.make_zh).
model	string	Модель.
transmission_type	string	например automatic, manual.
color	string	Цвет.
body_type	string	Тип кузова.
fuel_type · engine_type	string	Тип топлива / двигателя, напр. petrol, diesel, ev.
year_from · year_to	int	Диапазон годов.
price_from · price_to	int	Диапазон цены, EUR.
km_age_from · km_age_to · km_from · km_to	int	Диапазон пробега, км.
lang	string	Язык значений: lang=ru возвращает характеристики (кузов/топливо/КПП/привод/цвет/продавец) на русском + карту labels. Марки/модели остаются на английском. По умолч. английский.

Запрос

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);

Ответ

{
  "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
  }
}