GET /search/cars/breadcrumbs

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

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

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

bc_lookup

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

Примечание

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

bc_lookup=MERCEDES%23C_KLASSE%232307688&bc_lookup=HONDA

rid

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

Примечание

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

rid=213&rid=215

state

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

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

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

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

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

breadcrumbs

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

entities

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

  • «MARK»;
  • «MODEL»;
  • «GENERATION»;
  • «CONFIGURATION»;
  • «TECH_PARAMS».

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

meta_level

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

offers_count

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

mark

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

model

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

super_generation

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

configuration

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

status

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

Уровень иерархии «TECH_PARAM»
    {
      "entities":[
        {
          "id":"{string}",
          "name":"{string}",
          "offers_count":{integer},
          "is_popular":{boolean},
          "tech_params":{
            "nameplate_engine":"{string}",
            "engine_type":"{string}",
            "displacement":{integer},
            "gear_type":"{string}",
            "transmission":"{string}",
            "power":{integer},
            "power_kvt":"{string}",
            "year_start":{integer},
            "year_stop":{integer},
            "human_name":"{string}"
          },
          "reviews_count":{integer}
        },
        {
          ...
        }
      ],
      "meta_level":"{string}",  /* TECH_PARAM_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}
      },
      "super_generation":{
        "id":"{string}",
        "name":"{string}",
        "offers_count":{integer},
        "is_popular":{boolean},
        "super_gen":{
          "year_from":{integer},
          "year_to":{integer},
          "is_restyle":{boolean},
          "default_configuration_id":"{string}",
          "photo":{
            "name":"{string}",
            "sizes":{
              "{string}":"{string}",
              "{string}":"{string}"
            }
          }
        },
        "reviews_count":{integer}
      },
      "configuration":{
        "id":"{string}",
        "name":"{string}",
        "offers_count":{integer},
        "is_popular":{boolean},
        "configuration":{
          "body_type":"{string}",
          "doors_count":"{string}",
          "configuration_name":"{string}",
          "photo":{
            "name":"{string}",
            "sizes":{
              "{string}":"{string}",
              "{string}":"{string}"
            }
          },
          "human_name":"{string}"
        },
        "reviews_count":{integer}
      }
    }

entities

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

id

Идентификатор набора технических характеристик.

name

Название набора технических характеристик.

offers_count

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

is_popular

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

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

tech_params

Подробное описание данного набора технических характеристик.

nameplate_engine

Разновидность модели.

engine_type

Тип двигателя.

Допустимые значения:
  • DIESEL — дизель;
  • ELECTRO — электро;
  • GASOLINE — бензин;
  • HYBRID — гибрид;
  • LPG — ГБО.

displacement

Объем двигателя в куб. см.

gear_type

Тип привода.

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

transmission

Тип коробки передач.

Допустимые значения:
  • MECHANICAL — механическая коробка;
  • AUTOMATIC — автоматическая коробка;
  • ROBOT — коробка-робот;
  • VARIATOR — коробка-вариатор.

power

Мощность двигателя в л. с.

power_kvt

Мощность двигателя в кВт.

year_start

Год начала выпуска набора технических характеристик.

year_stop

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

human_name

Название набора технических характеристик для отображения в пользовательском интерфейсе.

reviews_count

Количество отзывов на данный набор технических характеристик.

meta_level

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

offers_count

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

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

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

super_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

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

configuration

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

id

Идентификатор конфигурации. Список конфигураций с идентификаторами можно получить с помощью операции GET /search/cars/breadcrumbs.

name

Название конфигурации.

offers_count

Количество объявлений с данной конфигурацией.

is_popular

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

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

configuration

Подробное описание конфигурации.

body_type

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

doors_count

Число дверей.

configuration_name

Название конфигурации.

photo

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

name

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

sizes

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

human_name

Название набора технических характеристик для отображения в пользовательском интерфейсе.

reviews_count

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

Уровень иерархии «CONFIGURATION»
    {
      "entities":[
        {
          "id":"{string}",
          "name":"{string}",
          "offers_count":"{number}",
          "is_popular":"{boolean}",
          "configuration":{
            "body_type":"{string}",
            "doors_count":"{string}",
            "configuration_name":"{string}",
            "photo":{
              "name":"{string}",
              "sizes":{
                "key1":"{string}",
                "key2":"{string}"
              }
            },
            "human_name":"{string}"
          },
          "reviews_count":{integer}
        },
        {
          
        }
      ],
      "meta_level":"{string}",
      "mark":{
        "id":"{string}",
        "name":"{string}",
        "offers_count":"{number}",
        "is_popular":"{boolean}", 
        "mark":{
          "logo":{
            "name":"{string}",
            "sizes":{
              "key1":"{string}",
              "key2":"{string}"
            }
          },
          "vendor_ids":[
            "{number}",
            "{number}"
          ],
          "cyrillic_name":"{string}"
        },
        "reviews_count":{integer}
      },
      "model":{
        "id":"{string}",
        "name":"{string}",
        "offers_count":"{number}",
        "is_popular":"{boolean}",
        "model":{
          "default_configuration_id":"{string}",
          "nameplates":[
            {
              "name":"{string}",
              "code":"{string}",
              "autoru_id":"{string}",
              "offers_count":"{number}"
            },
            {
              
            }
          ],
          "photo":{
            "name":"{string}",
            "sizes":{
              "key1":"{string}",
              "key2":"{string}"
            }
          },
          "cyrillic_name":"{string}"
        },
        "reviews_count":{integer}
      },
      "super_generation":{
        "id":"{string}",
        "name":"{string}",
        "offers_count":"{number}",
        "is_popular":"{boolean}",
        "super_gen":{
          "year_from":"{number}",
          "year_to":"{number}",
          "is_restyle":"{boolean}",
          "default_configuration_id":"{string}",
          "photo":{
            "name":"{string}",
            "sizes":{
              "{string}":"{string}",
              "{string}":"{string}"
            }
          }
        },
        "reviews_count":{integer}
      }
    }

entities

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

id

Идентификатор конфигурации. Список конфигураций с идентификаторами можно получить с помощью операции GET /search/cars/breadcrumbs.

name

Название конфигурации.

offers_count

Количество объявлений с данной конфигурацией.

is_popular

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

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

configuration

Подробное описание конфигурации.

body_type

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

doors_count

Число дверей.

configuration_name

Название конфигурации.

photo

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

name

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

sizes

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

human_name

Название конфигурации для отображения в пользовательском интерфейсе.

reviews_count

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

meta_level

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

offers_count

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

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

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

super_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

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

Уровень иерархии «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

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

offers_count

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

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

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

offers_count

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

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 */
      "offers_count":{integer}
    }

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

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

offers_count

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

Коды ответа

Код

Причина

Описание

200

OK

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

400

BAD_REQUEST

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

500

INTERNAL SERVER ERROR

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

Пример

Запрос:

curl -i -X GET 'https://apiauto.ru/1.0/search/cars/breadcrumbs?bc_lookup=HONDA%23CIVIC%234569475%236470343&state=USED&state=NEW&rid=213' -H 'x-authorization: 2dtrer432...'

Ответ:

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 30 Aug 2017 12:12:33 GMT
Content-Type: application/json
Content-Length: 93557
Connection: keep-alive

{
  "breadcrumbs": [
    {
      "entities": [
        {
          "id": "6470353",
          "offers_count": 4,
          "tech_params": {
            "engine_type": "GASOLINE",
            "displacement": 1799,
            "gear_type": "FORWARD_CONTROL",
            "transmission": "MECHANICAL",
            "power": 140,
            "power_kvt": "103.0",
            "year_start": 2009,
            "year_stop": 2011,
            "human_name": "1.8 MT (140 л.с.)"
          }
        },
        {
           ...
        }
      ],
      "meta_level": "TECH_PARAM_LEVEL",
      "mark": {
        "id": "HONDA",
        "name": "Honda"
      },
      "model": {
        "id": "CIVIC",
        "name": "Civic"
      },
      "super_generation": {
        "id": "4569475",
        "name": "VIII Рестайлинг",
        "super_gen": {
          "year_from": 2008,
          "year_to": 2012
        }
      },
      "configuration": {
        "id": "6470343",
        "configuration": {
          "body_type": "HATCHBACK_5_DOORS"
        }
      }
    },
    {
      "entities": [
        {
          "id": "4569496",
          "offers_count": 379,
          "configuration": {
            "body_type": "SEDAN",
            "doors_count": 4,
            "photo": {
              "name": "configuration-photo",
              "sizes": {
                "main": "//avat/5694/gallery",
                "mini-card": "//ava/34230/minicard",
                "mobile": "//avata/5232314/main"
              }
            },
            "human_name": "Седан"
          }
        },
        {
          ...
        }       
      ],
      "meta_level": "CONFIGURATION_LEVEL",
      "mark": {
        "id": "HONDA",
        "name": "Honda"
      },
      "model": {
        "id": "CIVIC",
        "name": "Civic"
      },
      "super_generation": {
        "id": "4569475",
        "name": "VIII Рестайлинг",
        "super_gen": {
          "year_from": 2008,
          "year_to": 2012
        }
      }
    },
    {
      "entities": [
        {
          "id": "20704275",
          "name": "X",
          "super_gen": {
            "year_from": 2015,
            "default_configuration_id": "20704347",
            "photo": {
              "name": "gen-photo",
              "sizes": {
                "main": "//avfewf/322/gallery",
                "mini-card": "//avata/8632352/minicard",
                "mobile": "//avat86/97243152/main"
              }
            }
          }
        },
        {
          ...
        }
      "meta_level": "GENERATION_LEVEL",
      "mark": {
        "id": "HONDA",
        "name": "Honda"
      },
      "model": {
        "id": "CIVIC",
        "name": "Civic"
      }
    },
    {
      "entities": [
        {
          "id": "ACCORD",
          "name": "Accord",
          "offers_count": 1953,
          "model": {
            "default_configuration_id": "20668999",
            "nameplates": [
              {
                "name": "Type R",
                "code": "9265363",
                "autoru_id": "2214",
                "offers_count": 3
              },
              {
                "name": "Type S",
                "code": "9265364",
                "autoru_id": "2216",
                "offers_count": 223
              }
            ],
            "cyrillic_name": "Аккорд"
          }
        },
        {
          ...
        },
      ],
      "meta_level": "MODEL_LEVEL",
      "mark": {
        "id": "HONDA",
        "name": "Honda"
      }
    },
    {
      "entities": [
        {
          "id": "AC",
          "name": "AC",
          "offers_count": 6,
          "mark": {
            "logo": {
              "name": "mark-logo",
              "sizes": {
                "logo": "//avafger7521/logo",
                "big-logo": "//avatargreee/81/dealer_logo"
              }
            },
            "vendor_ids": [
              14
            ],
            "cyrillic_name": "АС"
          }
        },
        {
          "id": "ACURA",
          "name": "Acura",
          "offers_count": 210,
          "mark": {
            "logo": {
              "name": "mark-logo",
              "sizes": {
                "logo": "//avater/50372/catadfe/logo",
                "big-logo": "//avaterfe/50372/catfrg/dealer_logo"
              }
            },
            "vendor_ids": [
              7
            ],
            "cyrillic_name": "Акура"
          }
        },
        {
          ...
        }
      ],
      "meta_level": "MARK_LEVEL",
      "offers_count": 646348
    }
  ],
  "status": "SUCCESS"
}

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

Примечание

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

bc_lookup=MERCEDES%23C_KLASSE%232307688&bc_lookup=HONDA

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

Примечание

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

rid=213&rid=215

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

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

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

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

Подробное описание конфигурации.

Предыдущая
Операции с ресурсами API
Следующая
GET /search/moto/breadcrumbs