документация

Параметры поиска — GET /cars

Их можно сочетать в одном вызове. В ответе есть total, page, count и results[], поэтому листать можно по total без второго запроса.

parameter	what it does
manufacturer	Brand, as Encar writes it: BMW, Hyundai, Kia, Genesis, Mercedes-Benz, Audi.
model	Model name, e.g. X5 (G05). Partial names match, and a generation name narrows further: model=The New Carnival returns that generation alone, not the whole nameplate.
q	Free-text search across brand, model and badge. Aliases: keyword, search.
fuel	diesel · gasoline · hybrid · electric · lpg.
transmission	automatic · manual.
color	Exterior colour.
seats	Seat count: 5, 7, 9. Several at once as seats=7,9. The two ends are ranges, not counts — 2 means two seats or fewer and 10 means ten or more, which is how the source files them. A car's own figure comes back as details.seats from /car.
yearFrom / yearTo	Model year bounds, as plain years: 2018, 2024.
mileageFrom / mileageTo	Odometer bounds in kilometres.
priceFrom / priceTo	Price bounds in EUR — converted for you, not won.
sort	priceAsc or priceDesc. Left out, results come back newest first.
page	Page index, zero-based. Default 0.
count	Listings per page. Default 24, maximum 500.

Неизвестные параметры игнорируются, а не отклоняются: фильтр, которого нет в вашем тарифе, не сломает существующую интеграцию — он просто не сузит выдачу.

Разобранный пример

Дизельные BMW X5 дешевле 40 000 €, сначала самые дешёвые, по 24 на страницу. Весь запрос — это URL.

curl -H "x-api-key: avg_free_..." \
  "https://api.encar-api.com/api/cars?manufacturer=BMW&model=X5\
&fuel=diesel&priceTo=40000&sort=priceAsc&count=24"

← Вся документация

Получите свой API-ключ

Бесплатно · 100 запросов в сутки

Получить доступ →

Параметры поиска — GET /cars

Разобранный пример

Получите свой API-ключ

Читайте также