История объявлений по ТС с фото

A.0024.ADS.HIS

Содержит информацию о размещении объявления о продаже транспортного средства на крупнейших интернет-досках: auto.ru, drom.ru, avito.ru, youla.ru, дополненную фотографиями — как с этих досок, так и из прочих источников в сети Интернет.

Источники данных — интернет-доски объявлений, открытые источники в интернете.

Идентификаторы объекта: ГРЗ и ответ блока A.0005.NOR.DIR.

Иcпользуемые источники: ads.base, images.archive.

Время генерации отчёта:

  • 50-й перцентиль — 60 с;
  • 95-й перцентиль — 450 с.

Параметры запроса

При отправке запроса на генерацию отчёта в теле запроса указываются следующие параметры:

Параметр Тип Обязательность Описание
queryType string Обязательный Тип идентификатора ТС.
Возможные значения: GRZ
query string Обязательный Значение идентификатора ТС

Пример тела запроса

{
  "queryType": "GRZ",
  "query": "А111АА00"
}

Структура отчёта

Данные отчёта находятся в объекте data[].content.ads.history тела ответа.

Все даты в отчёте указываются в формате YYYY-MM-DD hh:mm:ss.

Поле Тип Описание
items[].title string Заголовок объявления
items[].text string Текст объявления
items[].date.publish string Дата публикации объявления
items[].seller.name string Имя продавца ТС
items[].seller.phones array Телефоны продавца ТС
items[].geo object Геоданные места продажи
items[].price.value integer Цена ТС в объявлении
items[].photos.local array Список URI до локальных фотографий ТС с объявления
items[].photos.board array Список URI фотографий ТС с доски объявлений
items[].photos.grz object Список ГРЗ c URI фотографии, на которых они распознаны
items[].is_sold boolean ТС было помечено как продано
items[].is_closed boolean ТС было помечено как закрытое
items[].vehicle.brand.name string Наименование марки (бренда)
items[].vehicle.model.name string Модель
items[].vehicle.identifiers.vin string Маскированный VIN
items[].vehicle.identifiers.chassis string Маскированный номер шасси
items[].vehicle.year integer Год выпуска ТС
items[].vehicle.condition string Состояние ТС
items[].vehicle.wheel.position string Расположение руля.
Справочник значений
items[].vehicle.transmission.type string Тип трансмиссии.
Справочник значений
items[].vehicle.drive.type string Тип привода.
Возможные значения: Передний, Переднеприводной, Задний, Заднеприводной, Полный, Полноприводной, Иные
items[].vehicle.passport.type string Информация о паспорте ТС
items[].vehicle.doors.count integer Количество дверей у ТС
items[].vehicle.owners.count integer Количество владельцев ТС
items[].vehicle.engine.power.hp number Мощность двигателя ТС, л. с.
items[].vehicle.engine.volume number Объем двигателя, см³
items[].vehicle.engine.fuel.type string Тип топлива.
Возможные значения: Бензиновый, Дизельный, Газовый, Гибридный, Электрический, Прочее
items[].vehicle.body.type string Тип кузова
items[].vehicle.body.color.name string Цвет кузова
items[].vehicle.mileage integer Пробег ТС
items[].vehicle.is_cleared boolean Растаможено ли ТС
date.update string Дата обновления данных
count integer Количество найденных записей об объявлениях

Геоданные места продажи

Поле Тип Описание
country string Страна
region string Регион (область)
city string Город
street string Улица
house string Дом

Справочник Расположение руля

Значение Описание
LEFT Слева
RIGHT Справа
UNKNOWN Неизвестно

Справочник Тип трансмиссии

Значение Описание
AUTOMATIC Автоматическая
MANUAL Механическая
ROBOT Роботизированная
VARIABLE Вариатор
UNKNOWN Неизвестно

Пример данных отчёта

{
  "data": [
    {
      "report_type_uid": "A.0024.ADS.HIS_test_report@test_domain",
      "progress_ok": 2,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "ads.base",
            "state": "OK",
            "extended_state": "OK"
          },
          {
            "_id": "images.archive",
            "state": "OK",
            "extended_state": "OK"
          }
        ]
      },
      "content": {
        "ads": {
          "history": {
            "items": [
              {
                "title": "Opel Monterey, 2018",
                "text": "Продаю семейный автомобиль в отличном состоянии, вложений никаких не требует. Все работает без нареканий.",
                "date": {
                  "publish": "2019-01-14 11:57:00"
                },
                "seller": {
                  "name": "Артём",
                  "phones": [
                    "+79999999999"
                  ]
                },
                "geo": {
                  "country": "Россия",
                  "city": "Москва"
                },
                "price": {
                  "value": 450000
                },
                "photos": {
                  "local": [
                    "https://example.com/1024/740/transport/?12345",
                    "https://example.com/1024/740/transport/?12344",
                    "https://example.com/1024/740/transport/?12343"
                  ],
                  "board": [
                    "https://example.com/1024/740/transport/?12340",
                    "https://example.com/1024/740/transport/?12341",
                    "https://example.com/1024/740/transport/?12342"
                  ],
                  "grz": {
                    "А111АА00": [
                      "https://example.com/1024/740/transport/?12346",
                      "https://example.com/1024/740/transport/?12347",
                      "https://example.com/1024/740/transport/?12348"
                    ]
                  }
                },
                "is_sold": false,
                "is_closed": false,
                "vehicle": {
                  "brand": {
                    "name": "Opel"
                  },
                  "model": {
                    "name": "Monterey"
                  },
                  "identifiers": {
                    "vin": "EXAMPL0V*N1****00",
                    "chassis": "6****93"
                  },
                  "year": 2018,
                  "condition": "Не битый",
                  "wheel": {
                    "position": "LEFT"
                  },
                  "transmission": {
                    "type": "MANUAL"
                  },
                  "drive": {
                    "type": "Передний"
                  },
                  "passport": {
                    "type": "Дубликат"
                  },
                  "doors": {
                    "count": 4
                  },
                  "owners": {
                    "count": 2
                  },
                  "engine": {
                    "power": {
                      "hp": 176.3
                    },
                    "volume": 2793.2,
                    "fuel": {
                      "type": "Бензиновый"
                    }
                  },
                  "body": {
                    "type": "Седан",
                    "color": {
                      "name": "Серебряный"
                    }
                  },
                  "mileage": 79000,
                  "is_cleared": false
                }
              }
            ],
            "date": {
              "update": "2020-07-10 22:10:00"
            },
            "count": 1
          }
        }
      }
    }
  ]
}