GET /search/trucks/breadcrumbs

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

Формат запроса

GET https://apiauto.ru/1.0/search/trucks/breadcrumbs
? [bc_lookup=<array[string]>]
& [rid=<array[string]>]
& [state=<array[string]>]

bc_lookup

Уровень иерархии. Тип коммерческого транспорта, идентификаторы марки и модели, разделенные закодированным символом «#» (%23), например TRUCK%23BAW%23FENIX. При указании значений следует соблюдать порядок тип коммерческого транспорта—марка—модель. Часть значений может отсутствовать.

Примечание

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

bc_lookup=TRUCK%23BAW&bc_lookup=TRUCK%23ALTKAM

rid

Массив идентификаторов регионов. Справочник регионов можно скачать по ссылке.

Примечание

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

rid=213&rid=215

state

Состояние транспорта.

Допустимые значения:
  • NEW — новый транспорт;
  • USED — транспорт с пробегом;
  • BEATEN — битый транспорт (для безопасной эксплуатации необходим ремонт).

Общая структура ответа приведена ниже. Порядок следования элементов не гарантируется. В структуре могут присутствовать служебные параметры, которые не описаны в таблице.

Формат ответа

Общая структура
{
  "breadcrumbs":[
    {
      "entities":[
        {
          ...
        },
        {
          ...
        }
      ],
      "meta_level":"{string}",  /* GENERATION_LEVEL */
      "mark":{
        ...
      },
      "model":{
        ...
      }
    },
    {
      "entities":[
        {
          ...
        },
        {
          ...
        }
      ],
      "meta_level":"{string}",  /* MODEL_LEVEL */
      "mark":{
        ...
      }
    },
    {
      "entities":[
        {
          ...
        },
        {
          ...
        }
      ],
      "meta_level":"{string}"  /* MARK_LEVEL */
    },
    {
    "entities":[
        {
          ...
        },
        {
          ...
        }
      ],
      "meta_level":"{string}"  /* TYPE_LEVEL */
    }
  ],
  "status":"{string}"
}

breadcrumbs

Найденные уровни иерархии из каталога транспортных средств. Каждый объект breadcrumb содержит уровни иерархии entities.

entities

Один из уровней иерархии. Структура каталога Авто.ру состоит из следующих уровней:

  • «TYPE»;
  • «MARK»;
  • «MODEL»;
  • «GENERATION».

В одном параметре entities выдается один из перечисленных уровней в порядке иерархии.

meta_level

Название уровня иерархии.

mark

Общая информация о данной марке.

model

Общая информация о данной модели.

status

Статус ответа.

Уровень иерархии «GENERATION»
    {
      "entities":[
        {
          "id":"{string}",
          "name":"{string}",
          "offers_count":{integer},
          "is_popular":{boolean},
          "super_gen":{
            "year_from":,
            "year_to":,
            "is_restyle":{boolean},
            "default_configuration_id":"{string}",
            "photo":{
              "name":"{string}",
              "sizes":{
                "{string}":"{string}",
                "{string}":"{string}"
              }
            }
          },
          "reviews_count": {integer}
        },
        {
          ...
        }
      ],
      "meta_level":"{string}",  /* GENERATION_LEVEL */
      "mark":{
        "id":"{string}",
        "name":"{string}",
        "offers_count":{integer},
        "is_popular":{boolean}, 
        "mark":{
          "logo":{
            "name":"{string}",
            "sizes":{
              "{string}":"{string}",
              "{string}":"{string}"
            }
          },
          "vendor_ids":[
            {integer},
            {integer}
          ],
          "cyrillic_name":"{string}"
        },
        "reviews_count": {integer}
      },
      "model":{
        "id":"{string}",
        "name":"{string}",
        "offers_count":{integer},
        "is_popular":{boolean},
        "model":{
          "default_configuration_id":"{string}",
          "nameplates":[
            {
              "name":"{string}",
              "code":"{string}",
              "autoru_id":"{string}",
              "offers_count":{integer}
            },
            {
              ...
            }
          ],
          "photo":{
            "name":"{string}",
            "sizes":{
              "{string}":"{string}",
              "{string}":"{string}"
            }
          },
          "cyrillic_name":"{string}"
        },
        "reviews_count": {integer}
      }
    }

entities

Уровень иерархии «GENERATION» — уровень поколения. На этом уровне перечисляются все поколения для указанной в запросе модели и количество активных объявлений по каждому поколению.

id

Идентификатор поколения.

name

Название поколения.

offers_count

Количество объявлений с данным поколением.

is_popular

Признак популярности поколения. Подсчет популярности основывается на рейтинге от экспертов области.

Допустимые значения:
  • true — поколение популярно;
  • false — поколение непопулярно.

super_gen

Подробное описание поколения.

year_from

Год начала выпуска поколения.

year_to

Год окончания выпуска поколения. Если значение пустое или равно нулю, то поколение еще выпускается.

is_restyle

Признак рестайлинга поколения.

Допустимые значения:
  • true — рестайлинг производился;
  • false — рестайлинг не производился.

default_configuration_id

Идентификатор конфигурации по умолчанию.

photo

Ссылки на фото.

name

Идентификатор фотографии.

sizes

Объект с возможными размерами фотографии. Пример: "120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90", где первый параметр — размер картинки, второй — URL-адрес картинки.

reviews_count

Количество отзывов на данное поколение.

meta_level

Название уровня иерархии.

mark

Подробное описание марки.

id

Идентификатор марки.

name

Название марки.

offers_count

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

is_popular

Признак популярности марки. Подсчет популярности основывается на рейтинге от экспертов области.

Допустимые значения:
  • true — марка популярна;
  • false — марка непопулярна.

mark

Подробное описание марки.

logo

Ссылка на логотип марки.

name

Идентификатор фотографии.

sizes

Объект с возможными размерами фотографии. Пример: "120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90", где первый параметр — размер картинки, второй — URL-адрес картинки.

vendor_ids

Массив идентификаторов производителей данной марки.

cyrillic_name

Название марки кириллицей.

reviews_count

Количество отзывов на данную марку.

model

Общая информация о данной модели.

id

Идентификатор модели.

name

Название модели.

offers_count

Общее количество объявлений по данной модели.

is_popular

Признак популярности модели. Подсчет популярности основывается на рейтинге от экспертов области.

Допустимые значения:
  • true — модель популярна;
  • false — модель непопулярна.

model

Общая информация о данной модели.

default_configuration_id

Идентификатор конфигурации по умолчанию.

nameplates

Разновидности модели. Массив объектов.

name

Название разновидности модели.

code

Код разновидности модели.

autoru_id

Идентификатор разновидности модели.

offers_count

Количество доступных объявлений для текущей разновидности модели.

moto_functions

Назначение мототранспорта (например, дорожный мотоцикл). Массив значений.

Внимание

Параметр актуален только для мототранспорта.

photo

Ссылки на фото.

name

Идентификатор фотографии.

sizes

Объект с возможными размерами фотографии. Пример: "120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90", где первый параметр — размер картинки, второй — URL-адрес картинки.

cyrillic_name

Название модели кириллицей.

reviews_count

Количество отзывов на данную модель.

Уровень иерархии «MODEL»
    {
      "entities":[
        {
          "id":"{string}",
          "name":"{string}",
          "offers_count":{integer},
          "is_popular":{boolean},
          "model":{
            "default_configuration_id":"{string}",
            "nameplates":[
              {
                "name":"{string}",
                "code":"{string}",
                "autoru_id":"{string}",
                "offers_count":{integer}
              },
              {
                ...
              }
            ],
            "photo":{
              "name":"{string}",
              "sizes":{
                "{string}":"{string}",
                "{string}":"{string}"
              }
            },
            "cyrillic_name":"{string}"
          },
          "reviews_count": {integer}
        },
        {
          ...
        }
      ],
      "meta_level":"{string}",  /* MODEL_LEVEL */
      "mark":{
        "id":"{string}",
        "name":"{string}",
        "offers_count":{integer},
        "is_popular":{boolean}, 
        "mark":{
          "logo":{
            "name":"{string}",
            "sizes":{
              "{string}":"{string}",
              "{string}":"{string}"
            }
          },
          "vendor_ids":[
            {integer},
            {integer}
          ],
          "cyrillic_name":"{string}"
        },
        "reviews_count": {integer}
      }
    }

entities

Уровень иерархии «MODEL» — уровень модели. На этом уровне перечисляются все модели для указанной в запросе марки и количество активных объявлений по каждой модели.

id

Идентификатор модели.

name

Название модели.

offers_count

Общее количество объявлений по данной модели.

is_popular

Признак популярности модели. Подсчет популярности основывается на рейтинге от экспертов области.

Допустимые значения:
  • true — модель популярна;
  • false — модель непопулярна.

model

Подробное описание модели.

default_configuration_id

Идентификатор конфигурации по умолчанию.

nameplates

Разновидности модели. Массив объектов.

name

Название модели.

code

Код разновидности модели.

autoru_id

Идентификатор разновидности модели.

offers_count

Количество доступных объявлений для текущей разновидности модели.

moto_functions

Назначение мототранспорта (например, дорожный мотоцикл). Массив значений.

Внимание

Параметр актуален только для мототранспорта.

photo

Ссылки на фото.

name

Идентификатор фотографии.

sizes

Объект с возможными размерами фотографии. Пример: "120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90", где первый параметр — размер картинки, второй — URL-адрес картинки.

cyrillic_name

Название модели кириллицей.

reviews_count

Количество отзывов на данную модель.

meta_level

Название уровня иерархии.

mark

Подробное описание марки.

id

Идентификатор марки.

name

Название марки.

offers_count

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

is_popular

Признак популярности марки. Подсчет популярности основывается на рейтинге от экспертов области.

Допустимые значения:
  • true — марка популярна;
  • false — марка непопулярна.

mark

Подробное описание марки.

logo

Ссылка на логотип марки.

name

Идентификатор фотографии.

sizes

Объект с возможными размерами фотографии. Пример: "120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90", где первый параметр — размер картинки, второй — URL-адрес картинки.

vendor_ids

Массив идентификаторов производителей данной марки.

cyrillic_name

Название марки кириллицей.

reviews_count

Количество отзывов на данную марку.

Уровень иерархии «MARK»
    {
      "entities":[
        {
          "id":"{string}",
          "name":"{string}",
          "offers_count":{integer},
          "is_popular":{boolean}, 
          "mark":{
            "logo":{
              "name":"{string}",
              "sizes":{
                "{string}":"{string}",
                "{string}":"{string}"
              }
            },
            "vendor_ids":[
              {integer},
              {integer}
            ],
            "cyrillic_name":"{string}"
          },
          "reviews_count": {integer}
        },
        {
          ...
        }
      ],
      "meta_level":"{string}"  /* MARK_LEVEL */
    }

entities

Уровень иерархии «MARK» — уровень марки. На этом уровне перечисляются все марки с активными объявлениями и количество активных объявлений по каждой марке.

id

Идентификатор марки.

name

Название марки.

offers_count

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

is_popular

Признак популярности марки. Подсчет популярности основывается на рейтинге от экспертов области.

Допустимые значения:
  • true — марка популярна;
  • false — марка непопулярна.

mark

Подробное описание марки.

logo

Ссылка на логотип марки.

name

Идентификатор фотографии.

sizes

Объект с возможными размерами фотографии. Пример: "120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90", где первый параметр — размер картинки, второй — URL-адрес картинки.

vendor_ids

Массив идентификаторов производителей данной марки.

cyrillic_name

Название марки кириллицей.

reviews_count

Количество отзывов на данную марку.

meta_level

Название уровня иерархии.

Уровень иерархии «TYPE»
    {
      "entities":[
        {
          "id":"{string}",
          "name":"{string}",
          "offers_count":{integer},
          "reviews_count": {integer}
        },
        {
          ...
        }
      ],
      "meta_level":"{string}"  /* TYPE_LEVEL */
    }

entities

Уровень иерархии «TYPE» — уровень типа транспортного средства. На этом уровне перечисляются все типы с активными объявлениями и количеством активных объявлений по каждому типу.

id

Идентификатор типа транспорта.

name

Название типа транспорта.

offers_count

Общее количество объявлений по данному типу транспорта.

reviews_count

Количество отзывов по данному типа транспорта.

meta_level

Название уровня иерархии.

Коды ответа

Код

Причина

Описание

200

OK

Успешный запрос.

400

BAD_REQUEST

Синтаксическая ошибка в запросе.

500

INTERNAL SERVER ERROR

Внутренняя ошибка сервера.

Пример

Запрос:

curl -i -X GET 'https://apiauto.ru/1.0/search/trucks/breadcrumbs?bc_lookup=TRUCK%23BAW%23FENIX&rid=213' -H 'x-authorization: 2dtrer432...'

Ответ:

{
  "breadcrumbs": [
    {
      "entities": [
        {
          "id": "20586463",
          "super_gen": {
            "year_from": 2005
          }
        },
        {
          "id": "20589934",
          "super_gen": {}
        },
        {
          "id": "20590316",
          "super_gen": {}
        },
        {
          "id": "20590560",
          "super_gen": {}
        }
      ],
      "meta_level": "GENERATION_LEVEL",
      "mark": {
        "id": "BAW",
        "name": "BAW",
        "mark": {
          "logo": {
            "name": "mark-logo",
            "sizes": {
              "logo": "//avatarrf/54df507521486/logo"
            }
          }
        }
      },
      "model": {
        "id": "FENIX",
        "name": "Fenix",
        "model": {
          "photo": {
            "name": "model-photo",
            "sizes": {
              "main": "//avatar5ref/507542/trucks-catalog0443r118/mobile",
              "mini-card": "//avatarstr/507652/trucks-catalog120/minicard"
            }
          }
        }
      }
    },
    {
      "entities": [
        {
          "id": "FENIX",
          "name": "Fenix",
          "offers_count": 12,
          "model": {
            "photo": {
              "name": "model-photo",
              "sizes": {
                "main": "//avatar54/655072/trucks-catalog.g2148/mobile",
                "mini-card": "//avatars643r/54350/trucks-catalog481445818/minicard"
              }
            }
          }
        }
      ],
      "meta_level": "MODEL_LEVEL",
      "mark": {
        "id": "BAW",
        "name": "BAW",
        "mark": {
          "logo": {
            "name": "mark-logo",
            "sizes": {
              "logo": "//avatars/59032/trucks-catalog54rf148/logo"
            }
          }
        }
      }
    },
    {
      "entities": [
        {
          "id": "ALTKAM",
          "name": "Altkam",
          "mark": {
            "logo": {
              "name": "mark-logo",
              "sizes": {
                "logo": "//avatarstet/507yt452/trucks-catalogrf86324/logo"
              }
            }
          }
        },
        {
          "id": "ASTRA",
          "name": "ASTRA",
          "mark": {
            "logo": {
              "name": "mark-logo",
              "sizes": {
                "logo": "//avatarstuto/507t532/trucks-catalog1154v76/logo"
              }
            }
          }
        },
        {
          "id": "NISSAN",
          "name": "Nissan",
          "offers_count": 11,
          "is_popular": true,
          "mark": {
            "logo": {
              "name": "mark-logo",
              "sizes": {
                "logo": "//avatarrt34/50489/trucks-catalog43d504/logo"
              }
            }
          }
        },
        {
          ...
        }
      ],
      "meta_level": "MARK_LEVEL"
    },
    {
      "entities": [
        {
          "id": "TRUCK",
          "name": "Грузовик",
          "offers_count": 858,
          "reviews_count": 130
        },
        {
          "id": "BUS",
          "name": "Автобус",
          "offers_count": 146,
          "reviews_count": 5
        },
        {
          "id": "ARTIC",
          "name": "Седельный тягач",
          "offers_count": 472,
          "reviews_count": 25
        },
        {
          "id": "TRAILER",
          "name": "Прицеп",
          "offers_count": 475,
          "reviews_count": 19
        },
        {
          "id": "SWAP_BODY",
          "name": "Съемный кузов"
        },
        {
          "id": "LCV",
          "name": "Легкий коммерческий",
          "offers_count": 3577,
          "reviews_count": 431
        },
        {
          "id": "AGRICULTURAL",
          "name": "Сельскохозяйственная",
          "offers_count": 14
        },
        {
          "id": "AUTOLOADER",
          "name": "Автопогрузчики",
          "offers_count": 82
        },
        {
          "id": "BULLDOZERS",
          "name": "Бульдозеры",
          "offers_count": 27
        },
        {
          "id": "CONSTRUCTION",
          "name": "Строительная",
          "offers_count": 103
        },
        {
          "id": "CRANE",
          "name": "Автокран",
          "offers_count": 63
        },
        {
          "id": "CRANE_HYDRAULICS",
          "name": "Самопогрузчики",
          "offers_count": 80
        },
        {
          "id": "DREDGE",
          "name": "Экскаваторы",
          "offers_count": 99
        },
        {
          "id": "MUNICIPAL",
          "name": "Коммунальная",
          "offers_count": 80
        }
      ],
      "meta_level": "TYPE_LEVEL"
    }
  ],
  "status": "SUCCESS"
}

Уровень иерархии. Тип коммерческого транспорта, идентификаторы марки и модели, разделенные закодированным символом «#» (%23), например TRUCK%23BAW%23FENIX. При указании значений следует соблюдать порядок тип коммерческого транспорта—марка—модель. Часть значений может отсутствовать.

Примечание

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

bc_lookup=TRUCK%23BAW&bc_lookup=TRUCK%23ALTKAM

Массив идентификаторов регионов. Справочник регионов можно скачать по ссылке.

Примечание

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

rid=213&rid=215

Состояние транспорта.

Допустимые значения:
  • NEW — новый транспорт;
  • USED — транспорт с пробегом;
  • BEATEN — битый транспорт (для безопасной эксплуатации необходим ремонт).

Подробное описание марки.

Подробное описание модели.

Предыдущая
GET /search/moto/breadcrumbs
Следующая
GET /reference/catalog/cars/complectations