Avito Evaluation API

openapi: 3.0.0
info:
  contact:
    email: supportautoload@avito.ru
  description: 'API для взаимодействия с иерархией аккаунтов в Авито

    **Авито API для бизнеса предоставляется согласно [Условиям использования](https://www.avito.ru/legal/pro_tools/public-api).**

    '
  title: Иерархия Аккаунтов Access Evaluation API
  version: '1'
servers:
- url: https://api.avito.ru/
tags:
- name: Evaluation
  x-displayName: Оценка и характеристики автомобиля
  x-subdivName: Оценка и характеристики автомобиля
paths:
  /autoteka/v1/catalogs/resolve:
    post:
      description: 'Метод для получения возможных параметров для заполнения пользователем.

        Первый запрос можно сделать без параметров, получить данные и далее, передавая нужные id и valueId в повторном запросе, получить все параметры.

        '
      operationId: catalogsResolve
      parameters:
      - $ref: '#/components/parameters/authHeader'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestCatalogsResolve'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsResolveResponseBodyAutoteka'
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/validatingError'
          description: Ошибка валидации входных параметров
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbiddenError'
          description: Операцию невозможно выполнить
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/notFoundError'
          description: Информация не найдена
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internalError'
          description: Информация об ошибке
      security:
      - ClientCredentials: []
      summary: 'Получение актуальных параметров Автокаталога

        '
      tags:
      - Evaluation
  /autoteka/v1/specifications/by-plate-number:
    x-gateway:
      timeouts:
        connect: 200ms
        envoy: 5.0s
        read: 5s
        send: 5s
    post:
      description: 'Метод для запроса на получение спецификации по регистрационному номеру, возвращает идентификатор спецификации, по которому можно получить спецификацию в [методе для получения спецификации](#operation/specificationGetById).


        Чтобы подключить эту возможность, обратитесь к менеджеру Автотеки. Обратите внимание, что для её подключения надо завести отдельную учётную запись Автотеки.

        '
      operationId: specificationByPlateNumber
      parameters:
      - $ref: '#/components/parameters/authHeader'
      requestBody:
        content:
          application/json:
            example:
              plateNumber: X793YX77
            schema:
              $ref: '#/components/schemas/RequestReportByPlateNumberAutoteka'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateSpecificationResponseBodyAutoteka'
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/validatingError'
          description: Ошибка валидации входных параметров
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbiddenError'
          description: Операцию невозможно выполнить
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/notFoundError'
          description: Информация не найдена
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/tooManyRequestsError'
          description: Превышено допустимое количество запросов
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internalError'
          description: Информация об ошибке
      security:
      - ClientCredentials: []
      summary: 'Запрос характеристик по регистрационному номеру

        '
      tags:
      - Evaluation
  /autoteka/v1/specifications/by-vehicle-id:
    x-gateway:
      timeouts:
        connect: 200ms
        envoy: 5.0s
        read: 5s
        send: 5s
    post:
      description: 'Метод для запроса на получение спецификации по идентификатору авто (vin/frame), возвращает идентификатор спецификации, по которому можно получить спецификацию в [методе для получения спецификации](#operation/specificationGetById).


        Чтобы подключить эту возможность, обратитесь к менеджеру Автотеки. Обратите внимание, что для её подключения надо завести отдельную учётную запись Автотеки.

        '
      operationId: specificationByVehicleId
      parameters:
      - $ref: '#/components/parameters/authHeader'
      requestBody:
        content:
          application/json:
            example:
              vehicleId: XTA210990Y2766111
            schema:
              $ref: '#/components/schemas/RequestReportByVehicleIdAutoteka'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateSpecificationResponseBodyAutoteka'
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/validatingError'
          description: Ошибка валидации входных параметров
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbiddenError'
          description: Операцию невозможно выполнить
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/notFoundError'
          description: Информация не найдена
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internalError'
          description: Информация об ошибке
      security:
      - ClientCredentials: []
      summary: 'Запрос характеристик по идентификатору авто (vin/frame)

        '
      tags:
      - Evaluation
  /autoteka/v1/specifications/specification/{specificationID}:
    parameters:
    - $ref: '#/components/parameters/authHeader'
    - description: Идентификатор спецификации
      in: path
      name: specificationID
      required: true
      schema:
        minimum: 1
        type: integer
    get:
      description: 'Метод для получения спецификации по ее идентификатору.


        Чтобы подключить эту возможность, обратитесь к менеджеру Автотеки. Обратите внимание, что для её подключения надо завести отдельную учётную запись Автотеки.

        '
      operationId: specificationGetById
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSpecificationResponseBodyAutoteka'
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/validatingError'
          description: Ошибка валидации входных параметров
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbiddenError'
          description: Операцию невозможно выполнить
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/notFoundError'
          description: Информация не найдена
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internalError'
          description: Информация об ошибке
      security:
      - ClientCredentials: []
      summary: 'Получение характеристик по ID запроса

        '
      tags:
      - Evaluation
  /autoteka/v1/valuation/by-specification:
    x-gateway:
      timeouts:
        connect: 200ms
        envoy: 5.0s
        read: 5s
        send: 5s
    post:
      description: 'Метод для получения оценки по параметрам, полученным из методов [получения спецификации по ее идентификатору](#operation/specificationID) и [получения параметров автокаталога Авито](#operation/catalogsResolve)


        Чтобы подключить эту возможность, обратитесь к менеджеру Автотеки. Обратите внимание, что для её подключения надо завести отдельную учётную запись Автотеки.

        '
      operationId: valuationBySpecification
      parameters:
      - $ref: '#/components/parameters/authHeader'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestValuationBySpecificationResolve'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValuationBySpecificationResponseBodyAutoteka'
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/validatingError'
          description: Ошибка валидации входных параметров
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbiddenError'
          description: Операцию невозможно выполнить
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/notFoundError'
          description: Информация не найдена
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/tooManyRequestsError'
          description: Превышено допустимое количество запросов
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internalError'
          description: Информация об ошибке
      security:
      - ClientCredentials: []
      summary: 'Получение оценки по параметрам

        '
      tags:
      - Evaluation
components:
  schemas:
    CatalogsResolveResponseDataAutoteka:
      properties:
        fields:
          items:
            $ref: '#/components/schemas/CatalogsFieldAutoteka'
          type: array
      required:
      - fields
      type: object
    GetSpecificationResponseDataAutoteka:
      properties:
        documents:
          $ref: '#/components/schemas/DocumentsResultAutoteka'
        newCarValuations:
          description: 'Массив оценок новых авто с аналогичной спецификацией.


            Чтобы подключить эту возможность, обратитесь к менеджеру Автотеки.

            '
          items:
            $ref: '#/components/schemas/NewCarValuation'
          nullable: true
          type: array
        specification:
          $ref: '#/components/schemas/SpecificationResultAutoteka'
        valuation:
          $ref: '#/components/schemas/AvitoPriceValuation'
      type: object
    RequestReportByPlateNumberAutoteka:
      properties:
        plateNumber:
          description: Регистрационный номер запрашиваемого авто.
          minLength: 1
          type: string
      required:
      - plateNumber
      type: object
    tooManyRequestsError:
      properties:
        error:
          properties:
            code:
              description: Код ошибки
              example: 429
              format: int32
              type: integer
          required:
          - code
          type: object
      type: object
    NewCarValuation:
      description: Оценка нового авто на основе рынка Авито
      properties:
        avgPrice:
          description: Средняя цена на основе объявлений
          example: 2010000
          type: integer
        bodyType:
          description: Тип автомобиля
          example: Универсал
          type: string
        brand:
          description: Бренд
          example: ВАЗ (LADA)
          type: string
        complectation:
          description: Комплектация
          example: Enjoy'24
          type: string
        drive:
          description: Привод
          example: Передний
          type: string
        engineType:
          description: Тип двигателя
          example: Бензин
          type: string
        maxPrice:
          description: Максимальная цена на основе объявлений
          example: 2050000
          type: integer
        medianPrice:
          description: Средняя цена на основе объявлений
          example: 2020000
          type: integer
        minPrice:
          description: Минимальная цена на основе объявлений
          example: 2000000
          type: integer
        model:
          description: Модель
          example: Largus Cross
          type: string
        modification:
          description: Модификация
          example: 1.6 MT (106 л.с.)
          type: string
        transmission:
          description: Коробка передач
          example: Механика
          type: string
        year:
          description: Год выпуска
          example: 2025
          type: integer
      required:
      - brand
      - model
      - year
      - modification
      - bodyType
      - complectation
      - drive
      - transmission
      - engineType
      - avgPrice
      - medianPrice
      - minPrice
      - maxPrice
      type: object
    RequestCatalogsResolve:
      properties:
        fieldsValueIds:
          description: Выбранные значения параметров
          items:
            properties:
              id:
                description: Идентификатор параметра из каталога Авито
                example: 110000
                format: int64
                minimum: 1
                type: integer
              valueId:
                description: Идентификатор значения из каталога Авито
                example: 403153
                format: int64
                minimum: 1
                type: integer
            required:
            - id
            - valueId
            type: object
          type: array
      required:
      - fieldsValueIds
      type: object
    SpecificationNormalizedSpecificationAutoteka:
      nullable: true
      properties:
        bodyType:
          description: Кузов
          nullable: true
          properties:
            value:
              description: Значение
              example: Внедорожник
              type: string
            valueId:
              description: Идентификатор значения
              example: 331231
              format: int64
              type: integer
          required:
          - valueId
          - value
          type: object
        brand:
          description: Бренд
          nullable: true
          properties:
            value:
              description: Значение
              example: Chery
              type: string
            valueId:
              description: Идентификатор значения
              example: 329210
              format: int64
              type: integer
          required:
          - valueId
          - value
          type: object
        capacity:
          description: Емкость
          nullable: true
          properties:
            value:
              description: Значение
              example: 129
              format: float64
              type: number
          required:
          - value
          type: object
        complectation:
          description: Комплектация
          nullable: true
          properties:
            value:
              description: Значение
              example: Comfort
              type: string
            valueId:
              description: Идентификатор значения
              example: 369961
              format: int64
              type: integer
          required:
          - valueId
          - value
          type: object
        doorsCount:
          description: Количество дверей
          nullable: true
          properties:
            value:
              description: Значение
              example: 5
              format: int64
              type: integer
            valueId:
              description: Идентификатор значения
              example: 331245
              format: int64
              type: integer
          required:
          - valueId
          - value
          type: object
        drive:
          description: Привод
          nullable: true
          properties:
            value:
              description: Значение
              example: Передний
              type: string
            valueId:
              description: Идентификатор значения
              example: 331251
              format: int64
              type: integer
          required:
          - valueId
          - value
          type: object
        engine:
          description: Объем двигателя
          nullable: true
          properties:
            value:
              description: Значение
              example: 2.4
              format: float64
              type: number
            valueId:
              description: Идентификатор значения
              example: 331775
              format: int64
              type: integer
          required:
          - valueId
          - value
          type: object
        engineType:
          description: Тип двигателя
          nullable: true
          properties:
            value:
              description: Значение
              example: Бензин
              type: string
            valueId:
              description: Идентификатор значения
              example: 331247
              format: int64
              type: integer
          required:
          - valueId
          - value
          type: object
        generation:
          description: Поколение
          nullable: true
          properties:
            value:
              description: Значение
              example: T11 (2005—2013)
              type: string
            valueId:
              description: Идентификатор значения
              example: 332287
              format: int64
              type: integer
          required:
          - valueId
          - value
          type: object
        model:
          description: Модель
          nullable: true
          properties:
            value:
              description: Значение
              example: Tiggo (T11)
              type: string
            valueId:
              description: Идентификатор значения
              example: 330887
              format: int64
              type: integer
          required:
          - valueId
          - value
          type: object
        modification:
          description: Модификация
          nullable: true
          properties:
            value:
              description: Значение
              example: 2.4 MT (129 л.с.)
              type: string
            valueId:
              description: Идентификатор значения
              example: 408424
              format: int64
              type: integer
          required:
          - valueId
          - value
          type: object
        transmission:
          description: Тип КПП
          nullable: true
          properties:
            value:
              description: Значение
              example: Механика
              type: string
            valueId:
              description: Идентификатор значения
              example: 331254
              format: int64
              type: integer
          required:
          - valueId
          - value
          type: object
        wheel:
          description: Руль
          nullable: true
          properties:
            value:
              description: Значение
              example: Левый
              type: string
          required:
          - value
          type: object
        year:
          description: Год выпуска
          nullable: true
          properties:
            value:
              description: Значение
              example: 2007
              format: int64
              type: integer
            valueId:
              description: Идентификатор значения
              example: 331123
              format: int64
              type: integer
          required:
          - valueId
          - value
          type: object
      required:
      - brand
      - model
      - bodyType
      - doorsCount
      - drive
      - wheel
      - engineType
      - engine
      - capacity
      - transmission
      - generation
      - modification
      - complectation
      - year
      type: object
    SpecificationIdResultAutoteka:
      properties:
        specificationId:
          description: Идентификатор спецификации, по которому ее можно получить
          example: 1
          format: int64
          minimum: 1
          type: integer
      required:
      - specificationId
      type: object
    forbiddenError:
      properties:
        error:
          properties:
            code:
              description: Код ошибки
              example: 403
              format: int32
              type: integer
            message:
              description: Сообщение об ошибке
              example: Forbidden
              type: string
          required:
          - code
          - message
          type: object
      type: object
    SpecificationResultAutoteka:
      properties:
        equipment:
          $ref: '#/components/schemas/SpecificationEquipmentAutoteka'
        normalizedSpecification:
          $ref: '#/components/schemas/SpecificationNormalizedSpecificationAutoteka'
        plateNumber:
          description: Регистрационный номер
          example: X777XX777
          nullable: true
          type: string
        specificationId:
          description: Идентификатор спецификации
          example: 157987
          format: int64
          type: integer
        status:
          description: Статус `success`, `processing`, `notFound`
          example: success
          type: string
        vehicleId:
          description: Идентификатор запрашиваемого авто (vin/frame)
          example: XUUNF487JA0007223
          nullable: true
          type: string
      required:
      - equipment
      - normalizedSpecification
      - specificationId
      - plateNumber
      - status
      - vehicleId
      type: object
    internalError:
      properties:
        error:
          properties:
            code:
              description: Код ошибки
              example: 500
              format: int32
              type: integer
            message:
              description: Сообщение об ошибке
              example: Service is temporary unavailable
              type: string
          required:
          - code
          - message
          type: object
      type: object
    AvitoPriceValuation:
      description: Оценка подержаного автомобиля от Авито
      nullable: true
      properties:
        avgMarketPrice:
          description: Оценка на основе объявлений
          example: 950000
          nullable: true
          type: integer
        avgMileage:
          description: Средний пробег аналогов
          example: 50000
          nullable: true
          type: integer
        avgPriceWithCondition:
          description: Оценка с учетом состояния автомобилей на основе реальных сделок
          example: 936000
          type: integer
        avgYear:
          description: Средний год выпуска аналогов
          example: 2012.9999
          format: float
          nullable: true
          type: number
        imvUrl:
          deprecated: true
          description: Поле больше не заполняется. Ссылка на страницу Авито IMV вида https://www.avito.ru/au-imv-info/2963331288
          example: https://www.avito.ru/au-imv-info/2963331288
          nullable: true
          type: string
        itemsCount:
          description: Количество машин, учтенных в оценке
          example: 121
          nullable: true
          type: integer
        marketNormalPriceRange:
          description: Диапазон "рыночной" оценки данного автомобиля по закрытым сделкам
          nullable: true
          properties:
            max:
              description: Максимальная граница "рыночной" оценки данного автомобиля по закрытым сделкам
              example: 5248900
              type: integer
            min:
              description: Минимальная граница "рыночной" оценки данного автомобиля по закрытым сделкам
              example: 3248900
              type: integer
          required:
          - min
          - max
          type: object
        maxPrice:
          description: Максимальная цена похожих авто на основе объявлений
          example: 1000000
          nullable: true
          type: integer
        minPrice:
          description: Минимальная цена похожих авто на основе объявлений
          example: 800000
          nullable: true
          type: integer
      required:
      - avgPriceWithCondition
      type: object
    CreateSpecificationResponseDataAutoteka:
      properties:
        specification:
          $ref: '#/components/schemas/SpecificationIdResultAutoteka'
      type: object
    validatingError:
      properties:
        error:
          properties:
            code:
              description: Код ошибки
              example: 400
              format: int32
              type: integer
            message:
              description: Сообщение об ошибке
              example: Validation error
              type: string
          required:
          - code
          - message
          type: object
      type: object
    CreateSpecificationResponseBodyAutoteka:
      properties:
        result:
          $ref: '#/components/schemas/CreateSpecificationResponseDataAutoteka'
      type: object
    notFoundError:
      properties:
        error:
          properties:
            code:
              description: Код ошибки
              example: 404
              format: int32
              type: integer
            message:
              description: Сообщение об ошибке
              example: Not found
              type: string
          required:
          - code
          - message
          type: object
      type: object
    RequestValuationBySpecificationResolve:
      properties:
        location:
          nullable: true
          properties:
            lat:
              example: 55.755863189697266
              format: float64
              type: number
            long:
              example: 37.617698669433594
              format: float64
              type: number
          required:
          - lat
          - long
          type: object
        mileage:
          description: Пробег в км
          example: 15000
          format: int32
          nullable: true
          type: integer
        specification:
          properties:
            bodyType:
              description: Тип ТС
              nullable: true
              properties:
                label:
                  description: Значение параметра
                  example: Кроссовер
                  type: string
                valueId:
                  description: Идентификатор значения параметра
                  example: 13815
                  format: int64
                  minimum: 1
                  type: integer
              required:
              - label
              - valueId
              type: object
            brand:
              description: Марка
              properties:
                label:
                  description: Значение параметра
                  example: BMW
                  type: string
                valueId:
                  description: Идентификатор значения параметра
                  example: 13815
   

# --- truncated at 32 KB (57 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/avito/refs/heads/main/openapi/avito-evaluation-api-openapi.yml