GET /user/offers/{category}
Возвращает список объявлений пользователя.
Формат запроса
GET https://apiauto.ru/1.0/user/offers/{category}
? [page=<integer>]
& [page_size=<integer>]
& [truck_category=<string>]
& [moto_category=<string>]
& [status=<array[string]>]
& [service=<array[string]>]
& [vin=<array[string]>]
& [mark_model=<array[string]>]
& [price_from=<integer>]
& [price_to=<integer>]
& [section=<string>]
& [create_date_from=<string>]
& [create_date_to=<string>]
& [no_active_services=<boolean>]
& [ban_reason=<array[string]>]
& [sort=<string>]
& [auction=<boolean>]
category |
Название категории ТС. Допустимые значения:
|
page |
Вывести результаты, начиная с указанной страницы. Страницы нумеруются с единицы (1). Допустимые значения: от 1 до 1000. |
page_size |
Количество объявлений на странице. Внимание Максимальное допустимое значение — 100 объявлений на страницу. При превышении этого значения доступ к API будет ограничен. Подробнее можно узнать в разделе Ограничения по использованию ресурсов API. |
truck_category |
Категория коммерческого транспорта. Допустимые значения:
|
moto_category |
Категория мототранспорта. Допустимые значения:
|
status |
Статус объявления. Допустимые значения:
Примечание Если вы хотите добавить больше одного значения, укажите параметр несколько раз:
|
service |
Подключенные услуги. Допустимые значения:
Примечание Если вы хотите добавить больше одного значения, укажите параметр несколько раз:
|
vin |
VIN-номера. Примечание Если вы хотите добавить больше одного значения, укажите параметр несколько раз:
|
mark_model |
Идентификаторы марки и модели, разделенные закодированным символом «#» (%23), например «MERCEDES%23C_KLASSE». Идентификатор модели может отсутствовать. Примечание Если вы хотите добавить больше одного значения, укажите параметр несколько раз:
|
price_from |
Стоимость транспорта в выбранной валюте (например, российский рубль), от. |
price_to |
Стоимость транспорта в выбранной валюте (например, российский рубль), до. |
section |
Состояние транспортного средства. Допустимые значения:
|
create_date_from |
Дата создания объявления в формате ISO 8601 со смещением относительно UTC. Например, |
create_date_to |
Дата создания объявления в формате ISO 8601 со смещением относительно UTC. Например, |
no_active_services |
Фильтр. Показывает объявления без примененных услуг. |
ban_reason |
Причина блокировки объявления. Подробнее с описанием причин блокировки можно ознакомиться в Справочнике причин блокировки. |
sort |
Тип сортировки объявлений. Допустимые значения:
|
auction |
Фильтр. Показывает объявления, участвующие в аукционе. |
Заголовки запроса
Заголовок |
Описание |
|
Идентификатор клиента. Используется для работы под учетной записью агентства. |
|
Идентификатор сессии пользователя. Значение можно получить с помощью операции POST /auth/login. |
Общая структура ответа приведена ниже. Порядок следования элементов не гарантируется. В структуре могут присутствовать служебные параметры, которые не описаны в таблице.
Формат ответа
{
"offers": [
{
"car_info": {
"armored": {boolean},
"body_type": "{string}",
"engine_type": "{string}",
"transmission": "{string}",
"drive": "{string}",
"mark": "{string}",
"model": "{string}",
"super_gen_id": "{string}",
"configuration_id": "{string}",
"tech_param_id": "{string}",
"complectation_id":"{string}",
"equipment":{
"{string}":{boolean},
"{string}":{boolean}
},
"manufacturer_info": {
"modification_code": "{string}",
"interior_code": "{string}",
"color_code": "{string}",
"equipment_code": "{string}"
},
"steering_wheel": "{string}",
"horse_power": {integer},
"mark_info": {
"code": "{string}",
"name": "{string}",
"ru_name": "{string}",
"logo": {
"name": "{string}",
"sizes": {
"{string}":"{string}",
"{string}":"{string}"
}
}
},
"model_info": {
"code": "{string}",
"name": "{string}",
"ru_name": "{string}"
},
"super_gen": {
"id": "{string}",
"name": "{string}",
"ru_name": "{string}",
"year_from": {integer},
"year_to": {integer},
"price_segment": "{string}",
"purpose_group": "{string}"
},
"configuration": {
"id": "{string}",
"body_type": "{string}",
"doors_count": {integer},
"auto_class": "{string}",
"human_name": "{string}"
},
"tech_param": {
"id": "{string}",
"name": "{string}",
"nameplate": "{string}",
"displacement": {integer},
"engine_type": "{string}",
"gear_type": "{string}",
"transmission": "{string}",
"power": {integer},
"power_kvt": {integer},
"human_name": "{string}"
},
"complectation": {
"id": "{string}",
"name": "{string}"
},
"vendor": "{string}"
},
"truck_info":{
"truck_category": "{string}",
"mark": "{string}",
"model": "{string}",
"displacement": {integer},
"horse_power": {integer},
"loading": {integer},
"axis": {integer},
"seats": {integer},
"cabin": "{string}",
"steering_wheel": "{string}",
"engine": "{string}",
"transmission": "{string}",
"gear": "{string}",
"wheel_drive": "{string}",
"saddle_height": "{string}",
"brakes": "{string}",
"euro_class": "{string}",
"cabin_suspension": "{string}",
"suspension": "{string}",
"chassis_suspension": "{string}",
"bus_type": "{string}",
"trailer_type": "{string}",
"swap_body_type": "{string}",
"truck_type": "{string}",
"light_truck_type": "{string}",
"agricultural_type": "{string}",
"construction_type": "{string}",
"autoloader_type": "{string}",
"dredge_type": "{string}",
"bulldozer_type": "{string}",
"municipal_type": "{string}",
"body_type": "{string}",
"equipment": {
"{string}":{boolean},
"{string}":{boolean}
},
"operating_hours": {integer},
"load_height": {integer},
"crane_radius": {integer},
"bucket_volume": {integer},
"traction_class": "{string}",
"mark_info": {
"code": "{string}",
"name": "{string}",
"ru_name": "{string}",
"logo": {
"name": "{string}",
"sizes": {
"{string}":"{string}",
"{string}":"{string}"
}
}
},
"model_info": {
"code": "{string}",
"name": "{string}",
"ru_name": "{string}"
}
},
"moto_info": {
"moto_category": "{string}",
"mark": "{string}",
"model": "{string}",
"displacement": {integer},
"horse_power": {integer},
"engine": "{string}",
"transmission": "{string}",
"gear": "{string}",
"moto_type": "{string}",
"atv_type": "{string}",
"snowmobile_type": "{string}",
"cylinder_order": "{string}",
"cylinder_amount": "{string}",
"stroke_amount": "{string}",
"equipment": {
"{string}":{boolean},
"{string}":{boolean}
},
"mark_info": {
"code": "{string}",
"name": "{string}",
"ru_name": "{string}",
"logo": {
"name": "{string}",
"sizes": {
"{string}":"{string}",
"{string}":"{string}"
}
}
},
"model_info": {
"code": "{string}",
"name": "{string}",
"ru_name": "{string}"
}
},
"url": "{string}",
"mobile_url": "{string}",
"color_hex": "{string}",
"status": "{string}",
"category": "{string}",
"section": "{string}",
"availability": "{string}",
"price_info": {
"price": {double},
"currency": "{string}",
"create_timestamp": "{string}",
"rur_price": {double},
"usd_price": {double},
"eur_price": {double}
},
"discount_options": {
"tradein": {integer},
"insurance": {integer},
"credit": {integer}
},
"description": "{string}",
"documents": {
"owners_number": {integer},
"pts_original": {boolean},
"pts": "{string}",
"custom_cleared": {boolean},
"purchase_date": {
"year": {integer},
"month": {integer},
"day": {integer}
},
"year": {integer},
"sts": "{string}",
"vin": "{string}",
"warranty": {boolean},
"warranty_expire": {
"year": {integer},
"month": {integer},
"day": {integer}
},
"license_plate": "{string}",
"vin_resolution": "{string}"
},
"state": {
"mileage": {integer},
"state_not_beaten": "{string}",
"condition": "{string}",
"video": {
"yandex_id": "{string}",
"youtube_url": "{string}"
},
"damages": [
{
"car_part":"{string}",
"type":[
"{string}"
],
"description":"{string}"
}
],
"image_urls":[
{
"name":"{string}",
"sizes":{
"{string}":"{string}",
"{string}":"{string}"
}
}
],
"upload_url":"{string}",
"disable_photo_reorder": {boolean},
"hide_license_plate": {boolean},
"panoramas": {
"spincar_exterior_url": "{string}"
}
},
"id": "{string}",
"user_ref": "{string}",
"additional_info": {
"is_owner": {boolean},
"original_id": "{string}",
"hidden": {boolean},
"is_on_moderation": {boolean},
"not_disturb": {boolean},
"exchange": {boolean},
"haggle": {boolean},
"accepted_autoru_finance": {boolean},
"fresh_date": "{string}",
"expire_date": "{string}",
"update_date": "{string}",
"actualize_date": "{string}",
"creation_date": "string",
"remote_id": "{string}",
"remote_url": "{string}",
"cert_request_available": "{string}"
},
"actions": {
"edit": {boolean},
"activate": {boolean},
"hide": {boolean},
"archive": {boolean}
},
"counters": {
"all": {integer},
"daily": {integer},
"phone_all": {integer},
"phone_daily": {integer}
},
"search_position": {integer},
"tags": [
"{string}",
"{string}"
],
"is_favorite": {boolean},
"note": "{string}",
"seller_type": "{string}",
"salon": {
"salon_id": "{string}",
"name": "{string}",
"is_oficial": {boolean},
"phones": [
{
"phone": "{string}",
"call_hour_start": {integer},
"call_hour_end": {integer},
"original": "{string}",
"mask": "{string}",
"title": "{string}"
}
],
"place": {
"address": "{string}",
"coord": {
"latitude": {double},
"longitude": {double}
},
"geobase_id": "{string}",
"region_info": {
"id": "string",
"name": "{string}",
"genitive": "{string}",
"dative": "{string}",
"accusative": "{string}",
"prepositional": "{string}",
"preposition": "{string}",
"latitude": {double},
"longitude": {double},
"sub_title":"{string}",
"supports_geo_radius":{boolean},
"default_radius":{integer},
"children":[...],
"parent_ids":[
{integer},
{integer}
]
},
"metro": [
{
"rid": {integer},
"name": "{string}",
"distance": {double},
"location": {
"latitude": {double},
"longitude": {double}
},
"lines": [
{
"name": "{string}",
"color": "{string}"
}
]
}
]
},
"offers_count": {integer},
"edit_contact": {boolean},
"edit_address": {boolean},
"code": "{string}",
"registration_date": "{string}",
"client_id": "{string}",
"logo_url": "{string}",
"loyalty_program": {boolean},
"phone_callback_forbidden": {boolean}
},
"seller": {
"name": "{string}",
"phones": [
{
"phone": "{string}",
"call_hour_start": {integer},
"call_hour_end": {integer},
"original": "{string}",
"mask": "{string}",
"title": "{string}"
}
],
"redirect_phones": {boolean},
"chats_enabled": {boolean},
"location": {
"address": "{string}",
"coord": {
"latitude": {double},
"longitude": {double}
},
"geobase_id": "{string}",
"region_info": {
"id": "string",
"name": "{string}",
"genitive": "{string}",
"dative": "{string}",
"accusative": "{string}",
"prepositional": "{string}",
"preposition": "{string}",
"latitude": {double},
"longitude": {double},
"sub_title":"{string}",
"supports_geo_radius":{boolean},
"default_radius":{integer},
"children":[...],
"parent_ids":[
{integer},
{integer}
]
},
"metro": [
{
"rid": {integer},
"name": "{string}",
"distance": {double},
"location": {
"latitude": {double},
"longitude": {double}
},
"lines": [
{
"name": "{string}",
"color": "{string}"
}
]
}
]
},
"unconfirmed_email": "{string}",
"custom_phones": {boolean},
"custom_location": {boolean}
},
"services": [
{
"service": "{string}",
"is_active": {boolean},
"expire_date": "{string}",
"create_date": "{string}",
"badge": "{string}",
"prolongable": {boolean}
}
],
"service_prices":[
{
"service": "{string}",
"name": "{string}",
"description": "{string}",
"price": {double},
"currency": "{string}"
}
],
"badges": [
"{string}",
"{string}"
],
"discount_price": {
"price": {double},
"status ": "{string}"
},
"price_history": [
{
"price": {double},
"currency": "{string}",
"create_timestamp": "{string}",
"rur_price": {double},
"usd_price": {double},
"eur_price": {double}
}
],
"reasons_ban": [
"{string}",
"{string}"
],
"human_reasons_ban": [
{
"title": "{string}",
"text": "{string}",
"text_app": "{string}"
}
],
"feedprocessor_unique_id": "{string}",
"service_schedules": {
"products": "{string}"
},
"created": "{string}",
"autostrategies": [
{
"offer_id": "{string}",
"from_date": "{string}",
"to_date": "{string}",
"max_applications_per_day": {integer},
"always_at_first_page": {
"for_mark_model_listing": {boolean},
"for_mark_model_generation_listing": {boolean}
}
}
]
},
{
...
}
],
"pagination": {
"page": {integer},
"page_size": {integer},
"total_offers_count": {integer},
"total_page_count": {integer}
},
"filters": {
"truck_category": [
"{string}",
"{string}"
],
"moto_category": [
"{string}",
"{string}"
],
"status": [
"{string}",
"{string}"
],
"service": [
"{string}",
"{string}"
],
"vin": [
"{string}",
"{string}"
],
"mark_model": [
"{string}",
"{string}"
],
"price_from": {integer},
"price_to": {integer},
"section": "{string}",
"create_date_from": "{string}",
"create_date_to": "{string}",
"no_active_services": {boolean},
"ban_reason": [
"{string}",
"{string}"
]
},
"sorting": {
"name": "{string}",
"desc": {boolean}
},
"auction": {
"state": {
"current_bid": 100000,
"base_price": 100,
"min_bid": 10000,
"max_bid": 1290000,
"one_step": 10000,
"limit_exceeded": false
},
"segments": [
{
"percent": 5,
"min_bid": 100,
"max_bid": 50000,
"current": true
}
]
},
"status": "{string}"
}
offers |
Массив объявлений. |
-
car_info
Информация о легковом автомобиле.
-
armored
Признак бронированного автомобиля.
Допустимые значения:
true
— бронированный автомобиль;false
— не бронированный автомобиль;
body_type
Тип кузова автомобиля. Список допустимых значений смотрите в Справочнике типов кузова.
engine_type
Тип двигателя.
Допустимые значения:
DIESEL
— дизель;ELECTRO
— электро;GASOLINE
— бензин;HYBRID
— гибрид;LPG
— ГБО.
transmission
Тип коробки передач.
Допустимые значения:
MECHANICAL
— механическая коробка;AUTOMATIC
— автоматическая коробка;ROBOT
— коробка-робот;VARIATOR
— коробка-вариатор.
drive
Тип привода.
Допустимые значения:
ALL_WHEEL_DRIVE
— полный привод;FORWARD_CONTROL
— передний привод;REAR_DRIVE
— задний привод.
mark
Марка.
model
Модель.
super_gen_id
Идентификатор поколения.
configuration_id
Идентификатор конфигурации. Список конфигураций с идентификаторами можно получить с помощью операции GET /search/cars/breadcrumbs.
tech_param_id
Идентификатор набора технических характеристик ТС. Список наборов технических характеристик с идентификаторами можно получить с помощью операции GET /search/cars/breadcrumbs.
complectation_id
Идентификатор комплектации. Список идентификаторов можно получить с помощью операции GET /reference/catalog/cars/complectations
equipment
Опции комплектации. Массив пар
"{код опции}":{наличие опции в комплектации}
. Список допустимых значений смотрите в Справочнике опций.
manufacturer_info
Информация о ТС по каталогу производителя.
-
modification_code
Код модификации по каталогу производителя.
interior_code
Код интерьера по каталогу производителя.
color_code
Код цвета по каталогу производителя.
equipment_code
Массив кодов опций по каталогу производителя.
steering_wheel
Расположение руля.
Допустимые значения:
LEFT
— левый руль;RIGHT
— правый руль.
horse_power
Мощность двигателя в л. с.
mark_info
Информация о марке транспортного средства.
-
code
Код марки.
name
Название марки.
ru_name
Название марки на русском языке.
logo
Ссылка на логотип марки.
-
name
Идентификатор фотографии.
sizes
Объект с возможными размерами фотографии.
Пример:"120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90"
, где первый параметр — размер картинки, второй — URL-адрес картинки.
country_id
Массив идентификаторов. Страна марки (идентификатор в базе). Справочник регионов можно скачать по ссылке.
-
model_info
Информация о модели транспортного средства.
-
code
Код модели.
name
Название модели.
ru_name
Название модели на русском языке.
morphology
Род (мужской, женский, средний) модели.
-
gender
Род в русском языке.
Допустимые значения:
MASCULINE
— мужской род;FEMININE
— женский род;NEUTER
— средний род.
-
super_gen
Информация о поколении.
-
id
Идентификатор поколения.
name
Название поколения.
year_from
Год начала выпуска поколения.
year_to
Год окончания выпуска поколения. Если значение пустое или равно нулю, то поколение еще выпускается.
price_segment
Ценовой сегмент поколения.
purpose_group
Группа по назначению ТС (например, семейный, городской).
no_complect
Признак наличия комплектаций.
Допустимые значения:
true
— комплектации предусмотрены;false
— комплектации не предусмотрены.
configuration
Информация о конфигурации ТС.
-
configuration_id
Идентификатор конфигурации. Список конфигураций с идентификаторами можно получить с помощью операции GET /search/cars/breadcrumbs.
body_type
Тип кузова автомобиля. Список допустимых значений смотрите в Справочнике типов кузова.
doors_count
Число дверей.
auto_class
Класс автомобиля.
Допустимые значения:
- A;
- B;
- C;
- D;
- E;
- F;
- J;
- M;
- S.
human_name
Название кузова.
trunk_volume_min
Минимальный объем багажника в литрах.
trunk_volume_max
Максимальный объем багажника в литрах.
notice
Название конфигурации (отображается в интерфейсе на сайте).
length
Длина кузова в мм.
width
Ширина кузова в мм.
height
Высота кузова в мм.
seats
Количество мест.
main_photo
Фото кузова.
-
name
Идентификатор фотографии.
sizes
Объект с возможными размерами фотографии.
Пример:"120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90"
, где первый параметр — размер картинки, второй — URL-адрес картинки.
tech_param
Информация о наборе технических характеристик ТС.
-
id
Идентификатор набора технических характеристик ТС.
name
Название модификации ТС.
nameplate
Разновидность модели ТС.
displacement
Объем двигателя в куб. см.
engine_type
Тип двигателя.
Допустимые значения:
DIESEL
— дизель;ELECTRO
— электро;GASOLINE
— бензин;HYBRID
— гибрид;LPG
— ГБО.
gear_type
Тип привода.
Допустимые значения:
ALL_WHEEL_DRIVE
— полный привод;FORWARD_CONTROL
— передний привод;REAR_DRIVE
— задний привод.
transmission
Тип коробки передач.
Допустимые значения:
MECHANICAL
— механическая коробка;AUTOMATIC
— автоматическая коробка;ROBOT
— коробка-робот;VARIATOR
— коробка-вариатор.
power
Мощность двигателя в л. с.
power_kvt
Мощность двигателя в кВт.
human_name
Описание параметров ТС.
acceleration
Время разгона от 0 до 100 км/ч в секундах.
clearance_min
Минимальный клиренс в мм.
clearance_max
Максимальный клиренс в мм.
complectation
Информация о комплектации.
-
id
Идентификатор комплектации.
name
Название комплектации.
available_options
Список опций комплектации.
additional_options
Дополнительные опции комплектации.
price
Стоимость комплектации.
aliases
Массив альтернативных названий комплектации (алиасы).
vendor
Информация о производителе.
Допустимые значения:
VENDOR_UNKNOWN
— производитель неизвестен;RUSSIAN
— российский производитель;FOREIGN
— зарубежный производитель;EUROPEAN
— европейский производитель;JAPANESE
— японский производитель;KOREAN
— корейский производитель;AMERICAN
— американский производитель;CHINESE
— китайский производитель;NOT_CHINESE
— не китайский производитель.
truck_info
Информация о коммерческом транспорте.
-
truck_category
Категория коммерческого транспорта.
Допустимые значения:
TRUCK
— грузовик;LCV
— легкий коммерческий транспорт;TRAILER
— прицеп;SWAP_BODY
— съемный кузов;BUS
— автобус;ARTIC
— седельный тягач;AGRICULTURAL
— сельскохозяйственная;CONSTRUCTION
— строительная;AUTOLOADER
— автопогрузчик;CRANE
— автокран;DREDGE
— экскаватор;BULLDOZERS
— бульдозер;CRANE_HYDRAULICS
— самопогрузчик;MUNICIPAL
— коммунальная.
mark
Марка.
model
Модель.
displacement
Объем двигателя в куб. см.
horse_power
Мощность двигателя в л. с.
loading
Грузоподъемность в кг.
axis
Количество осей.
seats
Количество мест.
cabin
Тип кабины.
Допустимые значения:
2_SEAT_WO_SLEEP
— двухместная без спального места;2_SEAT_1_SLEEP
— двухместная с одним спальным местом;2_SEAT_2_SLEEP
— двухместная с двумя спальными местами;3_SEAT_WO_SLEEP
— трехместная без спального места;3_SEAT_1_SLEEP
— трехместная с одним спальным местом;6_SEAT_2_ROW
— шестиместная двухрядная;7_SEAT_2_ROW
— семиместная двухрядная.
steering_wheel
Расположение руля.
Допустимые значения:
LEFT
— левый руль;RIGHT
— правый руль.
engine
Тип двигателя.
Допустимые значения:
DIESEL
— дизель;GASOLINE
— бензин;ELECTRO
— электро.
transmission
Тип коробки передач.
Допустимые значения:
MECHANICAL
— механическая коробка;AUTOMATIC
— автоматическая коробка;ROBOTIC
— коробка-робот;SEMI_AUTOMATIC
— полуавтомат.
gear
Тип привода.
Допустимые значения:
BACK
— задний;BACK_PLUG_FRONT
— заднеприводный с подключением переднего;FRONT
— передний;FULL
— полный;FULL_ALL_WHEEL
— постоянный привод на все колеса;FULL_PLUG
— полный подключаемый.
wheel_drive
Колесная формула.
Допустимые значения:
WD_10x10
— 10x10;WD_10x6
— 10x6;WD_4x2
— 4x2;WD_4x4
— 4x4;WD_6x2
— 6x2;WD_6x4
— 6x4;WD_6x6
— 6x6;WD_8x2
— 8x2;WD_8x4
— 8x4;WD_8x8
— 8x8.
saddle_height
Высота седельного устройства.
Допустимые значения:
SH_128
— 128;SH_150
— 150;SH_185
— 185;SH_250
— 250.
brakes
Тип тормозов.
Допустимые значения:
DRUM
— барабанные;DISC
— дисковые.
euro_class
Экологический класс ТС (евро-класс).
Допустимые значения:
EURO_0
— 0;EURO_1
— 1;EURO_2
— 2;EURO_3
— 3;EURO_4
— 4;EURO_5
— 5;EURO_GREEN
— зеленый сертификат.
cabin_suspension
Подвеска кабины.
Допустимые значения:
MECHANICAL
— механическая;PNEUMATIC
— пневматическая.
suspension
Тип подвески.
Допустимые значения:
SPRING
— рессорная;PNEUMO_SPRING
— пневмо-рессорная;TORSION
— торсионнная.
chassis_suspension
Подвеска шасси.
Допустимые значения:
SPRING_SPRING
— рессора-рессора;SPRING_PNEUMO
— рессора-пневмо;PNEUMO_PNEUMO
— пневмо-пневмо.
bus_type
Тип автобуса.
Допустимые значения:
CREW
— вахтовый;INTERCITY
— междугородный;SPECIAL
— специальный;SUBURBAN
— пригородный;TOURIST
— туристический;URBAN
— городской.
trailer_type
Тип прицепа. Список допустимых значений смотрите в Справочнике типов прицепа.
swap_body_type
Тип съемного кузова.
Допустимые значения:
BULK_CARGO
— контейнер насыпных грузов;CONTAINER_TANK
— танк-контейнер;ISOTHERMAL
— изотермический контейнер;SB_TARPAULIN
— сменный кузов, брезент;SB_PLATFORM
— сменный кузов, платформа;SB_REFRIGERATOR
— сменный кузов, рефрежиратор;SB_VAN
— сменный кузов, фургон;SPECIAL
— спецконтейнер.
truck_type
Тип кузова (для грузовиков). Список допустимых значений смотрите в Справочнике типов кузова коммерческого транспорта.
light_truck_type
Тип кузова (для легкого коммерческого транспорта). Список допустимых значений смотрите в Справочнике типов кузова коммерческого транспорта.
agricultural_type
Тип кузова (для сельскохозяйственной техники). Список допустимых значений смотрите в Справочнике типов кузова коммерческого транспорта.
construction_type
Тип кузова (для строительной техники). Список допустимых значений смотрите в Справочнике типов кузова коммерческого транспорта.
autoloader_type
Тип кузова (для автопогрузчиков). Список допустимых значений смотрите в Справочнике типов кузова коммерческого транспорта.
dredge_type
Тип кузова (для экскаваторов). Список допустимых значений смотрите в Справочнике типов кузова коммерческого транспорта.
bulldozer_type
Тип кузова (для бульдозеров). Список допустимых значений смотрите в Справочнике типов кузова коммерческого транспорта.
municipal_type
Тип кузова (для коммунальной техники). Список допустимых значений смотрите в Справочнике типов кузова коммерческого транспорта.
body_type
Тип кузова автомобиля. Список допустимых значений смотрите в Справочнике типов кузова.
equipment
Опции комплектации. Массив пар
"{код опции}":{наличие опции в комплектации}
. Список допустимых значений смотрите в Справочнике опций.
operating_hours
Моточасы.
load_height
Высота подъема.
crane_radius
Вылет стрелы.
bucket_volume
Объем ковша.
traction_class
Тяговый класс.
Допустимые значения:
TRACTION_3
;TRACTION_4
;TRACTION_6
;TRACTION_10
;TRACTION_15
;TRACTION_25
;TRACTION_35
;TRACTION_50
;TRACTION_75
.
mark_info
Информация о марке транспортного средства.
-
code
Код марки.
name
Название марки.
ru_name
Название марки на русском языке.
logo
Ссылка на логотип марки.
-
name
Идентификатор фотографии.
sizes
Объект с возможными размерами фотографии.
Пример:"120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90"
, где первый параметр — размер картинки, второй — URL-адрес картинки.
country_id
Массив идентификаторов. Страна марки (идентификатор в базе). Справочник регионов можно скачать по ссылке.
-
model_info
Информация о модели транспортного средства.
-
code
Код модели.
name
Название модели.
ru_name
Название модели на русском языке.
morphology
Род (мужской, женский, средний) модели.
-
gender
Род в русском языке.
Допустимые значения:
MASCULINE
— мужской род;FEMININE
— женский род;NEUTER
— средний род.
-
moto_info
Информация о мототранспорте.
-
moto_category
Категория мототранспорта.
Допустимые значения:
ATV
— мотовездеход;MOTORCYCLE
— мотоцикл;SCOOTERS
— скутер;SNOWMOBILE
— снегоход.
mark
Марка.
model
Модель.
displacement
Объем двигателя в куб. см.
horse_power
Мощность двигателя в л. с.
engine
Тип двигателя.
Допустимые значения:
CARBURETOR
— карбюратор (актуально для мотоциклов);DIESEL_TURBO
— дизель (актуально для мотовездеходов);DIESEL
— дизель (актуально для мотоциклов, мотовездеходов);ELECTRO
— электрический (актуально для скутеров);GASOLINE_CARBURETOR
— карбюратор (актуально для мотовездеходов, снегоходов, скутеров);GASOLINE_COMPRESSOR
— компрессор (актуально для скутеров);GASOLINE_INJECTOR
— инжектор (актуально для мотовездеходов, снегоходов, скутеров);GASOLINE_ROTOR
— ротор (актуально для снегоходов, скутеров);GASOLINE_TURBO
— бензин турбонаддув (актуально для мотовездеходов, снегоходов);HYBRID_GASOLINE
— гибридный бензиновый (актуально для мотовездеходов);INJECTOR
— инжектор (актуально для мотоциклов);TURBO
— бензин турбонаддув (актуально для мотоциклов).
transmission
Тип коробки передач.
Допустимые значения:
TRANSMISSION_1
— 1 передача;TRANSMISSION_2
— 2 передачи;TRANSMISSION_3
— 3 передачи;TRANSMISSION_4
— 4 передачи;TRANSMISSION_4_FORWARD_AND_BACK
— 4 прямых и задняя;TRANSMISSION_5
— 5 передач;TRANSMISSION_5_FORWARD_AND_BACK
— 5 прямых и задняя;TRANSMISSION_6
— 6 передач;TRANSMISSION_6_FORWARD_AND_BACK
— 6 прямых и задняя;TRANSMISSION_7
— 7 передач;TRANSMISSION_8
— 8 передач;AUTOMATIC
— автоматическая;AUTOMATIC_2_SPEED
— 2-скоростной автомат;AUTOMATIC_3_SPEED
— 3-скоростной автомат;DIRECT_DRIVE
— прямая передача;MECHANICAL
— механическая;ROBOTIC
— роботизированная;ROBOTIC_2_CLUTCH
— роботизированная с двумя сцеплениями;SEMI_AUTOMATIC
— полуавтомат;VARIATOR
— вариатор.
gear
Тип привода.
Допустимые значения:
BACK
— задний;BACK_DIFFERENTIAL
— задний с дифференциалом;BELT
— ремень;CARDAN
— кардан;CHAIN
— цепь;FULL
— полный.
moto_type
Тип мотоцикла. Список допустимых значений смотрите в Справочнике типов мотоцикла.
atv_type
Тип мотовездехода.
Допустимые значения:
AMPHIBIAN
— амфибия;BUGGI
— багги;CHILDISH
— детский;SPORTS
— спортивный;TOURIST
— туристический;UTILITARIAN
— утилитарный.
snowmobile_type
Тип снегохода.
Допустимые значения:
AMPHIBIAN
— амфибия;BUGGI
— багги;CHILDISH
— детский;SPORTS
— спортивный;TOURIST
— туристический;UTILITARIAN
— утилитарный.
cylinder_order
Расположение цилиндров.
Допустимые значения:
LINE
— рядное;V_TYPE
— V-образное;OPPOSITE
— оппозитное;ROTARY
— ротор.
cylinder_amount
Количество цилиндров.
Допустимые значения:
CYLINDERS_1
— 1 цилиндр;CYLINDERS_2
— 2 цилиндра;CYLINDERS_3
— 3 цилиндра;CYLINDERS_4
— 4 цилиндра;CYLINDERS_5
— 5 цилиндров;CYLINDERS_6
— 6 цилиндров;CYLINDERS_8
— 8 цилиндров;CYLINDERS_10
— 10 цилиндров.
stroke_amount
Число тактов двигателя.
Допустимые значения:
STROKES_2
— 2;STROKES_4
— 4.
equipment
Опции комплектации. Массив пар
"{код опции}":{наличие опции в комплектации}
. Список допустимых значений смотрите в Справочнике опций.
mark_info
Информация о марке транспортного средства.
-
code
Код марки.
name
Название марки.
ru_name
Название марки на русском языке.
logo
Ссылка на логотип марки.
-
name
Идентификатор фотографии.
sizes
Объект с возможными размерами фотографии.
Пример:"120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90"
, где первый параметр — размер картинки, второй — URL-адрес картинки.
country_id
Массив идентификаторов. Страна марки (идентификатор в базе). Справочник регионов можно скачать по ссылке.
-
model_info
Информация о модели транспортного средства.
-
code
Код модели.
name
Название модели.
ru_name
Название модели на русском языке.
morphology
Род (мужской, женский, средний) модели.
-
gender
Род в русском языке.
Допустимые значения:
MASCULINE
— мужской род;FEMININE
— женский род;NEUTER
— средний род.
-
url
Ссылка на полную версию страницы с объявлением.
mobile_url
Ссылка на мобильную версию страницы с объявлением.
color_hex
Цвет транспортного средства в HEX-формате. Список допустимых значений смотрите в Справочнике цветов.
status
Статус объявления.
Допустимые значения:
ACTIVE
— объявление активно;INACTIVE
— объявление скрыто пользователем или службой модерации;BANNED
— объявление или пользователь заблокированы;REMOVED
— объявление удалено;NEED_ACTIVATION
— объявление ожидает активации на стороне сервиса;EXPIRED
— срок действия объявления истек;DRAFT
— черновик.
category
Категория транспортного средства (ТС).
Допустимые значения:
CARS
— легковой автомобиль;MOTO
— мототранспорт;TRUCKS
— коммерческий транспорт.
section
Состояние транспортного средства.
Допустимые значения:
NEW
— новое транспортное средство;USED
— транспортное средство с пробегом (б/у).
availability
Доступность транспортного средства.
Допустимые значения:
IN_STOCK
— ТС находится в салоне/в наличии;IN_TRANSIT
— ТС в пути;ON_ORDER
— ТС доступно только на заказ.
price_info
Информация о цене.
-
price
Стоимость ТС.
currency
Валюта.
Допустимые значения:
RUR
— российский рубль. Является значением по умолчанию;USD
— доллар США;EUR
— евро.
create_timestamp
Дата установки стоимости в миллисекундах.
rur_price
Стоимость в рублях.
usd_price
Стоимость в долларах США.
eur_price
Стоимость в евро.
discount_options
Информация о скидках.
-
tradein
Сумма скидки при покупки в trade-in, в рублях.
insurance
Сумма скидки при покупке со страховкой, в рублях.
credit
Сумма скидки при покупке в кредит, в рублях.
description
Текст объявления.
documents
Информация о документах на транспортное средство.
-
owners_number
Количество владельцев от 1 до 3. Цифра 3 (три) обозначает три и более владельцев.
pts_original
Признак наличия оригинала ПТС.
Допустимые значения:
true
— оригинал ПТС в наличии;false
— оригинал ПТС отсутствует.
pts
Наличие ПТС.
Допустимые значения:
ORIGINAL
— оригинал ПТС;DUPLICATE
— дубликат ПТС.
custom_cleared
Признак растаможенности ТС.
Допустимые значения:
true
— ТС растаможено;false
— ТС не растаможено.
purchase_date
Дата покупки ТС.
-
year
Год покупки.
month
Месяц покупки.
day
День покупки (число месяца).
year
Год выпуска ТС.
sts
Номер свидетельства о регистрации ТС.
vin
Идентификационный номер ТС.
warranty
Признак наличия гарантии.
Допустимые значения:
true
— ТС на гарантии;false
— гарантия закончилась.
warranty_expire
Дата окончания гарантии.
-
year
Год покупки.
month
Месяц покупки.
day
День покупки (число месяца).
license_plate
Автомобильный номер.
vin_resolution
Статус проверки ТС по базам ГИБДД.
Допустимые значения:
UNKNOWN
— не совпадает число владельцев или незначительно отличаются значения объема / мощности двигателя;UNTRUSTED
— ТС не стоит на учете в ГИБДД;OK
– ТС прошло все проверки. Параметры из объявления совпадают с данными в ГИБДД;ERROR
— есть юридические проблемы или параметры из объявления не совпадают с данными в ГИБДД;INVALID
— указан VIN-номер от другого ТС;IN_PROGRESS
— ожидается проверка.
state
Информация о внешнем состоянии транспортного средства.
-
mileage
Пробег в километрах.
state_not_beaten
Признак того, что ТС на ходу.
Допустимые значения:
true
— ТС на ходу;false
— ТС не на ходу.
condition
Состояние ТС.
Допустимые значения:
CONDITION_OK
— ТС на ходу;CONDITION_BROKEN
— ТС не на ходу.
video
Видео о ТС.
-
yandex_id
Идентификатор в сервисе Яндекс.Видео.
youtube_url
URL из сервиса youtube.
damages
Информация о повреждениях. Массив объектов.
Внимание
Объект используется только в категории «Легковые автомобили».
-
car_part
Часть автомобиля.
Допустимые значения:
FRONT_BUMPER
— передний бампер;REAR_BUMPER
— задний бампер;FRONT_LEFT_FENDER
— переднее левое крыло;FRONT_RIGHT_FENDER
— переднее правое крыло;REAR_LEFT_FENDER
— заднее левое крыло;REAR_RIGHT_FENDER
— заднее правое крыло;ROOF
— крыша;HOOD
— капот;GLASS
— лобовое стекло;TRUNK_DOOR
— багажная дверь;FRONT_LEFT_DOOR
— передняя левая дверь;FRONT_RIGHT_DOOR
— передняя правая дверь;REAR_LEFT_DOOR
— задняя левая дверь;REAR_RIGHT_DOOR
— задняя правая дверь;FRONT_LEFT_MIRROR
— переднее левое зеркало;FRONT_RIGHT_MIRROR
— переднее правое зеркало.
type
Массив типов повреждений.
Допустимые значения:
DYED
— деталь окрашена;SCRATCH
— царапина;DENT
– вмятина;CORROSION
— коррозия.
description
Описание повреждений.
image_urls
Фотографии ТС.
-
name
Идентификатор фотографии.
sizes
Объект с возможными размерами фотографии.
Пример:"120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90"
, где первый параметр — размер картинки, второй — URL-адрес картинки.
upload_url
URL для загрузки фотографии.
disable_photo_reorder
Признак запрета умного упорядочивания фотографий.
hide_license_plate
Признак маскировки гос. номера на фотографиях.
panoramas
Панорамы для объявления.
-
spincar_exterior_url
Ссылка на spincar-панораму экстерьера.
id
Идентификатор объявления. Например, 1221-ba4f.
user_ref
Идентификатор пользователя.
Допустимые значения:
user:{id}
— частное лицо;dealer:{id}
— дилер.
additional_info
Дополнительная информация.
-
is_owner
Признак того, что текущий пользователь является владельцем объявления.
original_id
Идентификатор оригинального объявления (используется для черновика).
hidden
Признак скрытого объявления.
is_on_moderation
Признак того, что объявление находится на модерации.
not_disturb
Признак наличия просьбы «Автосалоны и перекупщики, просьба не беспокоить».
Допустимые значения:
true
— просьба присутствует;false
— просьба отсутствует.
exchange
Признак обмена.
Допустимые значения:
true
— обмен возможен;false
— обмен невозможен.
haggle
Признак торга.
Допустимые значения:
HAGGLE_POSSIBLE
— торг возможен;HAGGLE_NOT_POSSIBLE
— торг невозможен.
accepted_autoru_finance
Признак согласия на продажу по программе «Авто.ру финанс».
fresh_date
Дата последнего применения услуги «Поднятие в поиске» в миллисекундах.
expire_date
Дата окончания действия объявления в миллисекундах.
actualize_date
Дата последней актуализации объявления в миллисекундах.
creation_date
Дата создания объявления в миллисекундах.
update_date
Дата изменения объявления в миллисекундах.
remote_id
Идентификатор удаленного объявления.
remote_url
URL удаленного объявления.
cert_request_available
Доступность заказа услуги проверки транспортного средства.
similar_offers_count
Количество похожий объявлений в поиске.
was_active
Было ли объявление хоть раз активно.
Допустимые значения:
true
— объявление было активно;false
— объявление не было активно.
actions
Действия, доступные для объявления.
-
edit
Возможность редактирования объявления.
Допустимые значения:
true
— объявление можно редактировать;false
— объявление нельзя редактировать.
activate
Возможность активации объявления.
Допустимые значения:
true
— объявление можно активировать;false
— объявление нельзя активировать.
hide
Возможность снятия объявления с продажи.
Допустимые значения:
true
— объявление можно снять с продажи;false
— объявление нельзя снять с продажи.
archive
Возможность архивирования объявления.
Допустимые значения:
true
— объявление можно архивировать;false
— объявление нельзя архивировать.
counters
Информация о количестве просмотров объявления и телефона в объявлении.
-
all
Общее количество просмотров.
daily
Количество просмотров в день.
phone_all
Общее количество просмотров номера телефона в объявлении.
phone_daily
Количество просмотров номера телефона в объявлении за день.
search_position
Позиция в поиске.
tags
Массив тегов в объявлении.
is_favorite
Признак наличия объявления в избранном.
Допустимые значения:
true
— объявление в избранном;false
— объявление не в избранном.
note
Заметка пользователя.
seller_type
Тип продавца.
Допустимые значения:
PRIVATE
— частное лицо;COMMERCIAL
— салон.
salon
Информация о продавце — салоне.
-
salon_id
Идентификатор салона.
name
Название салона.
is_oficial
Признак того, что салон является официальным дилером.
Допустимые значения:
true
— салон является официальным дилером;false
— салон не является официальным дилером.
place
Адрес салона (может отличаться от места осмотра).
-
address
Строковое описание места, например, адрес.
coord
Координаты места продажи.
-
latitude
Широта. Формат записи — градусы в виде десятичной дроби.
longitude
Долгота. Формат записи — градусы в виде десятичной дроби.
geobase_id
Идентификатор региона. Справочник регионов можно скачать по ссылке.
region_info
Информация о регионе.
-
id
Идентификатор региона. Справочник регионов можно скачать по ссылке.
name
Название региона.
genitive
Название региона в родительном падеже.
dative
Название региона в дательном падеже.
accusative
Название региона в винительном падеже.
prepositional
Название региона в предложном падеже.
preposition
Предлог, с которым употребляется название региона. Например: в Москве.
latitude
Широта центра региона. Формат записи — градусы в виде десятичной дроби.
longitude
Долгота центра региона. Формат записи — градусы в виде десятичной дроби.
sub_title
Подзаголовок (для деревень и СНГ).
supports_geo_radius
Возможен ли поиск с радиусом.
default_radius
Радиус поиска по умолчанию.
children
Массив вложенных регионов (объект
region_info
).
parent_ids
Массив идентификаторов регионов верхнего уровня (от большего к меньшему), включая текущий.
metro
Массив объектов. Ближайшая станция метро.
-
rid
Идентификатор региона внутри РФ. Справочник регионов можно скачать по ссылке.
name
Название станции метро.
distance
Расстояние от метро в метрах.
location
Координаты места.
-
latitude
Широта. Формат записи — градусы в виде десятичной дроби.
longitude
Долгота. Формат записи — градусы в виде десятичной дроби.
lines
Линия метро.
-
name
Название линии метро.
color
Цвет линии метро.
-
-
offers_count
Количество объявлений о продаже транспорта.
phones
Массив объектов. Телефоны салона.
-
phone
Номер телефона.
call_hour_start
Звонить с указанного часа.
call_hour_end
Звонить до указанного часа.
original
Оригинальный номер телефона.
mask
Маска для форматирования номера телефона.
title
Контактное лицо.
edit_contact
Признак того, что салон может указывать дополнительные телефоны.
edit_address
Признак того, что салон может изменять место осмотра.
code
Код дилера.
registration_date
Дата регистрации на Авто.ру.
client_id
Идентификатор карточки клиента.
logo_url
URL логотипа дилера.
loyalty_program
Признак участия в программе лояльности.
phone_callback_forbidden
Признак доступности функции обратного звонка.
open_hours
Часы работы.
photos
Фото дилера.
car_marks
Марки легковых автомобилей, для которых салон является официальным дилером.
-
code
Код марки.
name
Название марки.
ru_name
Название марки на русском языке.
logo
Ссылка на логотип марки.
-
name
Идентификатор фотографии.
sizes
Объект с возможными размерами фотографии.
Пример:"120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90"
, где первый параметр — размер картинки, второй — URL-адрес картинки.
country_id
Массив идентификаторов. Страна марки (идентификатор в базе). Справочник регионов можно скачать по ссылке.
-
logo
Логотип салона.
-
name
Идентификатор фотографии.
sizes
Объект с возможными размерами фотографии.
Пример:"120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90"
, где первый параметр — размер картинки, второй — URL-адрес картинки.
main_photo
Главная фотография салона.
-
name
Идентификатор фотографии.
sizes
Объект с возможными размерами фотографии.
Пример:"120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90"
, где первый параметр — размер картинки, второй — URL-адрес картинки.
dealer_gallery
Галерея фотографий салона.
-
name
Идентификатор фотографии.
sizes
Объект с возможными размерами фотографии.
Пример:"120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90"
, где первый параметр — размер картинки, второй — URL-адрес картинки.
offer_counters
Количество объявлений по срезам.
-
cars_all
Количество объявлений по срезу «Все легковые ТС».
moto_all
Количество объявлений по срезу «Все мото ТС».
trucks_all
Количество объявлений по срезу «Все коммерческие ТС».
trucks_marks
Марки коммерческого транспорта, для которых салон является официальным дилером.
-
code
Код марки.
name
Название марки.
ru_name
Название марки на русском языке.
logo
Ссылка на логотип марки.
-
name
Идентификатор фотографии.
sizes
Объект с возможными размерами фотографии.
Пример:"120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90"
, где первый параметр — размер картинки, второй — URL-адрес картинки.
country_id
Массив идентификаторов. Страна марки (идентификатор в базе). Справочник регионов можно скачать по ссылке.
-
moto_marks
Марки мототранспорта, для которых салон является официальным дилером.
-
code
Код марки.
name
Название марки.
ru_name
Название марки на русском языке.
logo
Ссылка на логотип марки.
-
name
Идентификатор фотографии.
sizes
Объект с возможными размерами фотографии.
Пример:"120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90"
, где первый параметр — размер картинки, второй — URL-адрес картинки.
country_id
Массив идентификаторов. Страна марки (идентификатор в базе). Справочник регионов можно скачать по ссылке.
-
seller
Информация о продавце.
-
name
Имя продавца, указанное в профиле на Авто.ру.
location
Информация о месте осмотра.
-
address
Строковое описание места, например, адрес.
coord
Координаты места продажи.
-
latitude
Широта. Формат записи — градусы в виде десятичной дроби.
longitude
Долгота. Формат записи — градусы в виде десятичной дроби.
geobase_id
Идентификатор региона. Справочник регионов можно скачать по ссылке.
region_info
Информация о регионе.
-
id
Идентификатор региона. Справочник регионов можно скачать по ссылке.
name
Название региона.
genitive
Название региона в родительном падеже.
dative
Название региона в дательном падеже.
accusative
Название региона в винительном падеже.
prepositional
Название региона в предложном падеже.
preposition
Предлог, с которым употребляется название региона. Например: в Москве.
latitude
Широта центра региона. Формат записи — градусы в виде десятичной дроби.
longitude
Долгота центра региона. Формат записи — градусы в виде десятичной дроби.
sub_title
Подзаголовок (для деревень и СНГ).
supports_geo_radius
Возможен ли поиск с радиусом.
default_radius
Радиус поиска по умолчанию.
children
Массив вложенных регионов (объект
region_info
).
parent_ids
Массив идентификаторов регионов верхнего уровня (от большего к меньшему), включая текущий.
metro
Массив объектов. Ближайшая станция метро.
-
rid
Идентификатор региона внутри РФ. Справочник регионов можно скачать по ссылке.
name
Название станции метро.
distance
Расстояние от метро в метрах.
location
Координаты места.
-
latitude
Широта. Формат записи — градусы в виде десятичной дроби.
longitude
Долгота. Формат записи — градусы в виде десятичной дроби.
lines
Линия метро.
-
name
Название линии метро.
color
Цвет линии метро.
-
phones
Массив объектов. Телефоны продавца.
-
phone
Номер телефона.
call_hour_start
Звонить с указанного часа.
call_hour_end
Звонить до указанного часа.
original
Оригинальный номер телефона.
mask
Маска для форматирования номера телефона.
title
Контактное лицо.
chats_enabled
Признак доступности чата с пользователями.
unconfirmed_email
Электронная почта, для которой не требуется подтверждение.
custom_phones
Признак того, что телефоны изменены.
custom_location
Признак того, что место осмотра изменено.
-
services
Информация о платных услугах, подключенных автором объявления. Массив объектов.
-
service
Код услуги.
create_date
Дата начала действия услуги в миллисекундах.
expire_date
Дата окончания действия услуги в миллисекундах.
is_active
Признак того, что услуга активна. Допустимые значения:
true
— услуга активна;false
— услуга неактивна
create_date
Дата начала действия услуги в миллисекундах.
expire_date
Дата окончания действия услуги в миллисекундах.
badge
Название рекламного текста для услуги «all_sale_badge».
prolongable
Признак того, что услуга является автопродляемой.
service_prices
Массив объектов. Информация о стоимости платных услуг.
-
service
Код услуги.
name
Текстовое название услуги.
description
Текстовое описание услуги.
price
Стоимость услуги.
auto_prolong_price
Стоимость автопродления.
currency
Валюта.
multiplier
Во сколько раз увеличится количество просмотров после применения услуги.
aliases
Массив алиасов для параметра service.
need_confirm
Признак. Отображает подтверждение для дилеров при активации или отключении услуги.
badges
Массив коротких рекламных текстов, которые показываются пользователям в списке объявлений на сайте Авто.ру.
discount_price
Информация о цене со скидкой.
-
price
Стоимость после применения скидки, в рублях.
status
Статус скидки.
Допустимые значения:
ACTIVE
— скидка активна;INACTIVE
— скидка неактивна.
price_history
Информация по истории изменений цены на ТС. Массив объектов с ценами, выставленными в определенный момент времени.
-
price
Стоимость ТС.
currency
Валюта.
Допустимые значения:
RUR
— российский рубль. Является значением по умолчанию;USD
— доллар США;EUR
— евро.
create_timestamp
Дата установки стоимости в миллисекундах.
rur_price
Стоимость в рублях.
usd_price
Стоимость в долларах США.
eur_price
Стоимость в евро.
reasons_ban
Массив причин блокировки.
human_reasons_ban
Человекочитаемые причины блокировки.
-
title
Заголовок для личного кабинета.
text
Описание причины блокировки для личного кабинета.
text_app
Описание причины блокировки для мобильного приложения.
feedprocessor_unique_id
Идентификатор offer (объявление) в feed (прайс-лист).
service_schedules
Расписания автопродления услуг.
-
products
Список по услугам.
created
Отображаемая дата создания объявления.
autostrategies
Подключенные автостратегии для объявления.
-
offer_id
Идентификатор объявления с хешом.
from_date
Дата начала применения автостратегии в формате ISO 8601 со смещением относительно UTC. Например,
2017-07-08T11:29:16+03:00
. В качестве временной зоны используется Europe/Moscow.
to_date
Дата окончания применения автостратегии в формате ISO 8601 со смещением относительно UTC. Например,
2017-07-08T11:29:16+03:00
. В качестве временной зоны используется Europe/Moscow.
max_applications_per_day
Максимальное количество применений в сутки.
always_at_first_page
Настройка автостратегии «Всегда на первой странице».
-
for_mark_model_listing
Настройка поисковой выдачи «Марка — Модель».
for_mark_model_generation_listing
Настройка поисковой выдачи «Марка — Модель — Поколение».
-
-
pagination
Пагинация результатов запроса.
-
page
Номер текущей страницы, начиная с единицы.
page_size
Количество объявлений на странице.
total_offers_count
Общее число объявлений на всех страницах.
total_page_count
Общее число страниц.
filters
Фильтры.
-
truck_category
Категория коммерческого транспорта.
Допустимые значения:
TRUCK
— грузовик;LCV
— легкий коммерческий транспорт;TRAILER
— прицеп;SWAP_BODY
— съемный кузов;BUS
— автобус;ARTIC
— седельный тягач;AGRICULTURAL
— сельскохозяйственная;CONSTRUCTION
— строительная;AUTOLOADER
— автопогрузчик;CRANE
— автокран;DREDGE
— экскаватор;BULLDOZERS
— бульдозер;CRANE_HYDRAULICS
— самопогрузчик;MUNICIPAL
— коммунальная.
moto_category
Категория мототранспорта.
Допустимые значения:
ATV
— мотовездеход;MOTORCYCLE
— мотоцикл;SCOOTERS
— скутер;SNOWMOBILE
— снегоход.
status
Статус объявления.
Допустимые значения:
active
— объявление активно;inactive
— объявление неактивно;banned
— объявление заблокировано.
service
Подключенные услуги.
Допустимые значения:
all_sale_fresh
— поднятие объявления в поиске;all_sale_premium
— премиум;all_sale_special
— спецпредложение;package_turbo
— турбо-продажа;reset
— обнуление.
vin
VIN-номера.
mark_model
Идентификаторы марки и модели, разделенные закодированным символом «#» (%23), например «MERCEDES%23C_KLASSE». Идентификатор модели может отсутствовать.
price_from
Стоимость транспорта в выбранной валюте (например, российский рубль), от.
price_to
Стоимость транспорта в выбранной валюте (например, российский рубль), до.
section
Состояние транспортного средства.
Допустимые значения:
NEW
— новое транспортное средство;USED
— транспортное средство с пробегом (б/у).
filters
Фильтры.
truck_category
Категория коммерческого транспорта.
Допустимые значения:
TRUCK
— грузовик;LCV
— легкий коммерческий транспорт;TRAILER
— прицеп;SWAP_BODY
— съемный кузов;BUS
— автобус;ARTIC
— седельный тягач;AGRICULTURAL
— сельскохозяйственная;CONSTRUCTION
— строительная;AUTOLOADER
— автопогрузчик;CRANE
— автокран;DREDGE
— экскаватор;BULLDOZERS
— бульдозер;CRANE_HYDRAULICS
— самопогрузчик;MUNICIPAL
— коммунальная.
moto_category
Категория мототранспорта.
Допустимые значения:
ATV
— мотовездеход;MOTORCYCLE
— мотоцикл;SCOOTERS
— скутер;SNOWMOBILE
— снегоход.
status
Статус объявления.
Допустимые значения:
active
— объявление активно;inactive
— объявление неактивно;banned
— объявление заблокировано.
service
Подключенные услуги.
Допустимые значения:
all_sale_fresh
— поднятие объявления в поиске;all_sale_premium
— премиум;all_sale_special
— спецпредложение;package_turbo
— турбо-продажа;reset
— обнуление.
vin
VIN-номера.
mark_model
Идентификаторы марки и модели, разделенные закодированным символом «#» (%23), например «MERCEDES%23C_KLASSE». Идентификатор модели может отсутствовать.
price_from
Стоимость транспорта в выбранной валюте (например, российский рубль), от.
price_to
Стоимость транспорта в выбранной валюте (например, российский рубль), до.
section
Состояние транспортного средства.
Допустимые значения:
NEW
— новое транспортное средство;USED
— транспортное средство с пробегом (б/у).
create_date_from
Дата создания объявления в формате ISO 8601 со смещением относительно UTC. Например,
2017-07-08T11:29:16+03:00
, от. Необходимо закодировать символы: «:» — «%3A», «+» — «%2B».
create_date_to
Дата создания объявления в формате ISO 8601 со смещением относительно UTC. Например,
2017-07-08T11:29:16+03:00
, до. Необходимо закодировать символы: «:» — «%3A», «+» — «%2B».
no_active_services
Фильтр. Показывает объявления без примененных услуг.
ban_reason
Причина блокировки объявления. Подробнее с описанием причин блокировки можно ознакомиться в Справочнике причин блокировки.
sorting
Тип сортировки.
-
name
Название сортировки.
desc
Признак сортировки по убыванию.
auction
Аукцион.
-
state
Список настроек аукциона.
-
current_bid
Текущая ставка в копейках.
base_price
Базовая цена продукта в копейках.
min_bid
Минимальная ставка аукциона в копейках.
max_bid
Максимальная ставка аукциона в копейках.
one_step
Стоимость одного шага аукциона в копейках.
limit_exceeded
Превышен лимит.
segments
Описание сегментов.
Примечание
В выдаче будут показаны 5 сегментов.
-
percent
Процент интереса.
min_bid
Минимальная ставка аукциона в копейках для попадания в выбранный процент интереса.
max_bid
Максимальная ставка аукциона в копейках для попадания в выбранный процент интереса.
current
Объявление находится в этом сегменте интереса.
-
status
Статус ответа.
-
Коды ответа
Код |
Причина |
Описание |
200 |
OK |
Успешный запрос. |
400 |
BAD_REQUEST |
Синтаксическая ошибка в запросе. |
401 |
NO_AUTH |
Не удалось авторизовать пользователя по переданным данным. |
500 |
INTERNAL SERVER ERROR |
Внутренняя ошибка сервера. |
Пример
Запрос:
curl -i -X GET 'https://apiauto.ru/1.0/user/offers/cars?page=1&page_size=1&price_to=10000000' -H 'x-authorization: 2dtrer432...' -H 'x-session-id: 112_aoR02Tpv...'
Ответ:
HTTP/1.1 200 OK Server: nginx Date: Fri, 15 Jun 2018 13:30:59 GMT Content-Type: application/json Connection: keep-alive { "offers": [ { "car_info": { "armored": false, "body_type": "ALLROAD_5_DOORS", "engine_type": "DIESEL", "transmission": "AUTOMATIC", "drive": "ALL_WHEEL_DRIVE", "mark": "MERCEDES", "model": "GL_KLASSE", "super_gen_id": "4986814", "configuration_id": "4986815", "tech_param_id": "20494193", "horse_power": 224, "mark_info": { "code": "MERCEDES", "name": "Mercedes-Benz", "ru_name": "Мерседес-Бенц", "logo": { "name": "mark-logo", "sizes": { "logo": "//images...avto.ru/get-auto/3117/catalog.3172...624686..15/logo", "big-logo": "//images....avto.ru/get-auto/3117/catalog.3172.36...624/dealer_logo" } } }, "model_info": { "code": "GL_KLASSE", "name": "GL-klasse", "ru_name": "" }, "super_gen": { "id": "4986814", "name": "I (X164) Рестайлинг", "ru_name": "1 (X164) Рестайлинг", "year_from": 2009, "year_to": 2012, "price_segment": "PREMIUM", "purpose_group": "BUSINESS" }, "configuration": { "id": "4986815", "body_type": "ALLROAD_5_DOORS", "doors_count": 0, "human_name": "" }, "tech_param": { "id": "20494193", "name": "350", "nameplate": "350", "displacement": 2987, "engine_type": "DIESEL", "gear_type": "ALL_WHEEL_DRIVE", "transmission": "AUTOMATIC", "power": 224, "power_kvt": 165, "human_name": "350 3.0d AT (224 л.с.) 4WD" } }, "url": "https://auto.ru/cars/used/sale/1073..6-97ed..17", "mobile_url": "http://m.auto.ru/cars/used/sale/107..456-97ed..17", "color_hex": "007F00", "status": "NEED_ACTIVATION", "category": "CARS", "section": "USED", "availability": "IN_STOCK", "old_category_id": 15, "price_info": { "price": 150084, "currency": "RUR", "create_timestamp": "1529067845000", "rur_price": 150084, "usd_price": 2394, "eur_price": 2069, "dprice": 150084, "rur_dprice": 150084, "usd_dprice": 2394, "eur_dprice": 2069 }, "documents": { "owners_number": 2, "pts_original": true, "year": 2010, "vin": "7cnhr703tm1Vp0962", "pts": "ORIGINAL" }, "state": { "mileage": 50000, "condition": "CONDITION_BROKEN" }, "id": "1074514456-97ed3c17", "user_ref": "dealer:20101", "additional_info": { "is_owner": true, "hidden": false, "is_on_moderation": false, "expire_date": "1534338245000", "update_date": "1529068210000", "actualize_date": "1529067889000", "creation_date": "1529067845000", "mobile_autoservices_url": "http://m.auto.ru/autoservice/all_works/MERCEDES/?geo_id=213", "fresh_date": "1529068210000" }, "actions": { "edit": true, "activate": false, "hide": true, "archive": true }, "seller_type": "COMMERCIAL", "salon": { "salon_id": "14397", "name": "САЛОН АВТОМОБИЛЬНЫЙ", "is_oficial": false, "phones": [ { "phone": "79200900658", "call_hour_start": 12, "call_hour_end": 21, "original": "79200900658", "mask": "1:3:7", "title": "вапвв" } ], "place": { "address": "Россия, Москва, Каширское шоссе, 67к1", "coord": { "latitude": 55.597137, "longitude": 37.727402 }, "geobase_id": "213", "region_info": { "id": "213", "name": "Москва", "prepositional": "Москве", "preposition": "в", "latitude": 55.75396, "longitude": 37.620393, "parent_ids": [ "213", "1", "3", "225", "10001", "10000" ] } }, "edit_contact": true, "edit_address": true, "calls_auction": true }, "seller": { "name": "САЛОН", "phones": [ { "phone": "79200900658", "call_hour_start": 12, "call_hour_end": 21, "original": "79200900658", "mask": "1:3:7", "title": "вапвв" } ], "location": { "address": "Россия, Москва, Каширское шоссе, 67к1", "coord": { "latitude": 55.597137, "longitude": 37.727402 }, "geobase_id": "213", "region_info": { "id": "213", "name": "Москва", "prepositional": "Москве", "preposition": "в", "latitude": 55.75396, "longitude": 37.620393, "parent_ids": [ "213", "1", "3", "225", "10001", "10000" ] } }, "unconfirmed_email": "vxkj@mail.ru", "redirect_phones": false, "chats_enabled": false, "telepony_info": { "domain": "auto-dealers", "object_id": "dealer-14397", "ttl": "2592000" } }, "services": [ { "service": "all_sale_fresh", "expire_date": "1529154289000", "create_date": "1529067889000", "is_active": true } ], "badges": [ "Ty3jnmui", "Tlnbv", "Yvunrblo" ], "counters": { "all": 0, "daily": 0, "phone_all": 0, "phone_daily": 0, "calls_all": 0, "calls_daily": 0 }, "price_history": [ { "price": 150084, "currency": "RUR", "create_timestamp": "1529067845000", "rur_price": 150084, "usd_price": 2394, "eur_price": 2069, "dprice": 150084, "rur_dprice": 150084, "usd_dprice": 2394, "eur_dprice": 2069 } ], "search_position": -1, "is_favorite": false, "created": "2018-06-15T13:04:05Z", "discount_options": {} } ], "pagination": { "page": 1, "page_size": 1, "total_offers_count": 13, "total_page_count": 13 }, "filters": { "price_to": 10000000, "no_active_services": false }, "auction": { "state": { "current_bid": 100000, "base_price": 100, "min_bid": 10000, "max_bid": 1290000, "one_step": 10000, "limit_exceeded": false }, "segments": [ { "percent": 5, "min_bid": 100, "max_bid": 50000, "current": true } ] }, "status": "SUCCESS" }
Статус ответа.
Вывести результаты, начиная с указанной страницы. Страницы нумеруются с единицы (1). Допустимые значения: от 1 до 1000.
Количество объявлений на странице.
Ограничение
Максимальное допустимое значение — 100 объявлений на страницу. При превышении этого значения доступ к API будет ограничен. Подробнее можно узнать в разделе Ограничения по использованию ресурсов API.
Категория коммерческого транспорта.
Допустимые значения:
-
TRUCK
— грузовик; -
LCV
— легкий коммерческий транспорт; -
TRAILER
— прицеп; -
SWAP_BODY
— съемный кузов; -
BUS
— автобус; -
ARTIC
— седельный тягач; -
AGRICULTURAL
— сельскохозяйственная; -
CONSTRUCTION
— строительная; -
AUTOLOADER
— автопогрузчик; -
CRANE
— автокран; -
DREDGE
— экскаватор; -
BULLDOZERS
— бульдозер; -
CRANE_HYDRAULICS
— самопогрузчик; -
MUNICIPAL
— коммунальная.
Категория мототранспорта.
Допустимые значения:
-
ATV
— мотовездеход; -
MOTORCYCLE
— мотоцикл; -
SCOOTERS
— скутер; -
SNOWMOBILE
— снегоход.
Статус объявления.
Допустимые значения:
-
active
— объявление активно; -
inactive
— объявление неактивно; -
banned
— объявление заблокировано.
Примечание
Если вы хотите добавить больше одного значения, укажите параметр несколько раз:
status=active&status=banned
Подключенные услуги.
Допустимые значения:
-
all_sale_fresh
— поднятие объявления в поиске; -
all_sale_premium
— премиум; -
all_sale_special
— спецпредложение; -
package_turbo
— турбо-продажа; -
reset
— обнуление.
Примечание
Если вы хотите добавить больше одного значения, укажите параметр несколько раз:
service=all_sale_special&service=all_sale_premium
VIN-номера.
Примечание
Если вы хотите добавить больше одного значения, укажите параметр несколько раз:
vin=skedeP0iddddA0111&vin=sewqfP0irtyuA0222
Идентификаторы марки и модели, разделенные закодированным символом «#» (%23), например «MERCEDES%23C_KLASSE». Идентификатор модели может отсутствовать.
Примечание
Если вы хотите добавить больше одного значения, укажите параметр несколько раз:
mark_model=MERCEDES%23C_KLASSE&mark_model=HONDA
Стоимость транспорта в выбранной валюте (например, российский рубль), от.
Стоимость транспорта в выбранной валюте (например, российский рубль), до.
Состояние транспортного средства.
Допустимые значения:
NEW
— новое транспортное средство;USED
— транспортное средство с пробегом (б/у).
Дата создания объявления в формате ISO 8601 со смещением относительно UTC. Например, 2017-07-08T11:29:16+03:00
, от. Необходимо закодировать символы: «:» — «%3A», «+» — «%2B».
Дата создания объявления в формате ISO 8601 со смещением относительно UTC. Например, 2017-07-08T11:29:16+03:00
, до. Необходимо закодировать символы: «:» — «%3A», «+» — «%2B».
Фильтр. Показывает объявления без примененных услуг.
Причина блокировки объявления. Подробнее с описанием причин блокировки можно ознакомиться в Справочнике причин блокировки.
Тип сортировки объявлений.
Допустимые значения:
alphabet-asc
— по названию (с начала алфавита);alphabet-desc
— по названию (с конца алфавита);cr_date-asc
— по дате создания, в порядке возрастания. Является значением по умолчанию;cr_date-desc
— по дате создания, в порядке убывания;fresh_relevance_1-desc
— по актуальности;km_age-asc
— по пробегу, в порядке возрастания;km_age-desc
— по пробегу, в порядке убывания;price-asc
— по цене, в порядке возрастания;price-desc
— по цене, в порядке убывания;year-asc
— по году, в порядке возрастания;year-desc
— по году, в порядке убывания.
Фильтр. Показывает объявления, участвующие в аукционе.
Название категории ТС. Допустимые значения:
cars
— легковые автомобили;moto
— мототранспорт;trucks
— коммерческий транспорт;all
— все категории ТС.