GET/carsЕкспорт

Експорт на автомобили с курсор

Поточно извличане на всички активни автомобили от вашите източници, с пълни доклади, чрез курсор от страна на сървъра. Предназначено за поддържане на локално копие в синхрон.

vehicle_type=automobile / 1 е по подразбиране; motorcycle / 2 избира мотоциклети в /search, /search/count и /cars. Използвайте същия тип в речниците.
Пълна вложеност: brands[] → models[] → generations[] → variants[] / trims[]. Всеки обект за марка, модел и поколение изисква id. ИЛИ между съседите и стойностите на variants/trims; И между условията в един клон. Липсващ или празен дочерен списък означава всички наследници. До 100 елемента в масив. Непознати или несъвместими ID дават празен резултат; невалиден формат — 422.
В /cars типът и цялата йерархия са фиксирани за курсора. Следвайте next_url без промени или подавайте само scroll_id. Редът на еквивалентни филтри може да се промени; нови условия или изрични филтри без кеширано състояние дават 422. Започнете нов курсор. Старите курсори без нови параметри запазват заявката си.
is_auction приема true/false/1/0. False включва false, null и липсващ флаг; без параметър няма филтър. Трябва да съвпада с is_leasing в една активна обява на разрешен домейн; други обяви могат да останат в listings[].
Задайте is_auction в първата заявка: next_url и scroll_id запазват стойността, включително false. Промяна на филтъра или изрична стойност без запазено състояние връща 422.
Започнете без scroll_id, след това заявявайте всеки next_url без промени, докато scroll_id стане null. Вижте ръководството за синхронизация.
limit е 1–500 (по подразбиране 500). scroll_time е 1–15 минути (по подразбиране 10).
Запазвайте domains[] и is_leasing непроменени през цялото обхождане. Промяната им връща 422.
total може да е null, ако записът му в кеша е изгубен.

Параметри на заявката

limitinteger1–500 · default 500

Елементи в партида. По подразбиране 500; максимум 500. За използваем експорт са нужни положителни стойности.

scroll_timeinteger1–15 · default 10

Живот на курсора в минути. По подразбиране 10, максимум 15.

scroll_idstring

Непрозрачен курсор от предходния отговор. За предпочитане е да следвате next_url.

domains[]integer[]≥ 1

Незадължителен обхват на източниците. Използвайте ID, върнати от GET /domains. Пропуснете, за да използвате всички активирани домейни. Повтаряйте параметъра със скоби: domains[]=33&domains[]=34. Всяко ID трябва да е активирано за този ключ.

is_leasingboolean

Незадължителен филтър за лизинг. Изпратете true (или 1) за обяви, изрично маркирани с is_leasing=true. Изпратете false (или 0), за да изключите true, включително съхранени false, null и липсващи полета. Пропуснете за липса на филтър за лизинг; празни или невалидни стойности връщат 422. Автомобилът трябва да има поне една съвпадаща активна обява в активирания/избрания обхват от домейни. Други обяви може да останат в отговора, затова автомобили със смесени типове обяви може да съвпаднат и с двете стойности. За /cars задайте го в първата заявка и следвайте next_url без промени; false се запазва. Продължаването само със scroll_id запазва филтъра. Промяната или добавянето на филтъра по време на обхождането връща 422. Ако кешираното състояние на филтъра е изгубено или обхождането е започнато преди въвеждането на този параметър, изрична стойност връща 422; започнете ново обхождане.

is_auctionboolean

Optional auction filter. Send true (or 1) for listings explicitly marked is_auction=true. Send false (or 0) to exclude true, including stored false, null and missing fields. Omit for no auction filter; empty or invalid values return 422. Combined is_auction and is_leasing must match the same listing. A car must have at least one matching active listing in the enabled/selected domain scope. Other listings can remain in the response, so cars with mixed listing types can match both values. For /cars, set this on the first request and follow next_url unchanged; false is preserved. Continuing with only scroll_id retains the filter. Changing or adding the filter mid-scroll returns 422. If cached filter state is lost or the scroll predates this parameter, an explicit value returns 422; start a new scroll.

vehicle_typestringdefault automobile

vehicle_type=automobile / 1 е по подразбиране; motorcycle / 2 избира мотоциклети в /search, /search/count и /cars. Използвайте същия тип в речниците.

interior_colors[]integer[]≤ 100 items

ID на цветовете на салона от речника за цветове. В списъка важи ИЛИ; липсващите стойности не съвпадат. Прилага се в /search, /search/count и /cars. Не променяйте при продължаване на scroll.

cylinders[]integer[]1–99 · ≤ 99 items

Точен брой цилиндри (1–99), ИЛИ в списъка; неизвестните стойности не съвпадат. Прилага се в /search, /search/count и /cars. Не променяйте при продължаване на scroll.

brands[0][id]integer≥ 1

Пълна вложеност: brands[] → models[] → generations[] → variants[] / trims[]. Всеки обект за марка, модел и поколение изисква id. ИЛИ между съседите и стойностите на variants/trims; И между условията в един клон. Липсващ или празен дочерен списък означава всички наследници. До 100 елемента в масив. Непознати или несъвместими ID дават празен резултат; невалиден формат — 422.

brands[0][models][]integer[]≥ 1 · ≤ 100 items

Старият brands[0][models][]=573 работи. За наследници използвайте brands[0][models][0][id]=573. Изчистете старото поле за ID преди обектите на моделите на същата марка, иначе PHP презаписва индекс 0.

brands[0][models][0][id]integer≥ 1

brands[0][models][0][generations][0][id]integer≥ 1

brands[0][models][0][generations][0][variants][]integer[]≥ 1 · ≤ 100 items

brands[0][models][0][generations][0][trims][]integer[]≥ 1 · ≤ 100 items

langstring

Локал на отговора. Преводите на опциите също са ограничени от езиците на акаунта. Страницата избира текущия си език автоматично.

Допълнителни полета на обяви

Заредете /listing-fields след проверка на ключа. Определенията, ограниченията, операторите и бележките важат само за този ключ и избраните домейни.

Низове: eq, in, exists. Числа и дати също gt, gte, lt, lte. Boolean: eq или exists. Изберете eq, in, exists или диапазон; exists самостоятелно. До 20 полета и 100 стойности в in.

Всички условия, домейни и активност трябва да съвпаднат в една обява. Нула и false са стойности. Масив съвпада при подходящ елемент. Непознати или недостъпни полета/оператори връщат 422.

Филтрирайте само filterable полета. Индексирани стойности: listings[].custom_fields; останалите: listings[].source_data. Публикуването включва филтрите, следващите обичайни импорти попълват стойности. Без обновяване на стари документи.

В /cars условията остават за целия scroll. Несъвместимо определение или загубено състояние изисква нов scroll. Сортиране и агрегации не се поддържат.

Заменете FIELD_KEY с ключ от достъпния каталог. За парични сравнения задайте валутата на обявата; преобразуването Buy Now не се прилага.

Историческите пазарни оценки от източника са справочни неиндексирани стойности. Описват сравними продажби, а не цената, офертата или резервната цена на тази обява. Проверявайте описанието на полето, критериите за сравнение и датата на изчисление; валутата на обявата не се подразбира. Регистрираните числови полета може да са null, когато няма оценка.

custom_fields[FIELD_KEY][gte]=2
custom_fields[FIELD_KEY][in][]=a&custom_fields[FIELD_KEY][in][]=b
custom_fields[FIELD_KEY][eq]=false
custom_fields[FIELD_KEY][lte]=15000&custom_fields[FIELD_KEY][currency]=cad

Допълнителни полета на обяви

Свържете ключ, за да видите полетата за достъпните домейни.

Връща · Партида пълни обекти Car в data, с next_url, scroll_id и total. Последната страница има scroll_id: null, празно data и message: "No more data".

GET/cars

curl -g "https://api.auctionsapi.com/cars?limit=5&api_key=$CARS_API_KEY" \
  -H "Accept: application/json"

ПримериЗаписан

{4 keys

"data": [1 item

0: {20 keys

"id": "290nw54Bkl-iPxZqEe_N"

"has_inspections": false

"has_history_reports": false

"year": 2007

"vin": "kmhdu46d27u158653"

"brand": {2 keys

}

"model": {2 keys

}

"engine_volume": 2000

"cylinders": 4

"body_type": {2 keys

}

"fuel": {2 keys

}

"color": {2 keys

}

"power_hp": 138

"market_origin": {2 keys

}

"drive_wheels": {2 keys

}

"option_ids": []

"listings": [1 item

]

"inspections": []

"vehicle_history_reports": []

"hash": "473326c69c007f50506c0cffdf30b08cf28e978d9ff2d5e7dca0dc75a54a3f6c"

}

]

"next_url": "https://api.carstat.dev/cars?scroll_id=FGluY2x1ZGVfY29udGV4dF91…&lang=en&api_key=YOUR_API_KEY&limit=2"

"scroll_id": "FGluY2x1ZGVfY29udGV4dF91…"

"total": 3217391

}

Вземете достъп до API

Свържете ключа си, за да изпълнявате всяка заявка от тези страници с вашите данни. Още нямате ключ? Поискайте ни демо ключ: същият JSON като в платените планове.

Имам ключ