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

Название категории ТС. Допустимые значения:

  • cars — легковые автомобили;
  • moto — мототранспорт;
  • trucks — коммерческий транспорт;
  • all — все категории ТС.

page

Вывести результаты, начиная с указанной страницы. Страницы нумеруются с единицы (1). Допустимые значения: от 1 до 1000.


page_size

Количество объявлений на странице.

Внимание

Максимальное допустимое значение — 100 объявлений на страницу. При превышении этого значения доступ к API будет ограничен. Подробнее можно узнать в разделе Ограничения по использованию ресурсов API.


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 — объявление или пользователь заблокированы;

Примечание

Если вы хотите добавить больше одного значения, укажите параметр несколько раз:

status=active&status=banned

service

Подключенные услуги.

Допустимые значения:
  • all_sale_fresh — поднятие объявления в поиске;
  • all_sale_premium — премиум;
  • all_sale_special — спецпредложение;
  • package_turbo — турбо-продажа;
  • reset — обнуление.

Примечание

Если вы хотите добавить больше одного значения, укажите параметр несколько раз:

service=all_sale_special&service=all_sale_premium

vin

VIN-номера.

Примечание

Если вы хотите добавить больше одного значения, укажите параметр несколько раз:

vin=skedeP0iddddA0111&vin=sewqfP0irtyuA0222

mark_model

Идентификаторы марки и модели, разделенные закодированным символом «#» (%23), например «MERCEDES%23C_KLASSE». Идентификатор модели может отсутствовать.

Примечание

Если вы хотите добавить больше одного значения, укажите параметр несколько раз:

mark_model=MERCEDES%23C_KLASSE&mark_model=HONDA

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

Причина блокировки объявления. Подробнее с описанием причин блокировки можно ознакомиться в Справочнике причин блокировки.


sort

Тип сортировки объявлений.

Допустимые значения:
  • 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 — по году, в порядке убывания.

auction

Фильтр. Показывает объявления, участвующие в аукционе.


Заголовки запроса

Заголовок

Описание

x-dealer-id

Идентификатор клиента. Используется для работы под учетной записью агентства.

x-session-id

Идентификатор сессии пользователя. Значение можно получить с помощью операции 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 — все категории ТС.