/api/close/getAuc

This page provides developer-friendly documentation for retrieving auction lot data via /api/close/getAuc. Switch language, filter tables, and copy snippets.

Эта страница — удобная документация для разработчиков по получению данных лотов аукциона через /api/close/getAuc. Переключайте язык, фильтруйте таблицы и копируйте примеры.

GET / POSTGET / POST Pagination: 250 lots/page (production)Пагинация: 250 лотов/стр (production) Rate limit: 1 request / 5 secondsЛимит: 1 запрос / 5 секунд

Go to examplesК примерам

Test vs ProductionTest vs Production

If key contains test, API works in test mode: page is ignored and a limited dataset is returned.

Если key содержит test, API работает в тестовом режиме: page игнорируется и возвращается ограниченный набор данных.

Images domainДомен изображений

Field images contains relative URLs. Domain: https://img.motopodbor.com.

Поле images содержит относительные URL. Домен: https://img.motopodbor.com.

Дополнительная информация о работе APIAdditional API Info

Ниже описаны важные особенности выдачи данных, обновлений и жизненного цикла лотов.

1. Доступность данных и жизненный цикл лотов

Актуальные торги: API предоставляет информацию о лотах, которые торгуются в день запроса, а также о будущих аукционах.
Удаление из выдачи (архивация): перенос данных в архив происходит ежедневно в 21:00 UTC.

Важно

В момент перехода в архив (21:00 UTC) данные лоты перестают отображаться в выдаче API. Если вам необходимо сохранять результаты торгов, это должно быть реализовано на стороне вашего приложения до наступления указанного времени.

2. Регламент обновления

Обновление информации проходит ежедневно, кроме воскресенья:

Период обновления: с 01:00 до 12:00 UTC.
График синхронизирован с часами работы аукционных площадок.

3. Специфика параметров техники

Год выпуска (объем < 300 см³): аукционы официально не предоставляют год выпуска для малокубатурной техники. Мы дополняем эти данные из сторонних источников по номеру рамы (если это технически возможно).
Поле original_model: чтобы избежать ошибок интерпретации, помимо стандартных brand и model, мы передаем параметр original_model — точное название модели в том виде, как оно указано в системе аукциона.

4. Накопление статистики

Сервис не предоставляет доступ к историческим данным через текущую выдачу. Накопление собственной базы статистики продаж является задачей клиента.

Below are important details about data output, updates, and the auction lots lifecycle.

1. Data Availability and Archiving

Current Auctions: The API provides data on auctions taking place on the day of the request, as well as upcoming scheduled auctions.
Archiving Policy: Every day at 21:00 UTC, current auction data is moved to the archive.

Important

Once moved to the archive (21:00 UTC), these lots are removed from the API output and will no longer be available in requests. If you need to store auction results, this must be implemented on the client side before the archiving time.

2. Update Schedule

Auction data is updated daily, except for Sundays:

Update Window: From 01:00 to 12:00 UTC.
This timeframe is aligned with the active working hours of the auction platforms.

3. Vehicle Data Specifications

Manufacturing Year (Engine < 300cc): Auctions do not officially provide the production year for vehicles with an engine displacement of less than 300cc. We attempt to retrieve this information from third-party sources using the frame number whenever possible.
original_model Field: Along with the standard brand and model parameters, we provide original_model — the model name exactly as it appears on the original auction website.

4. Sales Statistics

The API is designed for active and upcoming auctions only. Collecting and storing sales statistics is the sole responsibility of the client. Historical data is not accessible via standard API calls.

1. OverviewОбзор

SectionРаздел 1

This API endpoint retrieves auction lot data. It supports both production and test modes. In production mode, data is paginated with 250 records per page, while in test mode the page parameter is ignored and a limited dataset is returned. The API returns detailed information for each auction lot along with the total number of pages (in production).

Эта конечная точка API возвращает данные о лотах аукциона. API поддерживает как рабочий (production), так и тестовый режим. В рабочем режиме данные разбиваются на страницы по 250 записей, а в тестовом режиме параметр страницы игнорируется, и возвращается ограниченный набор данных. API возвращает подробную информацию для каждого лота аукциона, а также общее количество страниц (в рабочем режиме).

2. EndpointКонечная точка

Base infoОсновное

ItemПункт	ValueЗначение
URL	`/api/close/getAuc`
MethodМетод	GET or POST

3. Request ParametersПараметры запроса

Parameters tableТаблица параметров

ParameterПараметр	TypeТип	RequiredОбяз.	Description (EN)	Описание (RU)
key	string	Yes	Your API key. If the key contains the substring "test", the API operates in test mode.	Ваш API-ключ. Если ключ содержит подстроку "test", API работает в тестовом режиме.
page	integer	No	The page number to retrieve (250 records per page). Ignored in test mode.	Номер страницы для выборки данных (на странице 250 записей). Игнорируется в тестовом режиме.
lang	string	No	Response language. Allowed values: `ru` (default) or `en`. If not specified, Russian (`ru`) will be used.	Язык ответа. Допустимые значения: `ru` (по умолчанию) или `en`. Если параметр не указан, используется русский (`ru`).

Quick cURL builderБыстрый генератор cURL

API key API key

Page (production) Страница (production)

curl Copy and run Скопируйте и запустите

4. Rate LimitingОграничение запросов

LimitsЛимиты

Test Mode: Allowed once every 5 seconds.
Production Mode: Allowed once every 5 seconds.
Тестовый режим: Разрешён один запрос каждые 5 секунд.
Рабочий режим: Разрешён один запрос каждые 5 секунд.

If a request is made before the allowed interval, the API returns an error message.

Если запрос выполнен раньше установленного интервала, API возвращает сообщение об ошибке.

5. Response StructureСтруктура ответа

Success / ErrorУспех / Ошибка

On success, the API returns a JSON object with:

При успехе API возвращает JSON-объект:

status: "success"
lots: An array of auction lot objects.
total_pages: (Production mode only) The total number of pages available.
status: "success"
lots: Массив объектов лотов аукциона.
total_pages: (Только production) Общее количество страниц.

On error:

При ошибке:

status: "error"
message: A description of the error.
status: "error"
message: Описание ошибки.

6. Auction Lot Object FieldsПоля объекта лота аукциона

Fields table (filterable)Таблица полей (с фильтром)

FieldПоле	TypeТип	Description (EN)	Описание (RU)
lot_id	string	Unique lot identifier	Уникальный идентификатор лота
auction_date	integer	Unix timestamp of the auction date.	Unix timestamp даты аукциона.
line	string	Auction line.	Линия аукциона.
hub	string	Auction hub.	Хаб аукциона.
auction	string	Auction code.	Код аукциона.
status	integer	Auction status. If status equals 1, the lot is inspected; otherwise, it is not inspected.	Статус аукциона. Если status равен 1, лот осмотрен; в противном случае – не осмотрен.
availability	integer	Availability flag. 1: Sold, 2: Not sold, 4: Canceled; any other value means "for sale".	Флаг доступности. 1 – Продан, 2 – Не продан, 4 – Отменен; любое другое значение означает "в продаже".
bid	integer	Bid number.	Номер лота.
brand	string	Brand name.	Название бренда.
model	string	Model name.	Название модели.
cover	integer	Cover information.	Информация об cover.
frame	string	Frame number.	Номер рамы.
engine	string	Engine number.	Номер двигателя.
mileage	integer	Mileage.	Пробег.
mileage_name	string	Mileage. m – miles, km – kilometers	Пробег. m – мили, km – километры
mileage_type	integer	0: No notes, 1: Doubt about mileage veracity, 2: Speedometer replaced, 3 – Service odometer replacement	0 – пометок нет, 1 – сомнение в правдивости пробега, 2 – спидометр заменён, 3 – Сервисная замена спидометра
inspection	integer	Inspection value.	Показатель осмотра.
history	string	Auction history.	История лота.
color	string	Vehicle color.	Цвет лота.
volume	integer	Engine volume.	Объём двигателя.
year	integer	Production year.	Год выпуска.
registration	string	Registration details.	Регистрационные данные.
number	string	Vehicle number.	Номер лота.
price_start	integer	Starting price.	Стартовая цена.
price_finish	integer	Final price.	Конечная цена.
comment_auction	string	Auction comment.	Комментарий аукциона.
sales_data	string	Sales data information.	Данные по продажам.
comment_seller	string	Seller comment.	Комментарий продавца.
rank	float	Overall rank.	Общая оценка.
ranks	array	Array of rank objects.	Массив объектов оценок.
updated	integer	Unix timestamp of the last update.	Unix timestamp последнего обновления.
added	integer	Unix timestamp when the record was added.	Unix timestamp добавления записи.
images	array	(Content and links may change!) Array of image URLs. Image types: 55 indicates video, 54 indicates main photo; other types match rank IDs. (domain https://img.motopodbor.com)	(Контент и ссылки могут изменяться!) Массив URL фотографий. Типы: 55 – видео, 54 – основные фото; другие типы соответствуют ID оценок. (домен https://img.motopodbor.com)
images_v2	object	(Content and links may change!) Structured images grouped by purpose (default angles, auction sheet, video) and (for some auctions) by rank categories. Build full URLs using https://img.motopodbor.com + path. Details & examples — see section 10.	(Контент и ссылки могут изменяться!) Структурированные изображения: группировка по назначению (ракурсы, аукционный лист, видео) и (для некоторых аукционов) по категориям оценок. Полные URL: https://img.motopodbor.com + путь. Подробнее и примеры — в пункте 10.
jba_dop_info	object	Additional information for lots with `auction = JBA`. Only present if `auction = JBA`.	Дополнительная информация для лотов с `auction = JBA`. Отображается только для таких лотов.

7. jba_dop_info Object FieldsПоля объекта jba_dop_info

The jba_dop_info object provides additional detailed evaluation information for auction lots with auction = JBA. Below is the description of its fields.

Объект jba_dop_info предоставляет дополнительную информацию по оценке лотов аукциона с auction = JBA. Ниже приведено описание его полей.

jba_dop_info

FieldПоле	TypeТип	Description (EN)	Описание (RU)
flag_document	string	Document flag. "1" indicates documents are in order; "0" means documents are not in order.	Флаг документации. "1" означает, что документы в порядке, "0" – что документы не в порядке.
flag_not_working_engine	string	Engine functionality flag. "0" indicates the engine is working; "1" indicates it is not working.	Флаг работоспособности двигателя. "0" – двигатель работает, "1" – не работает.
flag_dtp	string	Accident flag. "0" indicates no accident history; "1" indicates an accident occurred.	Флаг ДТП. "0" означает отсутствие ДТП, "1" — наличие ДТП.
overal_rating	string	Overall rating as a numeric string (e.g., "3").	Общая оценка в виде числовой строки (например, "3").
appearance_rating	string	Appearance rating. Possible values: S, A, B, C, D, E.	Оценка внешнего вида. Возможные значения: S, A, B, C, D, E.
engine_rating	string	Engine rating. Possible values: S, A, B, C, D, E.	Оценка двигателя. Возможные значения: S, A, B, C, D, E.
frame_rating	string	Frame rating. Possible values: S, A, B, C, D, E.	Оценка рамы. Возможные значения: S, A, B, C, D, E.
shaken	string	Shaken status or additional notes regarding shaking; may be empty if not applicable.	Статус тряски или дополнительные примечания по поводу тряски; может быть пустым, если не применимо.
suspension_rating	string	Suspension rating. Possible values: S, A, B, C, D, E.	Оценка подвески. Возможные значения: S, A, B, C, D, E.

Possible RatingsВозможные оценки

S–E

Rating mappingРасшифровка

Rating	English Meaning	Russian Meaning
S	New	Новый
A	Excellent	Отлично
B	Good	Хорошо
C	Satisfactory	Удовлетворительно
D	Poor	Плохо
E	Significant wear	Значительный износ

8. IAUC comment_auction DataДанные comment_auction для auction = IAUC

Structure & mappingСтруктура и соответствия

If auction equals IAUC, the comment_auction field contains a JSON string with detailed evaluation data. The JSON structure is:

Если auction равно IAUC, то поле comment_auction содержит строку JSON с подробными данными оценки. Структура JSON:

json

Mapping for the arrays:Соответствие элементов массивов:

changes items correspond to: ["Steering Wheel","Mirrors","Turn Signals","Speedometer","Fenders","Seat","Footrests","Muffler (canister)","Muffler (highway)","Shock Absorber"]
equipment items correspond to: ["Red Key","No Documents","Spare Key","Instruction Manual","Customs"]
Элементы массива changes соответствуют: ["Руль","Зеркала","Поворотники","Спидометр","Крылья","Сиденье","Подножки","Глушитель (банка)","Глушитель (трасса)","Амортизатор"]
Элементы массива equipment соответствуют: ["Красный ключ","Нет документов","Запасной ключ","Инструкция","Таможня"]

Example:Пример:

json

9. ARAI dop_info Object FieldsПоля объекта arai_dop_info

The arai_dop_info object provides additional detailed evaluation information for auction lots with auction = ARAI. This object appears only if auction = ARAI.

Объект arai_dop_info предоставляет дополнительную информацию по оценке лотов аукциона с auction = ARAI. Этот объект отображается только если auction = ARAI.

arai_dop_info

FieldПоле	TypeТип	Description (EN)	Описание (RU)
engine_rating	string	Engine rating. Possible values: S, A, B, C, D, E, X.	Оценка двигателя. Возможные значения: S, A, B, C, D, E, X.
frame_rating	string	Frame rating. Possible values: S, A, B, C, D, E, X.	Оценка рамы. Возможные значения: S, A, B, C, D, E, X.
appearance_rating	string	Appearance rating. Possible values: S, A, B, C, D, E, X.	Оценка внешнего вида. Возможные значения: S, A, B, C, D, E, X.
suspension_rating	string	Suspension rating. Possible values: S, A, B, C, D, E, X.	Оценка подвески. Возможные значения: S, A, B, C, D, E, X.

10. images_v2 — grouped images & videosimages_v2 — группировка фото и видео

Field images_v2 is a normalized, developer-friendly representation of media. It groups photos by purpose (default angles, auction sheet, ranks, video) and always keeps the same item shape. All URLs inside are relative — prepend domain https://img.motopodbor.com.

Поле images_v2 — это нормализованное и удобное для разработки представление медиа. Оно группирует фото по назначению (основные ракурсы, лист аукциона, группы оценок, видео) и держит единый формат элементов. Все URL внутри — относительные — добавляйте домен https://img.motopodbor.com.

Structure & rulesСтруктура и правила

json Structure Структура

GroupsГруппы

PathПуть	TypeТип	Meaning (EN)	Значение (RU)
`images_v2.default`	array<image>	Main photos (angles). Often includes `name_type`.	Основные фото (ракурсы). Часто есть `name_type`.
`images_v2.auction_sheet`	array<image>	Auction sheet scans/photos.	Скан/фото аукционного листа.
`images_v2.video`	array<image>	Video items (usually `type=55`, `big` is `.mp4`).	Видео (обычно `type=55`, `big` — `.mp4`).
`images_v2.ranks`	object<string, array<image>>	Photos grouped by inspection sections (keys are stable internal names; do not rely on localization). Often matches rank groups and/or IDs.	Фото, сгруппированные по разделам осмотра (ключи — стабильные внутренние имена; не завязаны на локализацию). Часто соответствует группам/ID оценок.
`images_v2.*`	array<image> / object	New groups may appear. Treat arrays as `image` items with the same shape.	Могут появляться новые группы. Массивы обрабатывайте как элементы `image` единого формата.

Image item fieldsПоля элемента изображения

FieldПоле	TypeТип	Description (EN)	Описание (RU)
type	integer	Media type code. Common: 54 photo, 55 video. Other values may match inspection/rank IDs.	Код типа медиа. Часто: 54 фото, 55 видео. Другие значения могут совпадать с ID оценок/разделов.
big	string	Relative URL to full-size image / video (`.jpg` or `.mp4`).	Относительный URL на большой размер / видео (`.jpg` или `.mp4`).
small	string	Relative URL to preview (thumbnail).	Относительный URL на превью (миниатюру).
name_type (optional)	string	Angle/role hint for UI (e.g. `front_left`, `back_right`, `auction_sheet`).	Подсказка по роли/ракурсу для UI (например `front_left`, `back_right`, `auction_sheet`).

js Build full URL Сборка полного URL

Examples: BDS / AUCNET (IAUC) / JBA / ARAI Примеры: BDS / AUCNET (IAUC) / JBA / ARAI

Below are extracted images_v2 blocks from the same demo lots used in examples.

Ниже — извлечённые блоки images_v2 из тех же демонстрационных лотов, что и в примерах.

BDS

jsonimages_v2

AUCNET / IAUC

jsonimages_v2

JBA

jsonimages_v2

ARAI

jsonimages_v2

Quick snippetsБыстрые сниппеты

CopyКопировать

EndpointEndpoint

http/api/close/getAuc

GET /api/close/getAuc
POST /api/close/getAuc

Minimal requestМинимальный запрос

curl

curl -G "https://motopodbor.com/api/close/getAuc" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "lang=ru"

NotesЗаметки

In production: 250 records per page.
В production: 250 записей на страницу.
In test mode: page is ignored.
В test mode: page игнорируется.
Requests are limited to once per 5 seconds.
Запросы ограничены: 1 раз в 5 секунд.

★ Examples (BDS / ARAI / AUCNET / JBA)Примеры (BDS / ARAI / AUCNET / JBA)

RU/EN switch affects examplesПереключение RU/EN меняет примеры

Below are example responses (one lot per auction type).

Ниже — примеры ответов (по одному лоту на тип аукциона).

curlRequestЗапрос

jsonResponseОтвет

curlRequestЗапрос

jsonResponseОтвет

curlRequestЗапрос

jsonResponseОтвет

curlRequestЗапрос

jsonResponseОтвет