MotorAPIs
Живий каталог
Отримати ключ

КазахстанМаркетплейс

Kolesa.kz API

Оголошення Kolesa.kz з Казахстану в JSON: ціна, пробіг, двигун і фото.

Отримати безкоштовний демо-ключ Читати документацію

На kolesa.kz

kolesa.kz

У вашому коді

{"vin": string"brand": { name }"model": { name }"year": number"listings": [{"external": {…}"price": {…}"odometer": {…}"is_auction": boolean"images": […]}]"inspections": […]"vehicle_history_reports": […]}

Назви полів – з реального запису; значення – це типи, а не дані.

Що таке Kolesa.kz?

01/ 06Про сайт

Про Kolesa.kz

Kolesa.kz – головний маркетплейс авто в Казахстані з дилерами та приватними продавцями по всій країні. MotorAPIs читає його оголошення в JSON поруч з OLX Kazakhstan.

Країна
Казахстан
Тип
Маркетплейс
API
api.motorapis.com
Сайт
kolesa.kz

Які дані я отримаю?

02/ 06Поля

Що ви отримуєте від Kolesa.kz

Кожне оголошення в спільному записі авто. Поля заповнюються, коли Kolesa.kz їх показує.

Авто

  • VIN, якщо сайт його показує
  • Марка, модель і покоління з одного спільного каталогу
  • Рік, пальне, коробка передач, двигун, потужність
  • Пробіг у км

Оголошення

  • Сайт і ID оголошення, посилання на оголошення
  • Ціна та валюта
  • Тип продавця та розташування
  • Фотогалерея
  • Опції комплектації

Звіти

  • Огляди, якщо опубліковані
  • Звіти з історії, якщо опубліковані

Одне авто, багато сайтів

  • Те саме авто на кількох сайтах – це одне авто
  • Продані авто залишаються доступними приблизно місяць

Як їх запитати?

03/ 06Запити

Три запити для початку

ID сайтів відрізняються для кожного ключа: один раз прочитайте їх із /domains, а потім фільтруйте за ними.

  1. 01Знайдіть ID сайту Kolesa.kz

    GET https://api.motorapis.com/domains
  x-api-key: YOUR_API_KEY

  2. 02Шукайте його авто

    GET https://api.motorapis.com/search?domains[]={domain_id}&perPage=20
  x-api-key: YOUR_API_KEY

  3. 03Вивантажте все й тримайте копію синхронізованою

    GET https://api.motorapis.com/cars?domains[]={domain_id}&limit=500
  x-api-key: YOUR_API_KEY

Що ще варто знати?

04/ 06Питання

Запитання про Kolesa.kz API

Які дані Kolesa.kz повертає API?
Кожне оголошення у вигляді стандартного запису авто: марка, модель і покоління зі спільного каталогу, рік, пробіг, ціна та валюта, розташування, фото й комплектація, а також огляди та звіти з історії, якщо Kolesa.kz їх публікує.
Як вибрати Kolesa.kz в API?
Один раз викличте /domains, щоб прочитати ID сайту Kolesa.kz для вашого ключа, а потім передавайте його як domains[] до /search або /cars.
Що, якщо те саме авто є на кількох сайтах?
Це одне авто з кількома оголошеннями. Кожне оголошення зберігає свій сайт, ID, ціну та посилання, тож ви бачите всі місця, де пропонують це авто.
Як тримати копію синхронізованою?
Використовуйте вивантаження /cars: почніть без курсора й переходьте за next_url, доки воно не завершиться. Запустіть його знову, щоб оновити копію.
Як спробувати?
Запросіть безкоштовний демо-ключ і вкажіть, які сайти вам потрібні. Він повертає реальні дані в тому самому JSON, що й платні тарифи.

Що ще підключено?

05/ 06Схожі

Пов’язані джерела

Усі джерела →

Готові спробувати?

06/ 06Старт

Дані Kolesa.kz у вашому продукті

Напишіть, які джерела вам потрібні. Ми відповімо письмово й надішлемо безкоштовний демо-ключ.

Безкоштовний демо-ключ

MotorAPIs – незалежний постачальник даних і не пов’язаний із Kolesa.kz. Назви й торговельні марки належать їхнім власникам.