openapi: 3.0.0
info:
  title: MPSTATS ANALYTICS API - Ozon
  version: 1.0.0
servers:
  - url: https://mpstats.io/api/analytics/v1/oz
    description: MPSTATS - Analytics
tags:
  - name: items
    x-displayName: Товары
  - name: niche
    x-displayName: Ниша
  - name: category
    x-displayName: Категория
  - name: seller
    x-displayName: Продавец
  - name: brand
    x-displayName: Бренд
  - name: identical
    x-displayName: Похожие товары
  - name: groups
    x-displayName: Группы
  - name: keywords
    x-displayName: Поисковые запросы
paths:
  /items:
    post:
      summary: Получение списка товаров по SKU / брендам / продавцу / ключевому слову
      description: >
        Обязательно передавать хотя бы один из указанных параметров. 
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - items
      parameters:
        - name: ids
          in: query
          description: Список SKU
          required: false
          example: 35995104, 153525562, 142257239
          schema:
            type: string
        - name: brands
          in: query
          description: Список брендов (названия)
          required: false
          example:
            - adidas
            - nike
          schema:
            type: array
            items:
              type: string
        - name: sellers
          in: query
          description: Список продавцов (названия)
          required: false
          example:
            - Адидасовый МИР
            - Raise
          schema:
            type: array
            items:
              type: string
        - name: keyword
          in: query
          description: Ключевое слово
          required: false
          example: кроссовки
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала периода поиска (по умолчанию, год назад)
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца периода поиска (по умолчанию, вчера)
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список товаров
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/item'
              example:
                startRow: 0
                endRow: 10
                total: 5109
                data:
                  - id: 1569294852
                    name: Кроссовки adidas Original
                    brand:
                      id: 144082850
                      name: adidas
                    seller:
                      id: 1875517
                      name: Адидасовый МИР
                    thumb: https://cdn1.ozone.ru/s3/multimedia-1-d/7047589873.jpg
                  - id: 162314532
                    name: Кимоно adidas
                    brand:
                      id: 144082850
                      name: adidas
                    seller:
                      id: 8476
                      name: Combatmarkt
                    thumb: https://cdn1.ozone.ru/s3/multimedia-m/6315894946.jpg
                  - id: 1566243863
                    name: Кроссовки adidas
                    brand:
                      id: 144082850
                      name: adidas
                    seller:
                      id: 1982496
                      name: Raise
                    thumb: https://cdn1.ozone.ru/s3/multimedia-1-u/7020056082.jpg
  /items/{id}/full:
    get:
      summary: Получение подробной информации по товару
      tags:
        - items
      parameters:
        - name: id
          in: path
          description: ID товара
          required: true
          example: 1786874757
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Включить в отчёт данные по FBS-товарам
          required: false
          example: false
          schema:
            type: boolean
      responses:
        '200':
          description: Информация по товару
          content:
            application/json:
              example:
                id: 1786874757
                name: Футболка Import Store Premium
                link: https://ozon.ru/context/detail/id/1786874757
                niche:
                  id: 7508
                  name: >-
                    Одежда/Женская одежда/Футболки и топы женские/Футболки и
                    поло женские
                brand: Import Store
                seller:
                  id: 2496702
                  name: Import Store
                  is_best_seller: 0
                price:
                  price: 100000
                  final_price: 76501
                  ozon_card_price: 73763
                discount: 23
                balance: 54
                delivery_scheme: FBO
                rating: 4.9
                comments: 3134
                period_stats:
                  revenue: 2883091
                  revenue_avg: 93002.94
                  sales: 41
                  sales_avg: 1
                  revenue_avg_with_stock: 93003
                  sales_avg_with_stock: 1
                  revenue_potential: 2790088.06
                  lost_profit: -93002.94
                  lost_profit_percent: -3.33
                  revenue_prev: 33329
                  sales_prev: 73
                  sku_first_date: '1970-01-01'
                photo:
                  count: 4
                  list:
                    - f: https://ir.ozone.ru/s3/multimedia-1-i/7222597686.jpg
                      t: >-
                        https://ir.ozone.ru/s3/multimedia-1-i/d100/7222597686.jpg
                      m: >-
                        https://ir.ozone.ru/s3/multimedia-1-i/d250/7222597686.jpg
                sku_first_date: '2025-02-12'
                note: null
                updated: '2026-03-05 20:04:14'
  /items/{id}/categories:
    get:
      summary: Позиции товара в категориях
      tags:
        - items
      parameters:
        - name: id
          in: path
          description: ID товара
          required: true
          example: 1786874757
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
      responses:
        '200':
          description: Позиции товара по категориям
          content:
            application/json:
              example:
                - name: >-
                    Одежда/Женская одежда/Футболки и топы женские/Футболки и
                    поло женские
                  positions:
                    - 595
                    - 641
                    - 713
                    - null
                    - 14
                - name: Одежда/Мужская одежда
                  positions:
                    - 1598
                    - 911
                    - 1000
                    - 880
                    - 334
  /items/{id}/keywords:
    get:
      summary: Запросы и позиции по ключевым словам товара
      tags:
        - items
      parameters:
        - name: id
          in: path
          description: ID товара
          required: true
          example: 1786874757
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
      responses:
        '200':
          description: Позиции товара по ключевым словам
          content:
            application/json:
              example:
                - query: футболки с длинным рукавом женские
                  count: 128
                  total: 0
                  avg_position: 1
                  positions:
                    - 1
                    - 2
                    - 3
                - query: футболка мужская принт
                  count: 118
                  total: 0
                  avg_position: 1
                  positions:
                    - null
                    - null
                    - 1
                - query: футболка модная
                  count: 104
                  total: 0
                  avg_position: 1
                  positions:
                    - null
                    - 2
                    - null
  /items/{id}/by_period:
    get:
      summary: Статистика товара за период
      tags:
        - items
      parameters:
        - name: id
          in: path
          description: ID товара
          required: true
          example: 1786874757
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Включить в отчёт данные по FBS-товарам
          required: false
          example: false
          schema:
            type: boolean
        - name: withSearchStats
          in: query
          description: Включить в отчёт данные позициям, видимости, трафику
          required: false
          example: false
          schema:
            type: boolean
      responses:
        '200':
          description: Данные по дням
          content:
            application/json:
              example:
                - no_data: 0
                  data: '2026-03-05'
                  balance: 54
                  sales: 0
                  rating: 4.9
                  price: 100000
                  final_price: 76501
                  ozon_card_price: 73763
                  is_bestseller: 0
                  is_new: 0
                  comments: 3134
                  discount: 23
                - no_data: 0
                  data: '2026-03-04'
                  balance: 54
                  sales: 2
                  rating: 4.9
                  price: 100000
                  final_price: 76718
                  ozon_card_price: 73767
                  is_bestseller: 0
                  is_new: 0
                  comments: 3132
                  discount: 23
  /items/{id}/by_day:
    get:
      summary: Статистика товара за день
      tags:
        - items
      parameters:
        - name: id
          in: path
          description: ID товара
          required: true
          example: 1786874757
          schema:
            type: integer
        - name: date
          in: query
          description: Дата отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
      responses:
        '200':
          description: Данные за день
          content:
            application/json:
              example:
                - tm: '00:02'
                  comments: 3096
                  rating: 490
                  balance: 64
                  balancefbs: 0
                  sales: 0
                  salesfbs: 0
                  price: 100000
                  final_price: 75078
                  ozon_card_price: 72049
                - tm: '01:00'
                  comments: 3096
                  rating: 490
                  balance: 64
                  balancefbs: 0
                  sales: 0
                  salesfbs: 0
                  price: 100000
                  final_price: 75078
                  ozon_card_price: 72049
                - tm: '02:00'
                  comments: 3096
                  rating: 490
                  balance: 64
                  balancefbs: 0
                  sales: 0
                  salesfbs: 0
                  price: 100000
                  final_price: 75078
                  ozon_card_price: 72049
                - tm: '03:03'
                  comments: 3096
                  rating: 490
                  balance: 64
                  balancefbs: 0
                  sales: 0
                  salesfbs: 0
                  price: 100000
                  final_price: 75078
                  ozon_card_price: 72049
  /items/{id}/search_stats:
    get:
      summary: Статистика позиций, видимости и трафика товара за период
      tags:
        - items
      parameters:
        - name: id
          in: path
          description: ID товара
          required: true
          example: 1786874757
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
      responses:
        '200':
          description: Данные за период в сравнении с предыдущим
          content:
            application/json:
              example:
                search_visibility: 1325
                search_visibility_previous: 1502
                search_words_count: 1376
                search_words_count_previous: 1556
                search_position_avg: 43
                search_position_avg_previous: 45
                oz_count: 205700
                oz_count_previous: 93758
  /items/{id}/sales:
    get:
      summary: Статистика продаж товара за период по складам
      tags:
        - items
      parameters:
        - name: id
          in: path
          description: ID товара
          required: true
          example: 1786874757
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Включить в отчёт данные по FBS-товарам
          required: false
          example: false
          schema:
            type: boolean
      responses:
        '200':
          description: Данные по продажам по складам
          content:
            application/json:
              example:
                - store_id: '1020001853819000'
                  store_name: ПЕРМЬ_РФЦ
                  sales: 662
                - store_id: '1020001649180000'
                  store_name: СПБ_КОЛПИНО_РФЦ
                  sales: 2
  /items/{id}/balance:
    get:
      summary: Наличие товара по складам
      tags:
        - items
      parameters:
        - name: id
          in: path
          description: ID товара
          required: true
          example: 1786874757
          schema:
            type: integer
        - name: date
          in: query
          description: Дата отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: fbs
          in: query
          description: Включить в отчёт данные по FBS-товарам
          required: false
          example: false
          schema:
            type: boolean
      responses:
        '200':
          description: Данные по наличию товара по складам
          content:
            application/json:
              example:
                - store_id: '1020001853819000'
                  store_name: ПЕРМЬ_РФЦ
                  balance: 175
                - store_id: '1020001351243000'
                  store_name: НЕВИННОМЫССК_РФЦ
                  balance: 150
  /items/{id}/stores:
    get:
      summary: Данные по продажам и остаткам товара за период по складам
      tags:
        - items
      parameters:
        - name: id
          in: path
          description: ID товара
          required: true
          example: 1786874757
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Включить в отчёт данные по FBS-товарам
          required: false
          example: false
          schema:
            type: boolean
      responses:
        '200':
          description: Данные по продажам и остаткам по дням по складам
          content:
            application/json:
              example:
                - store_id: '1020000241710000'
                  store_name: СОФЬИНО_РФЦ
                  stats:
                    - date: '2026-02-01'
                      sales: 1
                      balance: 1
                    - date: '2026-02-02'
                      sales: 2
                      balance: 2
                - store_id: '1020000267736000'
                  store_name: АДЫГЕЙСК_РФЦ
                  stats:
                    - date: '2026-02-01'
                      sales: 100
                      balance: 50
                    - date: '2026-02-02'
                      sales: 10
                      balance: 40
  /items/{id}/comments:
    get:
      summary: Получение комментариев (оценок) по товару
      tags:
        - items
      parameters:
        - name: id
          in: path
          description: ID товара
          required: true
          example: 86972
          schema:
            type: integer
      responses:
        '200':
          description: Комментарии (оценки) по товару
          content:
            application/json:
              example:
                - date: '2025-11-29'
                  valuation: 5
                  likes: 0
                  text: ''
                - date: '2025-11-25'
                  valuation: 5
                  likes: 0
                  text: ''
                - date: '2025-10-31'
                  valuation: 5
                  likes: 0
                  text: Хороший журнальчик. Интерес у ребёнка вызывает
  /items/{id}/comments/ai_recommendations:
    get:
      summary: AI рекомендации по отзывам на товар
      tags:
        - items
      parameters:
        - name: id
          in: path
          description: ID товара
          required: true
          example: 86972
          schema:
            type: integer
      responses:
        '200':
          description: AI рекомендации
          content:
            application/json:
              example:
                id: 19b36ac20ac2970db60f113c23c27a76
                status: 10
                data:
                  pain_points:
                    - topic: Просвечивание ткани
                      description: >-
                        Покупатели жалуются, что материал топа слишком тонкий и
                        сильно просвечивает, что делает изделие непригодным для
                        ношения без подкладки.
                      solution: >-
                        Использовать более плотную или многослойную ткань,
                        протестировать материал на просвечивание при разных
                        условиях освещения.
                    - topic: Несоответствие цены качеству
                      description: >-
                        Клиенты отмечают, что качество изделия не оправдывает
                        его стоимости, что снижает доверие к бренду.
                      solution: >-
                        Провести анализ себестоимости и уровня восприятия цены,
                        возможно, скорректировать цену или повысить качество
                        материалов и пошива.
                    - topic: Разочарование ожиданий
                      description: >-
                        Отзыв с низкой оценкой указывает, что товар не
                        соответствует ожиданиям пользователя по изображению или
                        описанию.
                      solution: >-
                        Пересмотреть описание и фотографии товара, добавить
                        реальные фото на модели при разном освещении и в разных
                        позах.
                  advantages:
                    - topic: Современный дизайн
                      description: >-
                        Из отзыва следует, что изделие привлекательно визуально
                        (есть интерес к покупке топа несмотря на недостатки).
                      solution: >-
                        Сохранить стиль, но усилить функциональность за счёт
                        выбора качественных материалов.
                    - topic: Лёгкость материала
                      description: >-
                        Ткань, вероятно, тонкая и приятная на ощупь, что оценят
                        в жаркое время года.
                      solution: >-
                        Оставить лёгкость как характеристику, но добавить
                        плотную подкладку или продумать двойной слой в зонах,
                        где просвечивание критично.
                    - topic: Минималистичный стиль
                      description: >-
                        Топ, судя по отзыву, имеет простой дизайн, что
                        соответствует модным трендам.
                      solution: >-
                        Подчеркнуть минимализм в маркетинговых материалах, делая
                        акцент на универсальности и сочетании с другими вещами.
  /items/{id}/versions:
    get:
      summary: Данные по версиям товара
      tags:
        - items
      parameters:
        - name: id
          in: path
          description: ID товара
          required: true
          example: 1786874757
          schema:
            type: integer
      responses:
        '200':
          description: Данные по версиям товара
          content:
            application/json:
              example:
                - version: 73ae4b2b063d597cf4ec33a79c010cf7
                  date: '2026-02-11 21:10:29'
                - version: 35a7696cf2a4488ae016c98668b0cf64
                  date: '2026-02-04 14:59:59'
  /items/{id}/versions/{hash}:
    get:
      summary: Параметры версии товара
      tags:
        - items
      parameters:
        - name: id
          in: path
          description: ID товара
          required: true
          example: 1786874757
          schema:
            type: integer
        - name: hash
          in: path
          description: Хеш версии
          required: true
          example: cd386e568a138467cb7e618160d7a3d2
          schema:
            type: string
      responses:
        '200':
          description: Параметры версии товара
          content:
            application/json:
              example:
                date: '2025-08-21 02:59:13'
                name: Футболка Import Store Premium
                description: >-
                  Мужская футболка из хлопка пенье | 100% хлопок | Брендовая
                  базовая футболка | Плотность 200 г/м²

                  Качественная базовая футболка для мужчин, которые ценят
                  комфорт и стиль

                  Выполнена из премиального хлопка пенье — мягкий, дышащий и
                  прочный материал с плотностью 200 г/м²

                  Футболка держит форму, не просвечивает, не теряет цвет после
                  стирки

                  Классический прямой крой подходит для любого типа фигуры и
                  легко сочетается с повседневной и спортивной одеждой

                  Подходит как для самостоятельной носки, так и для нанесения
                  принтов или логотипов


                  Особенности модели: материал — хлопок пенье, состав — 100%
                  хлопок, плотность — 200 г/м², прямой крой, круглый вырез,
                  прочные швы, дышащая ткань, брендовая фурнитура, универсальный
                  стиль
                param_names:
                  - Тип
                  - Бренд в одежде и обуви
                  - '#Хештеги'
                  - Аннотация
                  - Цвет товара
                  - Название цвета
                  - Российский размер
                  - Размер производителя
                  - Размер на модели
                  - Пол
                  - Рост модели на фото
                  - Коллекция
                  - Страна-изготовитель
                  - Материал
                  - Состав материала
                  - Материал подкладки
                  - Стиль
                  - Сезон
                  - Рисунок
                  - Особенности модели
                  - Покрой
                  - Тип ростовки
                  - Тип рукава
                  - Рост
                  - Тип упаковки одежды
                  - Количество в упаковке
                  - Уход за вещами
                  - Признак 18+
                  - Вид выпуска товара
                  - Название группы
                param_values:
                  - Футболка
                  - Import Store
                  - >-
                    #ФутболкаМужскаяОверсайз #ФутболкаЖенскаяОверсайз #Лонгслив
                    #ЛонгсливЖенский #ЛонгсливМужской #ЛонгсливУнисекс
                    #ЛонгсливБазовый #ЛонгсливЖенскийОверсайз
                    #ЛонгсливМужскойОверсайз #ЛонгсливОверсайз #Оверсайз
                    #ОверсайзОдежда #МоднаяОдежда #БазовыйГардероб
                  - >-
                    Мужская футболка из хлопка пенье | 100% хлопок | Брендовая
                    базовая футболка | Плотность 200 г/м²

                    Качественная базовая футболка для мужчин, которые ценят
                    комфорт и стиль

                    Выполнена из премиального хлопка пенье — мягкий, дышащий и
                    прочный материал с плотностью 200 г/м²

                    Футболка держит форму, не просвечивает, не теряет цвет после
                    стирки

                    Классический прямой крой подходит для любого типа фигуры и
                    легко сочетается с повседневной и спортивной одеждой

                    Подходит как для самостоятельной носки, так и для нанесения
                    принтов или логотипов


                    Особенности модели: материал — хлопок пенье, состав — 100%
                    хлопок, плотность — 200 г/м², прямой крой, круглый вырез,
                    прочные швы, дышащая ткань, брендовая фурнитура,
                    универсальный стиль
                  - черный
                  - черный TH-3-1-22
                  - 44,46
                  - XS-S
                  - '50'
                  - Мужской,Женский
                  - 184 см
                  - Базовая коллекция
                  - Узбекистан
                  - Пенье,Хлопок
                  - Хлопок 100%
                  - Без подклада
                  - Повседневный
                  - На любой сезон
                  - Надписи
                  - >-
                    family
                    look,быстросохнущая,вентиляция,ветрозащита,воздухопроницаемость,гипоаллергенный
                    материал
                  - прямой
                  - для высоких
                  - Длинный
                  - '184'
                  - Пакет
                  - '1'
                  - >-
                    Деликатная стирка с изнанки при t до 30 градусов.
                    Отбеливание и ручная стирка запрещены
                  - 'false'
                  - Фабричное производство
                  - Premium
  /items/{id}/versions/compare:
    get:
      summary: Параметры версии товара
      tags:
        - items
      parameters:
        - name: id
          in: path
          description: ID товара
          required: true
          example: 1786874757
          schema:
            type: integer
        - name: v1
          in: query
          description: Хеш версии 1
          required: true
          example: cd386e568a138467cb7e618160d7a3d2
          schema:
            type: string
        - name: v2
          in: query
          description: Хеш версии 2
          required: true
          example: 95e417f4c54e5a297f073b0e19281bc0
          schema:
            type: string
        - name: type
          in: query
          description: Тип сравнения (Inline / SideBySide)
          required: false
          example: Inline
          schema:
            type: string
      responses:
        '200':
          description: Параметры версии товара
          content:
            application/json:
              example:
                name: ''
                description: >-
                  <table class="diff-wrapper diff diff-html
                  diff-inline"><thead><tr><th>01.01.1970</th><th>01.01.1970</th><th></th><th>Различия</th></tr></thead><tbody
                  class="change change-rep"><tr data-type="-"><th
                  class="n-old">1</th><th></th><th class="sign del">–</th><td
                  class="old">Мужская футболка из хлопка пенье | 100% хлопок |
                  Брендовая базовая футболка | Плотность 200 г/м²</td></tr><tr
                  data-type="-"><th class="n-old">2</th><th></th><th class="sign
                  del">–</th><td class="old">Качественная базовая футболка для
                  мужчин, которые ценят комфорт и стиль</td></tr><tr
                  data-type="-"><th class="n-old">3</th><th></th><th class="sign
                  del">–</th><td class="old">Выполнена из премиального хлопка
                  пенье — мягкий, дышащий и прочный материал с плотностью 200
                  г/м²</td></tr><tr data-type="-"><th
                  class="n-old">4</th><th></th><th class="sign del">–</th><td
                  class="old">Футболка держит форму, не просвечивает, не теряет
                  цвет после стирки</td></tr><tr data-type="-"><th
                  class="n-old">5</th><th></th><th class="sign del">–</th><td
                  class="old">Классический прямой крой подходит для любого типа
                  фигуры и легко сочетается с повседневной и спортивной
                  одеждой</td></tr><tr data-type="-"><th
                  class="n-old">6</th><th></th><th class="sign del">–</th><td
                  class="old">Подходит как для самостоятельной носки, так и для
                  нанесения принтов или логотипов</td></tr><tr data-type="-"><th
                  class="n-old">7</th><th></th><th class="sign del">–</th><td
                  class="old"></td></tr><tr data-type="-"><th
                  class="n-old">8</th><th></th><th class="sign del">–</th><td
                  class="old">Особенности модели: материал — хлопок пенье,
                  состав — 100% хлопок, плотность — 200 г/м², прямой крой,
                  круглый вырез, прочные швы, дышащая ткань, брендовая
                  фурнитура, универсальный стиль</td></tr><tr
                  data-type="+"><th></th><th class="n-new">1</th><th class="sign
                  ins">+</th><td class="new">Мужская футболка: стиль и комфорт
                  для повседневного образа и активного отдыха Ищете стильный и
                  универсальный вариант? Удлиненная мужская футболка идеально
                  подходит для повседневного ношения, тренировок и отдыха,
                  становясь базой в гардеробе. Свободный крой преимущество этой
                  футболки. Данная модель представлена как в однотонном
                  исполнении футболка. Это позволяет подобрать стиль,
                  соответствующий вашему образу. Унисекс фасон и современный
                  крой подойдут мужчинам любого телосложения — худым, полным,
                  атлетичным, для высоких и невысоких людей. Вещи зачастую
                  воспринимаются не только как стильный кэжуал, но и унисекс. Их
                  приобретают как парные: Футболка свободного кроя не сковывает
                  движений, подходит для спорта, прогулок, йоги и повседневного
                  ношения, создавая комфорт и стиль. Универсальная мужская
                  футболка гармонично подойдет в любой повседневный образ.
                  Премиум-ткань изготовлена из плотного хлопка (180 г),
                  приятного на коже, обеспечивающего воздухообмен и прочность.
                  Футболка из хлопка сохраняет форму и цвет даже после
                  многократных стирок, что особенно актуально для частого
                  использования. ВАЖНО: рекомендуем выбирать свой стандартный
                  размер. Подробная таблица размеров находится в галерее товара.
                  Эта удобная футболка подходит для бега, занятий спортом и
                  отдыха, а также сочетается с любой одеждой. Футболка станет
                  отличной базой для создания модного, лаконичного образа,
                  строгости и стиля. Материал - Натуральный 100% премиум-хлопок
                  — мягкий, дышащий и долговечный. Футболка отлично сочетается
                  со стилем винтаж. Эта мужская футболка, будь то однотонная или
                  с принтом, станет отличным выбором для подарка на день
                  рождения,девочке,мальчику, сыну,мужу, брату, коллеге, папе
                  подарки на Новый год 2025 или 23 февраля. Она подходит для
                  всех сезонов — лето, осень, зима и
                  весна.</td></tr></tbody></table>
                specifications: >-
                  <table class="diff-wrapper diff diff-html
                  diff-inline"><thead><tr><th>01.01.1970</th><th>01.01.1970</th><th></th><th>Различия</th></tr></thead><tbody
                  class="change change-rep"><tr data-type="-"><th
                  class="n-old">1</th><th></th><th class="sign del">–</th><td
                  class="old">#Хештеги: #ФутболкаМужскаяОверсайз
                  #ФутболкаЖенскаяОверсайз #Лонгслив #ЛонгсливЖенский
                  #ЛонгсливМужской #ЛонгсливУнисекс #ЛонгсливБазовый
                  #ЛонгсливЖенскийОверсайз #ЛонгсливМужскойОверсайз
                  #ЛонгсливОверсайз #Оверсайз #ОверсайзОдежда #МоднаяОдежда
                  #БазовыйГардероб</td></tr><tr data-type="-"><th
                  class="n-old">2</th><th></th><th class="sign del">–</th><td
                  class="old">Аннотация: Мужская футболка из хлопка пенье | 100%
                  хлопок | Брендовая базовая футболка | Плотность 200 г/м²

                  Качественная базовая футболка для мужчин, которые ценят
                  комфорт и стиль

                  Выполнена из премиального хлопка пенье — мягкий, дышащий и
                  прочный материал с плотностью 200 г/м²

                  Футболка держит форму, не просвечивает, не теряет цвет после
                  стирки

                  Классический прямой крой подходит для любого типа фигуры и
                  легко сочетается с повседневной и спортивной одеждой

                  Подходит как для самостоятельной носки, так и для нанесения
                  принтов или логотипов


                  Особенности модели: материал — хлопок пенье, состав — 100%
                  хлопок, плотность — 200 г/м², прямой крой, круглый вырез,
                  прочные швы, дышащая ткань, брендовая фурнитура, универсальный
                  стиль</td></tr><tr data-type="+"><th></th><th
                  class="n-new">1</th><th class="sign ins">+</th><td
                  class="new">Аннотация: Мужская футболка: стиль и комфорт для
                  повседневного образа и активного отдыха Ищете стильный и
                  универсальный вариант? Удлиненная мужская футболка идеально
                  подходит для повседневного ношения, тренировок и отдыха,
                  становясь базой в гардеробе. Свободный крой преимущество этой
                  футболки. Данная модель представлена как в однотонном
                  исполнении футболка. Это позволяет подобрать стиль,
                  соответствующий вашему образу. Унисекс фасон и современный
                  крой подойдут мужчинам любого телосложения — худым, полным,
                  атлетичным, для высоких и невысоких людей. Вещи зачастую
                  воспринимаются не только как стильный кэжуал, но и унисекс. Их
                  приобретают как парные: Футболка свободного кроя не сковывает
                  движений, подходит для спорта, прогулок, йоги и повседневного
                  ношения, создавая комфорт и стиль. Универсальная мужская
                  футболка гармонично подойдет в любой повседневный образ.
                  Премиум-ткань изготовлена из плотного хлопка (180 г),
                  приятного на коже, обеспечивающего воздухообмен и прочность.
                  Футболка из хлопка сохраняет форму и цвет даже после
                  многократных стирок, что особенно актуально для частого
                  использования. ВАЖНО: рекомендуем выбирать свой стандартный
                  размер. Подробная таблица размеров находится в галерее товара.
                  Эта удобная футболка подходит для бега, занятий спортом и
                  отдыха, а также сочетается с любой одеждой. Футболка станет
                  отличной базой для создания модного, лаконичного образа,
                  строгости и стиля. Материал - Натуральный 100% премиум-хлопок
                  — мягкий, дышащий и долговечный. Футболка отлично сочетается
                  со стилем винтаж. Эта мужская футболка, будь то однотонная или
                  с принтом, станет отличным выбором для подарка на день
                  рождения,девочке,мальчику, сыну,мужу, брату, коллеге, папе
                  подарки на Новый год 2025 или 23 февраля. Она подходит для
                  всех сезонов — лето, осень, зима и
                  весна.</td></tr></tbody><tbody class="change change-eq"><tr
                  data-type=" "><th class="n-old">3</th><th
                  class="n-new">2</th><th class="sign eq"> </th><td
                  class="new">Бренд в одежде и обуви: Import Store</td></tr><tr
                  data-type=" "><th class="n-old">4</th><th
                  class="n-new">3</th><th class="sign eq"> </th><td
                  class="new">Вид выпуска товара: Фабричное
                  производство</td></tr><tr data-type=" "><th
                  class="n-old">5</th><th class="n-new">4</th><th class="sign
                  eq"> </th><td class="new">Количество в упаковке:
                  1</td></tr><tr data-type=" "><th class="n-old">6</th><th
                  class="n-new">5</th><th class="sign eq"> </th><td
                  class="new">Коллекция: Базовая коллекция</td></tr><tr
                  data-type=" "><th class="n-old">7</th><th
                  class="n-new">6</th><th class="sign eq"> </th><td
                  class="new">Материал: Пенье,Хлопок</td></tr><tr data-type="
                  "><th class="n-old">8</th><th class="n-new">7</th><th
                  class="sign eq"> </th><td class="new">Материал подкладки: Без
                  подклада</td></tr></tbody><tbody class="change change-rep"><tr
                  data-type="-"><th class="n-old">9</th><th></th><th class="sign
                  del">–</th><td class="old">Название <del>группы</del>:
                  Premium</td></tr><tr data-type="-"><th
                  class="n-old">10</th><th></th><th class="sign del">–</th><td
                  class="old">Название цвета: черный
                  TH<del>-3-1-22</del></td></tr><tr data-type="+"><th></th><th
                  class="n-new">8</th><th class="sign ins">+</th><td
                  class="new">Название <ins>серии</ins>: Premium</td></tr><tr
                  data-type="+"><th></th><th class="n-new">9</th><th class="sign
                  ins">+</th><td class="new">Название цвета: черный TH<ins>
                  3-1</ins></td></tr></tbody><tbody class="change change-eq"><tr
                  data-type=" "><th class="n-old">11</th><th
                  class="n-new">10</th><th class="sign eq"> </th><td
                  class="new">Особенности модели: family
                  look,быстросохнущая,вентиляция,ветрозащита,воздухопроницаемость,гипоаллергенный
                  материал</td></tr><tr data-type=" "><th
                  class="n-old">12</th><th class="n-new">11</th><th class="sign
                  eq"> </th><td class="new">Покрой: прямой</td></tr><tr
                  data-type=" "><th class="n-old">13</th><th
                  class="n-new">12</th><th class="sign eq"> </th><td
                  class="new">Пол: Мужской,Женский</td></tr></tbody><tbody
                  class="skipped"><tr><td colspan="4"></td></tr></tbody><tbody
                  class="change change-eq"><tr data-type=" "><th
                  class="n-old">21</th><th class="n-new">20</th><th class="sign
                  eq"> </th><td class="new">Сезон: На любой сезон</td></tr><tr
                  data-type=" "><th class="n-old">22</th><th
                  class="n-new">21</th><th class="sign eq"> </th><td
                  class="new">Состав материала: Хлопок 100%</td></tr><tr
                  data-type=" "><th class="n-old">23</th><th
                  class="n-new">22</th><th class="sign eq"> </th><td
                  class="new">Стиль: Повседневный</td></tr></tbody><tbody
                  class="change change-del"><tr data-type="-"><th
                  class="n-old">24</th><th></th><th class="sign del">–</th><td
                  class="old">Страна-изготовитель:
                  Узбекистан</td></tr></tbody><tbody class="change
                  change-eq"><tr data-type=" "><th class="n-old">25</th><th
                  class="n-new">23</th><th class="sign eq"> </th><td
                  class="new">Тип: Футболка</td></tr><tr data-type=" "><th
                  class="n-old">26</th><th class="n-new">24</th><th class="sign
                  eq"> </th><td class="new">Тип ростовки: для
                  высоких</td></tr><tr data-type=" "><th
                  class="n-old">27</th><th class="n-new">25</th><th class="sign
                  eq"> </th><td class="new">Тип рукава: Длинный</td></tr><tr
                  data-type=" "><th class="n-old">28</th><th
                  class="n-new">26</th><th class="sign eq"> </th><td
                  class="new">Тип упаковки одежды: Пакет</td></tr></tbody><tbody
                  class="change change-rep"><tr data-type="-"><th
                  class="n-old">29</th><th></th><th class="sign del">–</th><td
                  class="old">Уход за вещами: Деликатная стирка <del>с изнанки
                  </del>при t до 30 градусов. Отбеливание и ручная стирка
                  запрещены</td></tr><tr data-type="+"><th></th><th
                  class="n-new">27</th><th class="sign ins">+</th><td
                  class="new">Уход за вещами: Деликатная стирка при t до 30
                  градусов. Отбеливание и ручная стирка
                  запрещены</td></tr></tbody><tbody class="change change-eq"><tr
                  data-type=" "><th class="n-old">30</th><th
                  class="n-new">28</th><th class="sign eq"> </th><td
                  class="new">Цвет товара: черный</td></tr></tbody></table>
  /niche/list:
    post:
      summary: Список ниш (выбор ниши)
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - niche
      parameters:
        - name: type
          in: query
          description: Необходимы тип данных (csv, xls, json по умолчанию)
          required: false
          example: json
          schema:
            type: string
        - name: date
          in: query
          description: Дата
          required: false
          example: '2025-02-01'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: onlyFavorite
          in: query
          description: Только избранные
          required: false
          example: 1
          schema:
            type: boolean
        - name: search
          in: query
          description: Поисковый запрос
          required: false
          example: Телевизоры
          schema:
            type: string
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список ниш
          content:
            application/json:
              example:
                startRow: 0
                endRow: 100
                total: 4821
                data:
                  - days: 30
                    category_id: 14712
                    category: Дом и сад/Дача и сад/Садовая техника/Садовые измельчители
                    first_date: '2020-01-04'
                    items: 2689
                    items_new: 280
                    items_with_count: 105
                    items_with_count_percent: 3.9
                    items_with_sells: 70
                    items_with_sells_percent: 2.6
                    items_with_sells_percent_count: 66.67
                    sales: 1894
                    revenue: 27332331
                    revenue_potential: 36086794
                    lost_profit: 8754463
                    lost_profit_percent: 24.26
                    count_sum: 2439
                    brands: 116
                    brands_with_sells: 25
                    brands_with_sells_percent: 21.55
                    sellers: 882
                    sellers_with_sells: 45
                    sellers_with_sells_percent: 5.1
                    min_price_final: 550
                    min_price_final_with_sells: 8998
                    max_price_final: 18941368
                    max_price_final_with_sells: 53000
                    avg_price_final: 43251.61
                    avg_price_final_with_sells: 18315.76
                    median_price_final: 20778
                    median_price_final_with_sells: 14432
                    avg_rating: 4.72
                    avg_rating_with_sells: 4.43
                    turnover: 0.78
                    turnover_in_days: 38.63
                    frozen_stocks: 1176
                    frozen_stocks_cost: 18772012
                    frozen_stocks_percent: 48.22
                    seasonality_level: 2
                    favorite: true
                  - days: 30
                    category_id: 15556
                    category: Электроника/Наушники и аудиотехника/Микрофоны
                    first_date: '2020-01-04'
                    items: 105378
                    items_new: 17383
                    items_with_count: 2440
                    items_with_count_percent: 2.32
                    items_with_sells: 1796
                    items_with_sells_percent: 1.7
                    items_with_sells_percent_count: 73.61
                    sales: 69403
                    revenue: 156563697
                    revenue_potential: 185362519
                    lost_profit: 28798822
                    lost_profit_percent: 15.54
                    count_sum: 96616
                    brands: 1456
                    brands_with_sells: 384
                    brands_with_sells_percent: 26.37
                    sellers: 7553
                    sellers_with_sells: 675
                    sellers_with_sells_percent: 8.94
                    min_price_final: 0
                    min_price_final_with_sells: 17
                    max_price_final: 2868366
                    max_price_final_with_sells: 145417
                    avg_price_final: 9420.67
                    avg_price_final_with_sells: 3422.62
                    median_price_final: 2471
                    median_price_final_with_sells: 1655.5
                    avg_rating: 4.65
                    avg_rating_with_sells: 4.35
                    turnover: 0.72
                    turnover_in_days: 41.76
                    frozen_stocks: 41927
                    frozen_stocks_cost: 113182602
                    frozen_stocks_percent: 43.4
                    seasonality_level: 2
                    favorite: false
  /niche/{id}:
    get:
      summary: Информация о нише
      tags:
        - niche
      parameters:
        - name: id
          in: path
          description: ID ниши
          required: true
          example: 14712
          schema:
            type: integer
      responses:
        '200':
          description: Ниша
          content:
            application/json:
              example:
                id: 14712
                name: Дом и сад/Дача и сад/Садовая техника/Садовые измельчители
                wb_subjects:
                  - subject_id: 2222
                    subject_group: Садовая техника
                    subject_name: Дом и сад/Дача и сад/Садовая техника/Садовые измельчители
                  - subject_id: 3135
                    subject_group: Садовые инструменты и полив
                    subject_name: Дом и сад/Дача и сад/Садовая техника/Садовые измельчители
                  - subject_id: 7126
                    subject_group: Садовая техника
                    subject_name: Дом и сад/Дача и сад/Садовая техника/Садовые измельчители
                  - subject_id: 7128
                    subject_group: Садовая техника
                    subject_name: Дом и сад/Дача и сад/Садовая техника/Садовые измельчители
  /niche/{id}/competitors:
    get:
      summary: Быстрорастущие бренды / продавцы / товары ниши
      tags:
        - niche
      parameters:
        - name: id
          in: path
          description: ID ниши
          required: true
          example: 14712
          schema:
            type: integer
        - name: period
          in: query
          description: Период в днях (14 / 30 / 60)
          required: true
          example: 30
          schema:
            type: integer
        - name: target
          in: query
          description: Тип отчёта (brands / sellers / items)
          required: true
          example: brands
          schema:
            type: string
      responses:
        '200':
          description: Быстрорастущие бренды / продавцы / товары
          content:
            application/json:
              example:
                dates:
                  update: '2025-09-30'
                  start_period: '2025-09-01'
                  start_period_pre: '2025-08-02'
                data:
                  - position: 1
                    name: Pleasant home
                    revenue: 1369867
                    sells: 553
                    revenue_pre: 51908
                    sells_pre: 16
                    sales_change_percent: 3191
                    sales_up_per_day: 17
                    revenue_per_day: 45697
                    revenue_change_percent: 2379
                    revenue_up_per_day: 43854
                  - position: 2
                    name: Brillsten
                    revenue: 272823
                    sells: 165
                    revenue_pre: 27176
                    sells_pre: 18
                    sales_change_percent: 600
                    sales_up_per_day: 5
                    revenue_per_day: 9127
                    revenue_change_percent: 661
                    revenue_up_per_day: 7928
  /niche/items:
    post:
      summary: Товары предмета (ниши)
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: type
          in: query
          description: Необходимы тип данных (csv, json по умолчанию)
          required: false
          example: json
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список товаров
          content:
            application/json:
              example:
                startRow: 0
                endRow: 200
                total: 9755
                data:
                  - id: 3137867761
                    name: >-
                      Xiaomi Аэрогриль электрический Smart Air Fryer, 6.5л,
                      MAF10, белый
                    url: https://www.ozon.ru/context/detail/id/3137867761/
                    thumb: https://ir.ozone.ru/s3/multimedia-1-s/d100/8492959288.jpg
                    thumb_middle: https://ir.ozone.ru/s3/multimedia-1-s/d250/8492959288.jpg
                    niche_id: 10550
                    niche: Бытовая техника/Техника для кухни/Печи и грили/Аэрогрили
                    brand: Xiaomi
                    seller: МИЭНТЕК
                    seller_id: 3628678
                    category: Бытовая техника/Техника для кухни/Печи и грили/Аэрогрили
                    category_position: 118
                    final_price: 12448
                    final_price_average: 11933.56
                    final_price_min: 10874
                    final_price_max: 14257
                    final_price_median: 12180.5
                    start_price: 40000
                    ozon_card_price: 11415
                    balance: 2679
                    balance_fbs: 0
                    days_in_stock: 30
                    days_in_site: 56
                    sales: 3959
                    sales_per_day_average: 131.97
                    sales_per_comments: 2.73
                    revenue: 47244959
                    days_with_sales: 30
                    average_if_in_stock: 131.97
                    revenue_potential: 47244959
                    revenue_average: 1574831.97
                    lost_profit: 0
                    lost_profit_percent: 0
                    percent_from_revenue: 3.26
                    comments: 1804
                    comments_for_period: 1450
                    rating: 4.9
                    is_fbs: 0
                    sku_first_date: '2025-11-27'
                    picscount: 6
                    hasvideo: 0
                    turnover_days: 20.3
                    turnover_once: 1.88
                    frozen_stocks: 0
                    frozen_stocks_cost: 0
                    frozen_stocks_percent: 0
                    warehouses_count: 12
                    name_length: 66
                    groups: []
                    category_graph:
                      - 3
                      - 3
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                    search_words_count_graph:
                      - 399
                      - 415
                      - 401
                      - 424
                      - 419
                      - 427
                      - 445
                      - 455
                      - 464
                      - 432
                      - 408
                      - 451
                      - 441
                      - 408
                      - 369
                      - 401
                      - 367
                      - 378
                      - 364
                      - 393
                      - 373
                      - 355
                      - 382
                      - 366
                      - 417
                      - 442
                      - 440
                      - 409
                      - 394
                      - 355
                    graph:
                      - 288
                      - 245
                      - 193
                      - 264
                      - 284
                      - 221
                      - 200
                      - 82
                      - 102
                      - 160
                      - 181
                      - 212
                      - 166
                      - 145
                      - 160
                      - 65
                      - 52
                      - 65
                      - 57
                      - 65
                      - 67
                      - 65
                      - 70
                      - 93
                      - 74
                      - 77
                      - 88
                      - 81
                      - 80
                      - 57
                    stocks_graph:
                      - 1525
                      - 1338
                      - 2146
                      - 2385
                      - 2109
                      - 2013
                      - 1824
                      - 1746
                      - 1647
                      - 1581
                      - 1404
                      - 1197
                      - 1045
                      - 936
                      - 818
                      - 783
                      - 758
                      - 714
                      - 679
                      - 634
                      - 586
                      - 535
                      - 2090
                      - 2552
                      - 2868
                      - 2931
                      - 2855
                      - 2792
                      - 2727
                      - 2679
                    price_graph:
                      - 10874
                      - 11150
                      - 11628
                      - 11598
                      - 12185
                      - 11870
                      - 11796
                      - 11796
                      - 11531
                      - 11415
                      - 11178
                      - 11183
                      - 12107
                      - 11484
                      - 11976
                      - 14257
                      - 13174
                      - 13593
                      - 13835
                      - 13225
                      - 13275
                      - 12919
                      - 13311
                      - 12176
                      - 12799
                      - 12837
                      - 12544
                      - 12462
                      - 12278
                      - 12448
                    revenue_graph:
                      - 3131712
                      - 2731750
                      - 2244204
                      - 3061872
                      - 3460540
                      - 2623270
                      - 2359200
                      - 967272
                      - 1176162
                      - 1826400
                      - 2023218
                      - 2370796
                      - 2009762
                      - 1665180
                      - 1916160
                      - 926705
                      - 685048
                      - 883545
                      - 788595
                      - 859625
                      - 889425
                      - 839735
                      - 931770
                      - 1132368
                      - 947126
                      - 988449
                      - 1103872
                      - 1009422
                      - 982240
                      - 709536
                    rating_graph:
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                    search_position_graph:
                      - 41
                      - 27
                      - 41
                      - 63
                      - 43
                      - 80
                      - 72
                      - 91
                      - 96
                      - 96
                      - 16
                      - 103
                      - 62
                      - 37
                      - 35
                      - 100
                      - 58
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
  /niche/categories:
    post:
      summary: Категории предмета (ниши)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список категорий
          content:
            application/json:
              example:
                - name: Одежда/Женская одежда/Платья и сарафаны женские
                  items: 909053
                  items_with_sells: 158648
                  items_with_sells_percent: 17.45
                  brands: 6690
                  brands_with_sells: 3430
                  brands_with_sells_percent: 51.27
                  sellers: 29494
                  sellers_with_sells: 4335
                  sellers_with_sells_percent: 14.7
                  sales_per_items_average: 2.31
                  sales_per_items_with_sells_average: 13.25
                  sales: 2102288
                  revenue: 4560673751
                  revenue_per_items_average: 5016.95
                  revenue_per_items_with_sells_average: 28747.12
                  avg_price: 3852.92
                  comments: 322.75
                  rating: 4.58
                - name: Ozon fresh/Другие товары/Одежда и аксессуары/Верхняя одежда
                  items: 814324
                  items_with_sells: 157019
                  items_with_sells_percent: 19.28
                  brands: 6395
                  brands_with_sells: 3384
                  brands_with_sells_percent: 52.92
                  sellers: 24480
                  sellers_with_sells: 4262
                  sellers_with_sells_percent: 17.41
                  sales_per_items_average: 2.58
                  sales_per_items_with_sells_average: 13.36
                  sales: 2097377
                  revenue: 4508660995
                  revenue_per_items_average: 5536.69
                  revenue_per_items_with_sells_average: 28714.11
                  avg_price: 3775.93
                  comments: 326.02
                  rating: 4.58
  /niche/brands:
    post:
      summary: Бренды предмета (ниши)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список брендов
          content:
            application/json:
              example:
                data:
                  - name: SELA
                    items: 273
                    items_with_sells: 72
                    items_with_sells_percent: 26.37
                    sellers: 4
                    sellers_with_sells: 1
                    sellers_with_sells_percent: 25
                    sales: 10538
                    revenue: 41977009
                    sales_per_items_average: 38.6
                    sales_per_items_with_sells_average: 146.36
                    revenue_per_items_average: 153761.94
                    revenue_per_items_with_sells_average: 583014.01
                    balance: 8052
                    balance_price: 30745817
                    avg_price: 2195.93
                    rating: 4.78
                    comments: 110.67
                    position: 1
                    graph:
                      - 164
                      - 185
                      - 131
                      - 163
                      - 229
                      - 211
                      - 224
                      - 200
                      - 244
                      - 288
                      - 322
                      - 244
                      - 217
                      - 235
                      - 238
                      - 303
                      - 286
                      - 298
                      - 541
                      - 376
                      - 461
                      - 793
                      - 665
                      - 499
                      - 524
                      - 525
                      - 475
                      - 461
                      - 480
                      - 556
                    graph_revenue:
                      - 12721
                      - 15405
                      - 16942
                      - 18640
                      - 5808
                      - 29872
                      - 12565
                      - 12604
                      - 24544
                      - 19903
                      - 17736
                      - 11385
                      - 27972
                      - 27869
                      - 23064
                      - 13487
                      - 22686
                      - 2040
                      - 22577
                      - 14841
                      - 34632
                      - 30000
                      - 9038
                      - 34754
                      - 40853
                      - 52437
                      - 27576
                      - 28768
                      - 52435
                      - 32527
                summary:
                  graph:
                    - 152
                    - 128
                    - 121
                    - 147
                    - 122
                    - 197
                    - 187
                    - 157
                    - 185
                    - 199
                    - 219
                    - 211
                    - 217
                    - 197
                    - 155
                    - 193
                    - 228
                    - 170
                    - 189
                    - 195
                    - 188
                    - 158
                    - 175
                    - 189
                    - 198
                    - 171
                    - 186
                    - 170
                    - 167
                    - 197
                  graph_revenue:
                    - 19731719
                    - 20036603
                    - 20049981
                    - 21860359
                    - 20161945
                    - 21456713
                    - 20629659
                    - 21348746
                    - 20502398
                    - 19914638
                    - 19044937
                    - 17456793
                    - 22428024
                    - 19419840
                    - 20625962
                    - 21810711
                    - 21458910
                    - 21390640
                    - 21850831
                    - 22133729
                    - 22458589
                    - 24229292
                    - 24461782
                    - 24818557
                    - 23086344
                    - 22986686
                    - 23371630
                    - 23947394
                    - 24620611
                    - 25329730
  /niche/sellers:
    post:
      summary: Продавцы предмета (ниши)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список продавцов
          content:
            application/json:
              example:
                data:
                  - position: 1
                    id: 7984
                    name: ELECTRONIC ECOSYSTEMS
                    ogrn: '1177746271196'
                    items: 280
                    items_with_sells: 229
                    items_with_sells_percent: 81.79
                    brands: 1
                    brands_with_sells: 1
                    brands_with_sells_percent: 100
                    sales: 5324
                    revenue: 72671285
                    sales_per_items_average: 19.01
                    sales_per_items_with_sells_average: 23.25
                    revenue_per_items_average: 259540.3
                    revenue_per_items_with_sells_average: 317341.86
                    balance: 4049
                    balance_price: 71176295
                    avg_price: 14268.06
                    rating: 485.27
                    comments: 399.69
                    graph:
                      - 182
                      - 147
                      - 133
                      - 204
                      - 257
                      - 198
                      - 175
                      - 189
                      - 220
                      - 194
                      - 154
                      - 160
                      - 151
                      - 171
                      - 214
                      - 207
                      - 187
                      - 158
                      - 160
                      - 223
                      - 344
                      - 169
                      - 89
                      - 113
                      - 158
                      - 144
                      - 159
                      - 164
                      - 171
                      - 129
                    graph_revenue:
                      - 12721
                      - 15405
                      - 16942
                      - 18640
                      - 5808
                      - 29872
                      - 12565
                      - 12604
                      - 24544
                      - 19903
                      - 17736
                      - 11385
                      - 27972
                      - 27869
                      - 23064
                      - 13487
                      - 22686
                      - 2040
                      - 22577
                      - 14841
                      - 34632
                      - 30000
                      - 9038
                      - 34754
                      - 40853
                      - 52437
                      - 27576
                      - 28768
                      - 52435
                      - 32527
                summary:
                  graph:
                    - 152
                    - 128
                    - 121
                    - 147
                    - 122
                    - 197
                    - 187
                    - 157
                    - 185
                    - 199
                    - 219
                    - 211
                    - 217
                    - 197
                    - 155
                    - 193
                    - 228
                    - 170
                    - 189
                    - 195
                    - 188
                    - 158
                    - 175
                    - 189
                    - 198
                    - 171
                    - 186
                    - 170
                    - 167
                    - 197
                  graph_revenue:
                    - 19731719
                    - 20036603
                    - 20049981
                    - 21860359
                    - 20161945
                    - 21456713
                    - 20629659
                    - 21348746
                    - 20502398
                    - 19914638
                    - 19044937
                    - 17456793
                    - 22428024
                    - 19419840
                    - 20625962
                    - 21810711
                    - 21458910
                    - 21390640
                    - 21850831
                    - 22133729
                    - 22458589
                    - 24229292
                    - 24461782
                    - 24818557
                    - 23086344
                    - 22986686
                    - 23371630
                    - 23947394
                    - 24620611
                    - 25329730
  /niche/trends:
    post:
      summary: Тренды предмета (ниши)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: trends_by
          in: query
          description: Период трендов (день / неделя / месяц)
          required: false
          example: week
          schema:
            type: string
        - name: year
          in: query
          description: Год
          required: false
          example: 2025
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - date: '2024-01-01'
                  items: 13585
                  items_with_sells: 1760
                  brands: 1287
                  brands_with_sells: 321
                  sellers: 1066
                  sellers_with_sells: 289
                  sales: 8458
                  revenue: 48026713
                  product_revenue: 27288
                  average_order_value: 5678
                  end_date: '2024-01-07'
                  label_date: '2024-01-07'
                - date: '2024-01-08'
                  items: 13599
                  items_with_sells: 3159
                  brands: 1290
                  brands_with_sells: 495
                  sellers: 1068
                  sellers_with_sells: 440
                  sales: 12977
                  revenue: 74944549
                  product_revenue: 23724
                  average_order_value: 5775
                  end_date: '2024-01-14'
                  label_date: '2024-01-14'
  /niche/by_date:
    post:
      summary: Показатели за период по предмету (нише)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: groupBy
          in: query
          description: Период (day / week / month / quarter)
          required: false
          example: week
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - period: '2025-07-20'
                  balance: 987259
                  balance_price: 8711665952
                  avg_price: 7342.99
                  items: 152160
                  items_with_sells: 3339
                  brands: 7901
                  brands_with_sells: 818
                  sellers: 7461
                  sellers_with_sells: 829
                  sales: 7177
                  revenue: 40693538
                  comments: 33.34
                  rating: 4.64
                  avg_sale_price: 5669.99
                - period: '2025-07-19'
                  balance: 984248
                  balance_price: 8681202149
                  avg_price: 7338.01
                  items: 152106
                  items_with_sells: 2917
                  brands: 7903
                  brands_with_sells: 767
                  sellers: 7462
                  sellers_with_sells: 769
                  sales: 5690
                  revenue: 34244128
                  comments: 33.33
                  rating: 4.64
                  avg_sale_price: 6018.3
                - period: '2025-07-18'
                  balance: 989134
                  balance_price: 8528299459
                  avg_price: 7297.34
                  items: 152070
                  items_with_sells: 2812
                  brands: 7904
                  brands_with_sells: 760
                  sellers: 7464
                  sellers_with_sells: 779
                  sales: 5634
                  revenue: 65263547
                  comments: 32.98
                  rating: 4.64
                  avg_sale_price: 11583.87
  /niche/price_segmentation:
    post:
      summary: Ценовая сегментация предмета (ниши)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: minPrice
          in: query
          description: Минимальная цена
          required: false
          example: 1000
          schema:
            type: integer
        - name: maxPrice
          in: query
          description: Максимальная цена
          required: false
          example: 20000
          schema:
            type: integer
        - name: priceStep
          in: query
          description: Шаг ценового диапазона
          required: false
          example: 1000
          schema:
            type: integer
        - name: segmentsCnt
          in: query
          description: Кол-во сегментов
          required: false
          example: 10
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - range: 50-1155
                  items: 6120
                  items_with_sells: 149
                  brands: 1356
                  brands_with_sells: 74
                  sellers: 1268
                  sellers_with_sells: 73
                  revenue: 1435646
                  sales: 1299
                  product_revenue: 9635.21
                  min_range_price: 50
                  max_range_price: 1155
                  revenue_potential: 6170274.86
                  lost_profit: 4754366.86
                  lost_profit_percent: 77.05
                - range: 1155-1576
                  items: 6119
                  items_with_sells: 370
                  brands: 1554
                  brands_with_sells: 165
                  sellers: 1479
                  sellers_with_sells: 168
                  revenue: 5522225
                  sales: 3686
                  product_revenue: 14924.93
                  min_range_price: 1156
                  max_range_price: 1576
                  revenue_potential: 17412867.5
                  lost_profit: 11934997.5
                  lost_profit_percent: 68.54
  /niche/keywords:
    post:
      summary: Запросы по предмету (нише)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по поисковым запросам
          content:
            application/json:
              example:
                queries:
                  - word: игрушки для собак
                    count: 9735
                    wb_count: 99158
                    query_cluster: игрушки для собак
                    items_count: 76
                  - word: игрушка для собак
                    count: 6155
                    wb_count: 38877
                    query_cluster: игрушки для собак
                    items_count: 76
                words:
                  - count: 2856
                    word: собак
                    words:
                      - собак
                      - собаки
                      - собака
                      - собаке
                      - собаку
                      - собакам
                      - собакой
                      - собаками
                    keys:
                      - word: игрушки для собак
                        count: 9735
                        wb_count: 99158
                        query_cluster: игрушки для собак
                        items_count: 76
                      - word: игрушка для собак
                        count: 6155
                        wb_count: 38877
                        query_cluster: игрушки для собак
                        items_count: 76
                    mp: 0
                    keys_count_sum: 6386
                    keys_wb_count_sum: 66145
                  - count: 280
                    word: крупных
                    words:
                      - крупных
                      - крупной
                      - крупные
                      - крупная
                    keys:
                      - word: игрушки для щенков крупных пород
                        count: 116
                        wb_count: 533
                        query_cluster: игрушки для щенков крупных пород
                        items_count: 43
                      - word: игрушки для собак крупных пород
                        count: 2465
                        wb_count: 10255
                        query_cluster: игрушки для собак крупных пород
                        items_count: 42
                    mp: 0
                    keys_count_sum: 10135
                    keys_wb_count_sum: 62429
  /niche/geography:
    get:
      summary: География предмета (ниши)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: date
          in: query
          description: Дата в формате YYYY-MM
          required: true
          example: 2025-01
          schema:
            type: string
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
      responses:
        '200':
          description: Данные по регионам и складам
          content:
            application/json:
              example:
                period: 2025-07
                region_data:
                  - region: Москва, МО и Дальние регионы
                    sales: 702831
                    count: 24799730
                    revenue: 1535922940
                    sales_percent: 32.12
                    count_percent: 38.32
                    revenue_percent: 32.34
                  - region: Санкт-Петербург и СЗО
                    sales: 311168
                    count: 9137892
                    revenue: 684599487
                    sales_percent: 14.22
                    count_percent: 14.12
                    revenue_percent: 14.42
                storage_data:
                  - name: ПУШКИНО_1_РФЦ
                    region: Москва, МО и Дальние регионы
                    sales: 106563
                    count: 4399210
                    revenue: 223395038
                    sales_percent: 4.87
                    count_percent: 6.8
                    revenue_percent: 4.7
                  - name: СПБ_БУГРЫ_РФЦ
                    region: Санкт-Петербург и СЗО
                    sales: 120361
                    count: 3772210
                    revenue: 267257984
                    sales_percent: 5.5
                    count_percent: 5.83
                    revenue_percent: 5.63
  /niche/similar:
    get: &ref_0
      summary: Похожие ниши предмета (ниши)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
      responses:
        '200':
          description: Данные по похожим нишам
          content:
            application/json:
              example:
                - id: 7599
                  name: >-
                    Одежда/Детская одежда/Одежда для девочек/Платья и сарафаны
                    для девочек
                  sells: 407036
                  revenue: 528525152
                  revenue_percent: 29.42
                  items_with_sells: 42125
                  items_with_sells_percent: 19.34
                  items_with_count: 64334
                  avg_price_final_with_sells: 1644
                  sellers: 6696
                  sellers_with_sells_percent: 18.58
                  brands: 2049
                  brands_with_sells_percent: 47.39
                  avg_rating_with_sells: 4.76
                  similarity_count: 1440
                - id: 7635
                  name: >-
                    Одежда/Детская одежда/Одежда для новорожденных/Платья и юбки
                    для новорожденных
                  sells: 878
                  revenue: 763769
                  revenue_percent: 0.04
                  items_with_sells: 162
                  items_with_sells_percent: 16.91
                  items_with_count: 296
                  avg_price_final_with_sells: 1208.9
                  sellers: 136
                  sellers_with_sells_percent: 31.62
                  brands: 98
                  brands_with_sells_percent: 41.84
                  avg_rating_with_sells: 4.84
                  similarity_count: 752
  /niche/compare:
    post:
      summary: Сравнение периодов по товарам ниши
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: d11
          in: query
          description: Дата начала первого периода
          required: true
          example: '2025-01-01'
          schema:
            type: string
        - name: d12
          in: query
          description: Дата конца первого периода
          required: true
          example: '2025-02-01'
          schema:
            type: string
        - name: d21
          in: query
          description: Дата начала второго периода
          required: true
          example: '2025-02-01'
          schema:
            type: string
        - name: d22
          in: query
          description: Дата конца второго периода
          required: true
          example: '2025-03-01'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по товарам за выбранные периоды
          content:
            application/json:
              example:
                startRow: 0
                endRow: 200
                total: 10043800
                data:
                  - id: 1592320262
                    name: Футболка GoldenCate-I внуки
                    brand: GoldenCate-I
                    seller: GoldenCate-I
                    seller_id: 1882627
                    sales_1: 0
                    sales_2: 0
                    revenue_1: 0
                    revenue_2: 0
                    days_in_stock_1: 0
                    days_in_stock_2: 0
                    price_1: 1522
                    price_2: 1582
                    avg_price_1: 2179.17
                    avg_price_2: 1612.57
                    sales_diff: 0
                    revenue_diff: 0
                    days_in_stock_diff: 0
                    price_diff: 60
                    avg_price_diff: -566.6
                    thumb: https://cdn1.ozone.ru/s3/multimedia-1-n/7043160515.jpg
                  - id: 640524872
                    name: Платье пляжное
                    brand: ''
                    seller: самый быстрый, лучший, дешевый
                    seller_id: 281568
                    sales_1: 0
                    sales_2: 0
                    revenue_1: 0
                    revenue_2: 0
                    days_in_stock_1: 0
                    days_in_stock_2: 0
                    price_1: 706
                    price_2: 740
                    avg_price_1: 711.17
                    avg_price_2: 707.87
                    sales_diff: 0
                    revenue_diff: 0
                    days_in_stock_diff: 0
                    price_diff: 34
                    avg_price_diff: -3.3
                    thumb: https://cdn1.ozone.ru/s3/multimedia-t/6093784529.jpg
                summary:
                  sales_1: 20551030
                  sales_2: 22862898
                  revenue_1: 30366243940
                  revenue_2: 36120196612
                  sales_diff: 2311868
                  revenue_diff: 5753952672
  /niche/summary/stats:
    get:
      summary: Сводный отчёт ниши - основные показатели (для виджетов)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
      responses:
        '200':
          description: Параметры ниши (данные для виджетов)
          content:
            application/json:
              example:
                revenue: 2579806452
                revenue_previous: 3800204868
                revenue_potential: 4420051098.99
                lost_profit: 1840244646.99
                lost_profit_percent: 41.63
                items: 7541085
                items_previous: 6838617
                items_with_sells: 186500
                items_with_count: 197627
                sellers: 80094
                sellers_with_sells: 4534
                sellers_with_sells_percent: 5.66
                sellers_turnover_percent: 42
                monopolization: Низкая
                avg_price: 2136.16
                avg_price_previous: 1492.4
                average_order_value: 1166.94
                average_order_value_previous: 1067.96
                rating: 4.66
                rating_previous: 4.68
  /niche/summary/by_date:
    get:
      summary: Сводный отчёт ниши - показатели за период по предмету (нише)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: groupBy
          in: query
          description: Период (day / week / month / quarter)
          required: false
          example: week
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - period: '2025-07-20'
                  balance: 987259
                  balance_price: 8711665952
                  avg_price: 7342.99
                  items: 152160
                  items_with_sells: 3339
                  brands: 7901
                  brands_with_sells: 818
                  sellers: 7461
                  sellers_with_sells: 829
                  sales: 7177
                  revenue: 40693538
                  comments: 33.34
                  rating: 4.64
                  avg_sale_price: 5669.99
                - period: '2025-07-19'
                  balance: 984248
                  balance_price: 8681202149
                  avg_price: 7338.01
                  items: 152106
                  items_with_sells: 2917
                  brands: 7903
                  brands_with_sells: 767
                  sellers: 7462
                  sellers_with_sells: 769
                  sales: 5690
                  revenue: 34244128
                  comments: 33.33
                  rating: 4.64
                  avg_sale_price: 6018.3
                - period: '2025-07-18'
                  balance: 989134
                  balance_price: 8528299459
                  avg_price: 7297.34
                  items: 152070
                  items_with_sells: 2812
                  brands: 7904
                  brands_with_sells: 760
                  sellers: 7464
                  sellers_with_sells: 779
                  sales: 5634
                  revenue: 65263547
                  comments: 32.98
                  rating: 4.64
                  avg_sale_price: 11583.87
  /niche/summary/trends:
    get:
      summary: Сводный отчёт ниши - Тренды предмета (ниши)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: trends_by
          in: query
          description: Период трендов (день / неделя / месяц)
          required: false
          example: week
          schema:
            type: string
        - name: year
          in: query
          description: Год
          required: false
          example: 2025
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - date: '2024-01-01'
                  items: 13585
                  items_with_sells: 1760
                  brands: 1287
                  brands_with_sells: 321
                  sellers: 1066
                  sellers_with_sells: 289
                  sales: 8458
                  revenue: 48026713
                  product_revenue: 27288
                  average_order_value: 5678
                  end_date: '2024-01-07'
                  label_date: '2024-01-07'
                - date: '2024-01-08'
                  items: 13599
                  items_with_sells: 3159
                  brands: 1290
                  brands_with_sells: 495
                  sellers: 1068
                  sellers_with_sells: 440
                  sales: 12977
                  revenue: 74944549
                  product_revenue: 23724
                  average_order_value: 5775
                  end_date: '2024-01-14'
                  label_date: '2024-01-14'
  /niche/summary/brands:
    get:
      summary: Сводный отчёт ниши - топ брендов предмета (ниши)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список брендов
          content:
            application/json:
              example:
                - name: Zolla
                  items: 4283
                  items_with_sells: 3603
                  items_with_sells_percent: 84.12
                  sellers: 2
                  sellers_with_sells: 1
                  sellers_with_sells_percent: 50
                  sales: 148689
                  revenue: 196037512
                  sales_per_items_average: 34.72
                  sales_per_items_with_sells_average: 41.27
                  revenue_per_items_average: 45771.07
                  revenue_per_items_with_sells_average: 54409.52
                  position: 2
                  balance: 110735
                  balance_price: 139779176
                  avg_price: 1216.67
                  rating: 484.58
                  comments: 142.81
                  graph:
                    - 5981
                    - 5914
                    - 6020
                    - 6077
                    - 6341
                    - 6201
                    - 6591
                    - 6099
                    - 6317
                    - 5741
                    - 5369
                    - 5546
                    - 5285
                    - 4565
                    - 4274
                    - 4601
                    - 4614
                    - 4264
                    - 3853
                    - 2980
                    - 3100
                    - 3258
                    - 3692
                    - 4890
                    - 4798
                    - 4753
                    - 4688
                    - 4478
                    - 4143
                    - 4256
  /niche/summary/sellers:
    get:
      summary: Сводный отчёт ниши - топ продавцов предмета (ниши)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список продавцов
          content:
            application/json:
              example:
                - position: 1
                  id: 51350
                  name: Zolla
                  ogrn: '5067746653508'
                  items: 4091
                  items_with_sells: 3603
                  items_with_sells_percent: 88.07
                  brands: 1
                  brands_with_sells: 1
                  brands_with_sells_percent: 100
                  sales: 148689
                  revenue: 196037512
                  sales_per_items_average: 36.35
                  sales_per_items_with_sells_average: 41.27
                  revenue_per_items_average: 47919.22
                  revenue_per_items_with_sells_average: 54409.52
                  balance: 110735
                  balance_price: 139779176
                  avg_price: 1230.1
                  rating: 484.79
                  comments: 143.65
                  graph:
                    - 5981
                    - 5914
                    - 6020
                    - 6077
                    - 6341
                    - 6201
                    - 6591
                    - 6099
                    - 6317
                    - 5741
                    - 5369
                    - 5546
                    - 5285
                    - 4565
                    - 4274
                    - 4601
                    - 4614
                    - 4264
                    - 3853
                    - 2980
                    - 3100
                    - 3258
                    - 3692
                    - 4890
                    - 4798
                    - 4753
                    - 4688
                    - 4478
                    - 4143
                    - 4256
  /niche/summary/geography:
    get:
      summary: Сводный отчёт ниши - география предмета (ниши)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: date
          in: query
          description: Дата в формате YYYY-MM
          required: true
          example: 2025-01
          schema:
            type: string
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
      responses:
        '200':
          description: Данные по регионам
          content:
            application/json:
              example:
                period: 2025-07
                region_data:
                  - region: Москва, МО и Дальние регионы
                    sales: 702831
                    count: 24799730
                    revenue: 1535922940
                    sales_percent: 32.12
                    count_percent: 38.32
                    revenue_percent: 32.34
                  - region: Санкт-Петербург и СЗО
                    sales: 311168
                    count: 9137892
                    revenue: 684599487
                    sales_percent: 14.22
                    count_percent: 14.12
                    revenue_percent: 14.42
                  - region: Остальные
                    sales: 326736
                    count: 1048812
                    revenue: 281655281
                    sales_percent: 30.43
                    count_percent: 31.07
                    revenue_percent: 29.68
  /niche/summary/price_segmentation:
    get:
      summary: Сводный отчёт ниши - ценовая сегментация предмета (ниши)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: minPrice
          in: query
          description: Минимальная цена
          required: false
          example: 1000
          schema:
            type: integer
        - name: maxPrice
          in: query
          description: Максимальная цена
          required: false
          example: 20000
          schema:
            type: integer
        - name: priceStep
          in: query
          description: Шаг ценового диапазона
          required: false
          example: 1000
          schema:
            type: integer
        - name: segmentsCnt
          in: query
          description: Кол-во сегментов
          required: false
          example: 10
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: >-
            Топ 5 ценовых сегментов по упущенной выручке и данные по остальным
            сегментам
          content:
            application/json:
              example:
                - range: 11-306
                  items: 255180
                  items_with_sells: 7018
                  brands: 534
                  brands_with_sells: 252
                  sellers: 4594
                  sellers_with_sells: 361
                  revenue: 25991403
                  sales: 66621
                  product_revenue: 3703.53
                  min_range_price: 11
                  max_range_price: 306
                  revenue_potential: 54824481.67
                  lost_profit: 28854141.67
                  lost_profit_percent: 52.63
                - range: 973-1147
                  items: 243520
                  items_with_sells: 11549
                  brands: 1737
                  brands_with_sells: 742
                  sellers: 6528
                  sellers_with_sells: 913
                  revenue: 77235604
                  sales: 74428
                  product_revenue: 6687.64
                  min_range_price: 974
                  max_range_price: 1147
                  revenue_potential: 105514282.96
                  lost_profit: 28408131.96
                  lost_profit_percent: 26.92
                - range: 1147-1357
                  items: 243535
                  items_with_sells: 11245
                  brands: 1741
                  brands_with_sells: 733
                  sellers: 5463
                  sellers_with_sells: 866
                  revenue: 74251046
                  sales: 61854
                  product_revenue: 6603.03
                  min_range_price: 1148
                  max_range_price: 1357
                  revenue_potential: 110256622.03
                  lost_profit: 36149169.03
                  lost_profit_percent: 32.79
                - range: 1357-1683
                  items: 243789
                  items_with_sells: 11157
                  brands: 1789
                  brands_with_sells: 740
                  sellers: 4874
                  sellers_with_sells: 867
                  revenue: 73457384
                  sales: 52257
                  product_revenue: 6583.97
                  min_range_price: 1358
                  max_range_price: 1683
                  revenue_potential: 112847286.32
                  lost_profit: 39559608.32
                  lost_profit_percent: 35.06
                - range: 2164-10413
                  items: 243366
                  items_with_sells: 8289
                  brands: 2292
                  brands_with_sells: 729
                  sellers: 7250
                  sellers_with_sells: 792
                  revenue: 76327929
                  sales: 27091
                  product_revenue: 9208.34
                  min_range_price: 2165
                  max_range_price: 10413
                  revenue_potential: 149133666.7
                  lost_profit: 73142517.7
                  lost_profit_percent: 49.04
                - range: Остальные
                  items: 4854280
                  items_with_sells: 59424
                  brands: 17975
                  brands_with_sells: 5499
                  sellers: 129300
                  sellers_with_sells: 6975
                  revenue: 444717949
                  sales: 647856
                  product_revenue: 144034.5
                  min_range_price: 307
                  max_range_price: 340328448
                  revenue_potential: 633106696.21
                  lost_profit: 188953523.21
                  lost_profit_percent: 29.85
  /niche/summary/keywords:
    get:
      summary: Сводный отчёт ниши - запросы по предмету (нише)
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: ТОП 10 запросов по частотности и по эффективности
          content:
            application/json:
              example:
                top_by_count:
                  - word: футболка женская
                    count: 103010
                    wb_count: 1216734
                    items_count: 835
                    efficiency: 123.37
                  - word: футболка мужская
                    count: 102809
                    wb_count: 1033644
                    items_count: 120
                    efficiency: 856.74
                top_by_efficiency:
                  - word: рубашка женская
                    count: 41230
                    wb_count: 682560
                    items_count: 1
                    efficiency: 41230
                  - word: водолазка женская
                    count: 27154
                    wb_count: 320950
                    items_count: 1
                    efficiency: 27154
  /niche/summary/similar:
    get: *ref_0
  /niche/summary/competitors:
    get:
      summary: Сводный отчёт ниши - быстрорастущие товары
      tags:
        - niche
      parameters:
        - name: path
          in: query
          description: Id предмета (ниши)
          required: true
          example: 7502
          schema:
            type: integer
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
      responses:
        '200':
          description: Быстрорастущие товары (отчёт за 14 дней)
          content:
            application/json:
              example:
                dates:
                  update: '2026-01-20'
                  start_period: '2026-01-07'
                  start_period_pre: '2025-12-24'
                data:
                  - position: 1
                    id: 1787613572
                    revenue: 224904
                    sells: 254
                    revenue_pre: 50456
                    sells_pre: 52
                    sales_change_percent: 1093
                    sales_up_per_day: 26
                    revenue_per_day: 25373
                    revenue_change_percent: 938
                    revenue_up_per_day: 22929
                    name: Футболка Import Store Premium
                    url: https://www.ozon.ru/context/detail/id/1787613572/
                    thumb: https://ir.ozone.ru/s3/multimedia-1-8/d100/7740757340.jpg
                    thumb_middle: https://ir.ozone.ru/s3/multimedia-1-8/d250/7740757340.jpg
                    niche_id: 7508
                    niche: >-
                      Одежда/Женская одежда/Футболки и топы женские/Футболки и
                      поло женские
                    brand: Import Store
                    seller: Import Store
                    seller_id: 2496702
                    category: ''
                    category_position: 0
                    final_price: 961
                    final_price_average: 885.45
                    final_price_min: 856
                    final_price_max: 988
                    final_price_median: 938
                    start_price: 5507
                    ozon_card_price: 795
                    balance: 0
                    balance_fbs: 0
                    days_in_stock: 7
                    days_in_site: 372
                    sales: 254
                    sales_per_day_average: 18.14
                    sales_per_comments: 0.13
                    days_with_sales: 9
                    average_if_in_stock: 36.29
                    revenue_potential: 449808
                    revenue_average: 16064.57
                    lost_profit: 224904
                    lost_profit_percent: 50
                    percent_from_revenue: 0.06
                    comments: 45031
                    comments_for_period: 1968
                    rating: 4.9
                    is_fbs: 0
                    sku_first_date: '2025-01-13'
                    picscount: 6
                    hasvideo: 0
                    turnover_days: 0
                    turnover_once: 3.01
                    frozen_stocks: 0
                    frozen_stocks_cost: 0
                    frozen_stocks_percent: 0
                    warehouses_count: 0
                    name_length: 29
                    groups: []
                    category_graph:
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                    search_words_count_graph:
                      - 434
                      - 450
                      - 456
                      - 590
                      - 346
                      - 327
                      - 254
                      - 296
                      - 28
                      - 36
                      - 26
                      - 34
                      - 36
                      - 0
                    graph:
                      - 57
                      - 22
                      - 21
                      - 27
                      - 41
                      - 30
                      - 28
                      - 26
                      - 2
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                    stocks_graph:
                      - 169
                      - 154
                      - 131
                      - 109
                      - 71
                      - 43
                      - 20
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                    price_graph:
                      - 878
                      - 856
                      - 857
                      - 863
                      - 866
                      - 888
                      - 921
                      - 955
                      - 982
                      - 969
                      - 969
                      - 983
                      - 988
                      - 961
                    revenue_graph:
                      - 50046
                      - 18832
                      - 17997
                      - 23301
                      - 35506
                      - 26640
                      - 25788
                      - 24830
                      - 1964
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
  /category/list:
    post:
      summary: Список категорий
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - category
      parameters:
        - name: date
          in: query
          description: Дата
          required: false
          example: '2025-02-01'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
      responses:
        '200':
          description: Список категорий
          content:
            application/json:
              example:
                startRow: 0
                endRow: 100
                total: 7353
                data:
                  - name: Одежда
                    revenue: 67581192174
                    revenue_previous: 66335349313
                    sales: 36555184
                    sales_previous: 37279487
                    items: 30097617
                    items_previous: 27535366
                    items_with_sales: 3046738
                    brands: 41681
                    sellers: 218324
                  - name: Одежда/Женская одежда
                    revenue: 41453087305
                    revenue_previous: 40949969417
                    sales: 21275919
                    sales_previous: 21464731
                    items: 17112784
                    items_previous: 15544349
                    items_with_sales: 1724972
                    brands: 29062
                    sellers: 170541
  /category/items:
    post:
      summary: Товары категории
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - category
      parameters:
        - name: path
          in: query
          description: Название категории
          required: true
          example: Одежда/Женская одежда
          schema:
            type: string
        - name: type
          in: query
          description: Необходимы тип данных (csv, json по умолчанию)
          required: false
          example: json
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список товаров
          content:
            application/json:
              example:
                startRow: 0
                endRow: 200
                total: 9755
                data:
                  - id: 3137867761
                    name: >-
                      Xiaomi Аэрогриль электрический Smart Air Fryer, 6.5л,
                      MAF10, белый
                    url: https://www.ozon.ru/context/detail/id/3137867761/
                    thumb: https://ir.ozone.ru/s3/multimedia-1-s/d100/8492959288.jpg
                    thumb_middle: https://ir.ozone.ru/s3/multimedia-1-s/d250/8492959288.jpg
                    niche_id: 10550
                    niche: Бытовая техника/Техника для кухни/Печи и грили/Аэрогрили
                    brand: Xiaomi
                    seller: МИЭНТЕК
                    seller_id: 3628678
                    category: Бытовая техника/Техника для кухни/Печи и грили/Аэрогрили
                    category_position: 118
                    final_price: 12448
                    final_price_average: 11933.56
                    final_price_min: 10874
                    final_price_max: 14257
                    final_price_median: 12180.5
                    start_price: 40000
                    ozon_card_price: 11415
                    balance: 2679
                    balance_fbs: 0
                    days_in_stock: 30
                    days_in_site: 56
                    sales: 3959
                    sales_per_day_average: 131.97
                    sales_per_comments: 2.73
                    revenue: 47244959
                    days_with_sales: 30
                    average_if_in_stock: 131.97
                    revenue_potential: 47244959
                    revenue_average: 1574831.97
                    lost_profit: 0
                    lost_profit_percent: 0
                    percent_from_revenue: 3.26
                    comments: 1804
                    comments_for_period: 1450
                    rating: 4.9
                    is_fbs: 0
                    sku_first_date: '2025-11-27'
                    picscount: 6
                    hasvideo: 0
                    turnover_days: 20.3
                    turnover_once: 1.88
                    frozen_stocks: 0
                    frozen_stocks_cost: 0
                    frozen_stocks_percent: 0
                    warehouses_count: 12
                    name_length: 66
                    groups: []
                    category_graph:
                      - 3
                      - 3
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                    search_words_count_graph:
                      - 399
                      - 415
                      - 401
                      - 424
                      - 419
                      - 427
                      - 445
                      - 455
                      - 464
                      - 432
                      - 408
                      - 451
                      - 441
                      - 408
                      - 369
                      - 401
                      - 367
                      - 378
                      - 364
                      - 393
                      - 373
                      - 355
                      - 382
                      - 366
                      - 417
                      - 442
                      - 440
                      - 409
                      - 394
                      - 355
                    graph:
                      - 288
                      - 245
                      - 193
                      - 264
                      - 284
                      - 221
                      - 200
                      - 82
                      - 102
                      - 160
                      - 181
                      - 212
                      - 166
                      - 145
                      - 160
                      - 65
                      - 52
                      - 65
                      - 57
                      - 65
                      - 67
                      - 65
                      - 70
                      - 93
                      - 74
                      - 77
                      - 88
                      - 81
                      - 80
                      - 57
                    stocks_graph:
                      - 1525
                      - 1338
                      - 2146
                      - 2385
                      - 2109
                      - 2013
                      - 1824
                      - 1746
                      - 1647
                      - 1581
                      - 1404
                      - 1197
                      - 1045
                      - 936
                      - 818
                      - 783
                      - 758
                      - 714
                      - 679
                      - 634
                      - 586
                      - 535
                      - 2090
                      - 2552
                      - 2868
                      - 2931
                      - 2855
                      - 2792
                      - 2727
                      - 2679
                    price_graph:
                      - 10874
                      - 11150
                      - 11628
                      - 11598
                      - 12185
                      - 11870
                      - 11796
                      - 11796
                      - 11531
                      - 11415
                      - 11178
                      - 11183
                      - 12107
                      - 11484
                      - 11976
                      - 14257
                      - 13174
                      - 13593
                      - 13835
                      - 13225
                      - 13275
                      - 12919
                      - 13311
                      - 12176
                      - 12799
                      - 12837
                      - 12544
                      - 12462
                      - 12278
                      - 12448
                    revenue_graph:
                      - 3131712
                      - 2731750
                      - 2244204
                      - 3061872
                      - 3460540
                      - 2623270
                      - 2359200
                      - 967272
                      - 1176162
                      - 1826400
                      - 2023218
                      - 2370796
                      - 2009762
                      - 1665180
                      - 1916160
                      - 926705
                      - 685048
                      - 883545
                      - 788595
                      - 859625
                      - 889425
                      - 839735
                      - 931770
                      - 1132368
                      - 947126
                      - 988449
                      - 1103872
                      - 1009422
                      - 982240
                      - 709536
                    rating_graph:
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                    search_position_graph:
                      - 41
                      - 27
                      - 41
                      - 63
                      - 43
                      - 80
                      - 72
                      - 91
                      - 96
                      - 96
                      - 16
                      - 103
                      - 62
                      - 37
                      - 35
                      - 100
                      - 58
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
  /category/niches:
    post:
      summary: Предметы категории
      tags:
        - category
      parameters:
        - name: path
          in: query
          description: Название категории
          required: true
          example: Одежда/Женская одежда
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по нишам
          content:
            application/json:
              example:
                - id: 7530
                  name: >-
                    Одежда/Женская одежда/Верхняя одежда женская/Куртки и
                    пуховики женские
                  sales: 308204
                  balance: 844126
                  revenue: 6194601839
                  revenue_potential: 9595003947.26
                  revenue_per_items_average: 11397.95
                  revenue_per_items_with_sells_average: 96085.03
                  lost_profit: 3400402108.26
                  lost_profit_percent: 35.44
                  items: 543484
                  items_with_sells: 64470
                  items_with_sells_percent: 11.86
                  items_with_count: 101106
                  items_with_count_percent: 18.6
                  live_items: 121145
                  sellers: 17080
                  sellers_with_sells: 2012
                  sellers_with_sells_percent: 11.78
                  brands: 4011
                  brands_with_sells: 1695
                  brands_with_sells_percent: 42.26
                  sales_per_items_average: 0.57
                  sales_per_items_with_sells_average: 4.78
                  avg_price: 7851.17
                  avg_price_with_sells: 12634.94
                  min_price: 67
                  min_price_with_sells: 418
                  max_price: 25000000
                  max_price_with_sells: 25000000
                  median_price: 3181.5
                  median_price_with_sells: 4111
                  rating: 464.8
                  rating_with_sells: 486.35
                  comments: 133.86
                  turnover_in_days: 82.17
                  revenue_percent: 16.13
                  graph:
                    - 11107
                    - 9875
                    - 9233
                    - 10271
                    - 9842
                    - 9934
                    - 8831
                    - 9432
                    - 9203
                    - 9777
                    - 10161
                    - 10073
                    - 10938
                    - 10324
                    - 10497
                    - 11731
                    - 10535
                    - 10292
                    - 10108
                    - 9846
                    - 9908
                    - 10515
                    - 10653
                    - 10093
                    - 9784
                    - 9904
                    - 11282
                    - 10205
                    - 11435
                    - 12415
  /category/categories:
    post:
      summary: Подкатегории категории
      tags:
        - category
      parameters:
        - name: path
          in: query
          description: Название категории
          required: true
          example: Одежда/Женская одежда
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список категорий
          content:
            application/json:
              example:
                - name: Текущая категория
                  items: 13395835
                  items_with_sells: 1643141
                  brands: 29261
                  brands_with_sells: 16416
                  sellers: 138081
                  sellers_with_sells: 23331
                  sales: 23271792
                  revenue: 38400477529
                  avg_price: 2882.17
                  comments: 496
                  rating: 4.68
                  items_with_sells_percent: 12.27
                  brands_with_sells_percent: 56.1
                  sellers_with_sells_percent: 16.9
                  sales_per_items_average: 1.74
                  sales_per_items_with_sells_average: 14.16
                  revenue_per_items_average: 2866.6
                  revenue_per_items_with_sells_average: 23370.17
                - name: Одежда больших размеров женская
                  items: 4111808
                  items_with_sells: 451622
                  brands: 14481
                  brands_with_sells: 8141
                  sellers: 79427
                  sellers_with_sells: 10288
                  sales: 5363101
                  revenue: 8475459057
                  avg_price: 2116.69
                  comments: 658
                  rating: 4.68
                  items_with_sells_percent: 10.98
                  brands_with_sells_percent: 56.22
                  sellers_with_sells_percent: 12.95
                  sales_per_items_average: 1.3
                  sales_per_items_with_sells_average: 11.88
                  revenue_per_items_average: 2061.25
                  revenue_per_items_with_sells_average: 18766.71
  /category/brands:
    post:
      summary: Бренды категории
      tags:
        - category
      parameters:
        - name: path
          in: query
          description: Название категории
          required: true
          example: Женщинам/Джинсы
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список брендов
          content:
            application/json:
              example:
                data:
                  - name: SELA
                    items: 273
                    items_with_sells: 72
                    items_with_sells_percent: 26.37
                    sellers: 4
                    sellers_with_sells: 1
                    sellers_with_sells_percent: 25
                    sales: 10538
                    revenue: 41977009
                    sales_per_items_average: 38.6
                    sales_per_items_with_sells_average: 146.36
                    revenue_per_items_average: 153761.94
                    revenue_per_items_with_sells_average: 583014.01
                    balance: 8052
                    balance_price: 30745817
                    avg_price: 2195.93
                    rating: 4.78
                    comments: 110.67
                    position: 1
                    graph:
                      - 164
                      - 185
                      - 131
                      - 163
                      - 229
                      - 211
                      - 224
                      - 200
                      - 244
                      - 288
                      - 322
                      - 244
                      - 217
                      - 235
                      - 238
                      - 303
                      - 286
                      - 298
                      - 541
                      - 376
                      - 461
                      - 793
                      - 665
                      - 499
                      - 524
                      - 525
                      - 475
                      - 461
                      - 480
                      - 556
                    graph_revenue:
                      - 12721
                      - 15405
                      - 16942
                      - 18640
                      - 5808
                      - 29872
                      - 12565
                      - 12604
                      - 24544
                      - 19903
                      - 17736
                      - 11385
                      - 27972
                      - 27869
                      - 23064
                      - 13487
                      - 22686
                      - 2040
                      - 22577
                      - 14841
                      - 34632
                      - 30000
                      - 9038
                      - 34754
                      - 40853
                      - 52437
                      - 27576
                      - 28768
                      - 52435
                      - 32527
                summary:
                  graph:
                    - 152
                    - 128
                    - 121
                    - 147
                    - 122
                    - 197
                    - 187
                    - 157
                    - 185
                    - 199
                    - 219
                    - 211
                    - 217
                    - 197
                    - 155
                    - 193
                    - 228
                    - 170
                    - 189
                    - 195
                    - 188
                    - 158
                    - 175
                    - 189
                    - 198
                    - 171
                    - 186
                    - 170
                    - 167
                    - 197
                  graph_revenue:
                    - 19731719
                    - 20036603
                    - 20049981
                    - 21860359
                    - 20161945
                    - 21456713
                    - 20629659
                    - 21348746
                    - 20502398
                    - 19914638
                    - 19044937
                    - 17456793
                    - 22428024
                    - 19419840
                    - 20625962
                    - 21810711
                    - 21458910
                    - 21390640
                    - 21850831
                    - 22133729
                    - 22458589
                    - 24229292
                    - 24461782
                    - 24818557
                    - 23086344
                    - 22986686
                    - 23371630
                    - 23947394
                    - 24620611
                    - 25329730
  /category/sellers:
    post:
      summary: Продавцы категории
      tags:
        - category
      parameters:
        - name: path
          in: query
          description: Название категории
          required: true
          example: Одежда/Женская одежда
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список продавцов
          content:
            application/json:
              example:
                data:
                  - position: 1
                    id: 7984
                    name: ELECTRONIC ECOSYSTEMS
                    ogrn: '1177746271196'
                    items: 280
                    items_with_sells: 229
                    items_with_sells_percent: 81.79
                    brands: 1
                    brands_with_sells: 1
                    brands_with_sells_percent: 100
                    sales: 5324
                    revenue: 72671285
                    sales_per_items_average: 19.01
                    sales_per_items_with_sells_average: 23.25
                    revenue_per_items_average: 259540.3
                    revenue_per_items_with_sells_average: 317341.86
                    balance: 4049
                    balance_price: 71176295
                    avg_price: 14268.06
                    rating: 485.27
                    comments: 399.69
                    graph:
                      - 182
                      - 147
                      - 133
                      - 204
                      - 257
                      - 198
                      - 175
                      - 189
                      - 220
                      - 194
                      - 154
                      - 160
                      - 151
                      - 171
                      - 214
                      - 207
                      - 187
                      - 158
                      - 160
                      - 223
                      - 344
                      - 169
                      - 89
                      - 113
                      - 158
                      - 144
                      - 159
                      - 164
                      - 171
                      - 129
                    graph_revenue:
                      - 12721
                      - 15405
                      - 16942
                      - 18640
                      - 5808
                      - 29872
                      - 12565
                      - 12604
                      - 24544
                      - 19903
                      - 17736
                      - 11385
                      - 27972
                      - 27869
                      - 23064
                      - 13487
                      - 22686
                      - 2040
                      - 22577
                      - 14841
                      - 34632
                      - 30000
                      - 9038
                      - 34754
                      - 40853
                      - 52437
                      - 27576
                      - 28768
                      - 52435
                      - 32527
                summary:
                  graph:
                    - 152
                    - 128
                    - 121
                    - 147
                    - 122
                    - 197
                    - 187
                    - 157
                    - 185
                    - 199
                    - 219
                    - 211
                    - 217
                    - 197
                    - 155
                    - 193
                    - 228
                    - 170
                    - 189
                    - 195
                    - 188
                    - 158
                    - 175
                    - 189
                    - 198
                    - 171
                    - 186
                    - 170
                    - 167
                    - 197
                  graph_revenue:
                    - 19731719
                    - 20036603
                    - 20049981
                    - 21860359
                    - 20161945
                    - 21456713
                    - 20629659
                    - 21348746
                    - 20502398
                    - 19914638
                    - 19044937
                    - 17456793
                    - 22428024
                    - 19419840
                    - 20625962
                    - 21810711
                    - 21458910
                    - 21390640
                    - 21850831
                    - 22133729
                    - 22458589
                    - 24229292
                    - 24461782
                    - 24818557
                    - 23086344
                    - 22986686
                    - 23371630
                    - 23947394
                    - 24620611
                    - 25329730
  /category/trends:
    post:
      summary: Тренды категории
      tags:
        - category
      parameters:
        - name: path
          in: query
          description: Название категории
          required: true
          example: Одежда/Женская одежда
          schema:
            type: string
        - name: trends_by
          in: query
          description: Период трендов (день / неделя / месяц)
          required: false
          example: week
          schema:
            type: string
        - name: year
          in: query
          description: Год
          required: false
          example: 2025
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - date: '2020-02-01'
                  items: 100992
                  items_with_sells: 11929
                  brands: 866
                  brands_with_sells: 270
                  sellers: 445
                  sellers_with_sells: 236
                  sales: 53087
                  revenue: 33867506
                  product_revenue: 2839
                  average_order_value: 638
                  end_date: '2020-02-29'
                  label_date: 2020-02
                - date: '2020-03-01'
                  items: 104966
                  items_with_sells: 13887
                  brands: 965
                  brands_with_sells: 311
                  sellers: 519
                  sellers_with_sells: 266
                  sales: 59627
                  revenue: 35365700
                  product_revenue: 2547
                  average_order_value: 593
                  end_date: '2020-03-31'
                  label_date: 2020-03
  /category/by_date:
    post:
      summary: Показатели за период по категории
      tags:
        - category
      parameters:
        - name: path
          in: query
          description: Название категории
          required: true
          example: Одежда/Женская одежда
          schema:
            type: string
        - name: groupBy
          in: query
          description: Период (day / week / month / quarter)
          required: false
          example: week
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - period: '2025-08-04'
                  balance: 34306779
                  balance_price: 59419013421
                  avg_price: 2888.05
                  items: 11406295
                  items_with_sells: 478541
                  brands: 27288
                  brands_with_sells: 11039
                  sellers: 118052
                  sellers_with_sells: 15508
                  sales: 1434482
                  revenue: 2107010848
                  comments: 511.75
                  rating: 468.28
                  avg_sale_price: 1468.83
                - period: '2025-07-28'
                  balance: 34188883
                  balance_price: 58592575953
                  avg_price: 2847.48
                  items: 11840448
                  items_with_sells: 942127
                  brands: 27697
                  brands_with_sells: 13606
                  sellers: 125641
                  sellers_with_sells: 19483
                  sales: 5205368
                  revenue: 7444115753
                  comments: 506.37
                  rating: 468.08
                  avg_sale_price: 1430.08
  /category/price_segmentation:
    post:
      summary: Ценовая сегментация категории
      tags:
        - category
      parameters:
        - name: path
          in: query
          description: Название категории
          required: true
          example: Одежда/Женская одежда
          schema:
            type: string
        - name: minPrice
          in: query
          description: Минимальная цена
          required: false
          example: 1000
          schema:
            type: integer
        - name: maxPrice
          in: query
          description: Максимальная цена
          required: false
          example: 20000
          schema:
            type: integer
        - name: priceStep
          in: query
          description: Шаг ценового диапазона
          required: false
          example: 1000
          schema:
            type: integer
        - name: segmentsCnt
          in: query
          description: Кол-во сегментов
          required: false
          example: 10
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - range: 11-321
                  items: 560245
                  items_with_sells: 25771
                  brands: 3448
                  brands_with_sells: 1473
                  sellers: 28082
                  sellers_with_sells: 2479
                  revenue: 226259141
                  sales: 883396
                  product_revenue: 8779.6
                  min_range_price: 11
                  max_range_price: 321
                  revenue_potential: 311490916.04
                  lost_profit: 85643643.04
                  lost_profit_percent: 27.49
                - range: 321-487
                  items: 546314
                  items_with_sells: 66213
                  brands: 5670
                  brands_with_sells: 2812
                  sellers: 30260
                  sellers_with_sells: 4710
                  revenue: 874176628
                  sales: 2107076
                  product_revenue: 13202.49
                  min_range_price: 322
                  max_range_price: 487
                  revenue_potential: 1145693244.53
                  lost_profit: 271764028.53
                  lost_profit_percent: 23.72
  /category/keywords:
    post:
      summary: Запросы по категории
      tags:
        - category
      parameters:
        - name: path
          in: query
          description: Название категории
          required: true
          example: Одежда/Женская одежда
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по поисковым запросам
          content:
            application/json:
              example:
                queries:
                  - word: игрушки для собак
                    count: 9735
                    wb_count: 99158
                    query_cluster: игрушки для собак
                    items_count: 76
                  - word: игрушка для собак
                    count: 6155
                    wb_count: 38877
                    query_cluster: игрушки для собак
                    items_count: 76
                words:
                  - count: 2856
                    word: собак
                    words:
                      - собак
                      - собаки
                      - собака
                      - собаке
                      - собаку
                      - собакам
                      - собакой
                      - собаками
                    keys:
                      - word: игрушки для собак
                        count: 9735
                        wb_count: 99158
                        query_cluster: игрушки для собак
                        items_count: 76
                      - word: игрушка для собак
                        count: 6155
                        wb_count: 38877
                        query_cluster: игрушки для собак
                        items_count: 76
                    mp: 0
                    keys_count_sum: 6386
                    keys_wb_count_sum: 66145
                  - count: 280
                    word: крупных
                    words:
                      - крупных
                      - крупной
                      - крупные
                      - крупная
                    keys:
                      - word: игрушки для щенков крупных пород
                        count: 116
                        wb_count: 533
                        query_cluster: игрушки для щенков крупных пород
                        items_count: 43
                      - word: игрушки для собак крупных пород
                        count: 2465
                        wb_count: 10255
                        query_cluster: игрушки для собак крупных пород
                        items_count: 42
                    mp: 0
                    keys_count_sum: 10135
                    keys_wb_count_sum: 62429
  /category/compare:
    post:
      summary: Сравнение периодов по товарам категории
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - category
      parameters:
        - name: path
          in: query
          description: Название категории
          required: true
          example: Одежда/Женская одежда
          schema:
            type: string
        - name: d11
          in: query
          description: Дата начала первого периода
          required: true
          example: '2025-01-01'
          schema:
            type: string
        - name: d12
          in: query
          description: Дата конца первого периода
          required: true
          example: '2025-02-01'
          schema:
            type: string
        - name: d21
          in: query
          description: Дата начала второго периода
          required: true
          example: '2025-02-01'
          schema:
            type: string
        - name: d22
          in: query
          description: Дата конца второго периода
          required: true
          example: '2025-03-01'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по товарам за выбранные периоды
          content:
            application/json:
              example:
                startRow: 0
                endRow: 200
                total: 10043800
                data:
                  - id: 1592320262
                    name: Футболка GoldenCate-I внуки
                    brand: GoldenCate-I
                    seller: GoldenCate-I
                    seller_id: 1882627
                    sales_1: 0
                    sales_2: 0
                    revenue_1: 0
                    revenue_2: 0
                    days_in_stock_1: 0
                    days_in_stock_2: 0
                    price_1: 1522
                    price_2: 1582
                    avg_price_1: 2179.17
                    avg_price_2: 1612.57
                    sales_diff: 0
                    revenue_diff: 0
                    days_in_stock_diff: 0
                    price_diff: 60
                    avg_price_diff: -566.6
                    thumb: https://cdn1.ozone.ru/s3/multimedia-1-n/7043160515.jpg
                  - id: 640524872
                    name: Платье пляжное
                    brand: ''
                    seller: самый быстрый, лучший, дешевый
                    seller_id: 281568
                    sales_1: 0
                    sales_2: 0
                    revenue_1: 0
                    revenue_2: 0
                    days_in_stock_1: 0
                    days_in_stock_2: 0
                    price_1: 706
                    price_2: 740
                    avg_price_1: 711.17
                    avg_price_2: 707.87
                    sales_diff: 0
                    revenue_diff: 0
                    days_in_stock_diff: 0
                    price_diff: 34
                    avg_price_diff: -3.3
                    thumb: https://cdn1.ozone.ru/s3/multimedia-t/6093784529.jpg
                summary:
                  sales_1: 20551030
                  sales_2: 22862898
                  revenue_1: 30366243940
                  revenue_2: 36120196612
                  sales_diff: 2311868
                  revenue_diff: 5753952672
  /seller/list:
    post:
      summary: Список продавцов
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - seller
      parameters:
        - name: type
          in: query
          description: Необходимы тип данных (csv, xls, json по умолчанию)
          required: false
          example: json
          schema:
            type: string
        - name: date
          in: query
          description: Дата
          required: false
          example: '2025-02-01'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: onlyFavorite
          in: query
          description: Только избранные
          required: false
          example: 1
          schema:
            type: boolean
        - name: search
          in: query
          description: Поисковый запрос
          required: false
          example: Кари
          schema:
            type: string
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список предметов
          content:
            application/json:
              example:
                startRow: 0
                endRow: 100
                total: 7353
                data:
                  - supplier_id: 7
                    name: Kari
                    first_date: '2020-01-04'
                    ogrn: '1117746491500'
                    position: 1
                    niches: 451
                    niches_with_sells: 419
                    niches_with_sells_percent: 93
                    items: 144113
                    items_with_count: 105910
                    items_with_sells: 106960
                    items_with_sells_percent: 74
                    live_items: 128512
                    items_new: 2504
                    items_new_percent: 2
                    items_new_with_sells: 1803
                    items_new_with_sells_percent: 1
                    brands: 48
                    brands_with_sells: 38
                    brands_with_sells_percent: 79
                    sales: 1874268
                    balance: 2645820
                    revenue: 2249846368
                    revenue_potential: 2832950033.9
                    lost_profit: 583103665.9
                    lost_profit_percent: 21
                    min_price: 38
                    min_price_with_sells: 49
                    max_price: 26711
                    max_price_with_sells: 26711
                    avg_price: 1323.55
                    avg_price_with_sells: 1311.9
                    median_price: 1186
                    median_price_with_sells: 1187
                    avg_rating: 4.76
                    avg_rating_with_sells: 4.82
                    turnover_in_days: 106
                    frozen_stocks: 1560035
                    frozen_stocks_cost: 2135574248
                    frozen_stocks_percent: 59
                    favorite: true
                  - supplier_id: 8145
                    name: ГАУФ РУС
                    first_date: '2020-01-27'
                    ogrn: '1177746995502'
                    position: 2
                    niches: 40
                    niches_with_sells: 38
                    niches_with_sells_percent: 95
                    items: 920
                    items_with_count: 604
                    items_with_sells: 773
                    items_with_sells_percent: 84
                    live_items: 795
                    items_new: 55
                    items_new_percent: 6
                    items_new_with_sells: 37
                    items_new_with_sells_percent: 4
                    brands: 2
                    brands_with_sells: 2
                    brands_with_sells_percent: 100
                    sales: 82802
                    balance: 143126
                    revenue: 1527592407
                    revenue_potential: 1809949379.66
                    lost_profit: 282356972.66
                    lost_profit_percent: 16
                    min_price: 258
                    min_price_with_sells: 258
                    max_price: 146152
                    max_price_with_sells: 146152
                    avg_price: 27718.86
                    avg_price_with_sells: 27225.25
                    median_price: 21832
                    median_price_with_sells: 21832
                    avg_rating: 4.37
                    avg_rating_with_sells: 4.55
                    turnover_in_days: 60
                    frozen_stocks: 67094
                    frozen_stocks_cost: 1192330447
                    frozen_stocks_percent: 47
                    favorite: false
  /seller/{id}:
    get:
      summary: Информация о продавце
      tags:
        - seller
      parameters:
        - name: id
          in: path
          description: ID продавца
          required: true
          example: 7
          schema:
            type: integer
      responses:
        '200':
          description: Продавец
          content:
            application/json:
              example:
                name: Kari
                wb_id: 8475
  /seller/items:
    post:
      summary: Товары продавца
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - seller
      parameters:
        - name: path
          in: query
          description: Id продавца
          required: false
          example: 7
          schema:
            type: integer
        - name: type
          in: query
          description: Необходимы тип данных (csv, json по умолчанию)
          required: false
          example: json
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список товаров
          content:
            application/json:
              example:
                startRow: 0
                endRow: 200
                total: 9755
                data:
                  - id: 3137867761
                    name: >-
                      Xiaomi Аэрогриль электрический Smart Air Fryer, 6.5л,
                      MAF10, белый
                    url: https://www.ozon.ru/context/detail/id/3137867761/
                    thumb: https://ir.ozone.ru/s3/multimedia-1-s/d100/8492959288.jpg
                    thumb_middle: https://ir.ozone.ru/s3/multimedia-1-s/d250/8492959288.jpg
                    niche_id: 10550
                    niche: Бытовая техника/Техника для кухни/Печи и грили/Аэрогрили
                    brand: Xiaomi
                    seller: МИЭНТЕК
                    seller_id: 3628678
                    category: Бытовая техника/Техника для кухни/Печи и грили/Аэрогрили
                    category_position: 118
                    final_price: 12448
                    final_price_average: 11933.56
                    final_price_min: 10874
                    final_price_max: 14257
                    final_price_median: 12180.5
                    start_price: 40000
                    ozon_card_price: 11415
                    balance: 2679
                    balance_fbs: 0
                    days_in_stock: 30
                    days_in_site: 56
                    sales: 3959
                    sales_per_day_average: 131.97
                    sales_per_comments: 2.73
                    revenue: 47244959
                    days_with_sales: 30
                    average_if_in_stock: 131.97
                    revenue_potential: 47244959
                    revenue_average: 1574831.97
                    lost_profit: 0
                    lost_profit_percent: 0
                    percent_from_revenue: 3.26
                    comments: 1804
                    comments_for_period: 1450
                    rating: 4.9
                    is_fbs: 0
                    sku_first_date: '2025-11-27'
                    picscount: 6
                    hasvideo: 0
                    turnover_days: 20.3
                    turnover_once: 1.88
                    frozen_stocks: 0
                    frozen_stocks_cost: 0
                    frozen_stocks_percent: 0
                    warehouses_count: 12
                    name_length: 66
                    groups: []
                    category_graph:
                      - 3
                      - 3
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                    search_words_count_graph:
                      - 399
                      - 415
                      - 401
                      - 424
                      - 419
                      - 427
                      - 445
                      - 455
                      - 464
                      - 432
                      - 408
                      - 451
                      - 441
                      - 408
                      - 369
                      - 401
                      - 367
                      - 378
                      - 364
                      - 393
                      - 373
                      - 355
                      - 382
                      - 366
                      - 417
                      - 442
                      - 440
                      - 409
                      - 394
                      - 355
                    graph:
                      - 288
                      - 245
                      - 193
                      - 264
                      - 284
                      - 221
                      - 200
                      - 82
                      - 102
                      - 160
                      - 181
                      - 212
                      - 166
                      - 145
                      - 160
                      - 65
                      - 52
                      - 65
                      - 57
                      - 65
                      - 67
                      - 65
                      - 70
                      - 93
                      - 74
                      - 77
                      - 88
                      - 81
                      - 80
                      - 57
                    stocks_graph:
                      - 1525
                      - 1338
                      - 2146
                      - 2385
                      - 2109
                      - 2013
                      - 1824
                      - 1746
                      - 1647
                      - 1581
                      - 1404
                      - 1197
                      - 1045
                      - 936
                      - 818
                      - 783
                      - 758
                      - 714
                      - 679
                      - 634
                      - 586
                      - 535
                      - 2090
                      - 2552
                      - 2868
                      - 2931
                      - 2855
                      - 2792
                      - 2727
                      - 2679
                    price_graph:
                      - 10874
                      - 11150
                      - 11628
                      - 11598
                      - 12185
                      - 11870
                      - 11796
                      - 11796
                      - 11531
                      - 11415
                      - 11178
                      - 11183
                      - 12107
                      - 11484
                      - 11976
                      - 14257
                      - 13174
                      - 13593
                      - 13835
                      - 13225
                      - 13275
                      - 12919
                      - 13311
                      - 12176
                      - 12799
                      - 12837
                      - 12544
                      - 12462
                      - 12278
                      - 12448
                    revenue_graph:
                      - 3131712
                      - 2731750
                      - 2244204
                      - 3061872
                      - 3460540
                      - 2623270
                      - 2359200
                      - 967272
                      - 1176162
                      - 1826400
                      - 2023218
                      - 2370796
                      - 2009762
                      - 1665180
                      - 1916160
                      - 926705
                      - 685048
                      - 883545
                      - 788595
                      - 859625
                      - 889425
                      - 839735
                      - 931770
                      - 1132368
                      - 947126
                      - 988449
                      - 1103872
                      - 1009422
                      - 982240
                      - 709536
                    rating_graph:
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                    search_position_graph:
                      - 41
                      - 27
                      - 41
                      - 63
                      - 43
                      - 80
                      - 72
                      - 91
                      - 96
                      - 96
                      - 16
                      - 103
                      - 62
                      - 37
                      - 35
                      - 100
                      - 58
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
  /seller/niches:
    post:
      summary: Предметы (ниши) продавца
      tags:
        - seller
      parameters:
        - name: path
          in: query
          description: Id продавца
          required: false
          example: 7
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по нишам
          content:
            application/json:
              example:
                - id: 7645
                  name: Обувь/Женская обувь/Босоножки и сандалии женские
                  sales: 298721
                  balance: 297164
                  revenue: 409795832
                  revenue_potential: 472495811.56
                  revenue_per_items_average: 31725.31
                  revenue_per_items_with_sells_average: 38449.6
                  lost_profit: 62699979.56
                  lost_profit_percent: 13.27
                  items: 12917
                  items_with_sells: 10658
                  items_with_sells_percent: 82.51
                  items_with_count: 8826
                  items_with_count_percent: 68.33
                  live_items: 10912
                  sellers: 1
                  sellers_with_sells: 1
                  sellers_with_sells_percent: 100
                  brands: 5
                  brands_with_sells: 5
                  brands_with_sells_percent: 100
                  sales_per_items_average: 23.13
                  sales_per_items_with_sells_average: 28.03
                  avg_price: 1431.23
                  avg_price_with_sells: 1510.06
                  min_price: 206
                  min_price_with_sells: 345
                  max_price: 5250
                  max_price_with_sells: 5250
                  median_price: 1286
                  median_price_with_sells: 1353.5
                  rating: 485.59
                  rating_with_sells: 486.04
                  comments: 2504.73
                  turnover_in_days: 29.84
                  revenue_percent: 19.73
                  graph:
                    - 14002
                    - 15548
                    - 16582
                    - 16149
                    - 16010
                    - 15205
                    - 15061
                    - 14879
                    - 13259
                    - 13083
                    - 11911
                    - 9526
                    - 8012
                    - 7498
                    - 7908
                    - 8046
                    - 7994
                    - 7553
                    - 7090
                    - 6777
                    - 6763
                    - 7202
                    - 7756
                    - 9030
                    - 9072
                    - 7503
                    - 5496
                    - 4556
                    - 4644
                    - 4606
  /seller/categories:
    post:
      summary: Категории продавца
      tags:
        - seller
      parameters:
        - name: path
          in: query
          description: Id продавца
          required: false
          example: 7
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список категорий
          content:
            application/json:
              example:
                - name: Ozon fresh/Другие товары/Одежда и аксессуары/Обувь/Ботинки
                  items: 48493
                  items_with_sells: 36807
                  items_with_sells_percent: 75.9
                  brands: 22
                  brands_with_sells: 20
                  brands_with_sells_percent: 90.91
                  sellers: 1
                  sellers_with_sells: 1
                  sellers_with_sells_percent: 100
                  sales_per_items_average: 5.85
                  sales_per_items_with_sells_average: 7.71
                  sales: 283897
                  revenue: 451959174
                  revenue_per_items_average: 9320.09
                  revenue_per_items_with_sells_average: 12279.16
                  avg_price: 1800.68
                  comments: 1735.35
                  rating: 4.84
                - name: Ozon fresh/Другие товары/Одежда и аксессуары/Обувь/Кроссовки
                  items: 33680
                  items_with_sells: 28977
                  items_with_sells_percent: 86.04
                  brands: 11
                  brands_with_sells: 11
                  brands_with_sells_percent: 100
                  sellers: 1
                  sellers_with_sells: 1
                  sellers_with_sells_percent: 100
                  sales_per_items_average: 8.8
                  sales_per_items_with_sells_average: 10.23
                  sales: 296355
                  revenue: 451003204
                  revenue_per_items_average: 13390.83
                  revenue_per_items_with_sells_average: 15564.18
                  avg_price: 1655.86
                  comments: 2873.6
                  rating: 4.87
  /seller/brands:
    post:
      summary: Бренды продавца
      tags:
        - seller
      parameters:
        - name: path
          in: query
          description: Id продавца
          required: false
          example: 7
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список брендов
          content:
            application/json:
              example:
                data:
                  - name: SELA
                    items: 273
                    items_with_sells: 72
                    items_with_sells_percent: 26.37
                    sellers: 4
                    sellers_with_sells: 1
                    sellers_with_sells_percent: 25
                    sales: 10538
                    revenue: 41977009
                    sales_per_items_average: 38.6
                    sales_per_items_with_sells_average: 146.36
                    revenue_per_items_average: 153761.94
                    revenue_per_items_with_sells_average: 583014.01
                    balance: 8052
                    balance_price: 30745817
                    avg_price: 2195.93
                    rating: 4.78
                    comments: 110.67
                    position: 1
                    graph:
                      - 164
                      - 185
                      - 131
                      - 163
                      - 229
                      - 211
                      - 224
                      - 200
                      - 244
                      - 288
                      - 322
                      - 244
                      - 217
                      - 235
                      - 238
                      - 303
                      - 286
                      - 298
                      - 541
                      - 376
                      - 461
                      - 793
                      - 665
                      - 499
                      - 524
                      - 525
                      - 475
                      - 461
                      - 480
                      - 556
                    graph_revenue:
                      - 12721
                      - 15405
                      - 16942
                      - 18640
                      - 5808
                      - 29872
                      - 12565
                      - 12604
                      - 24544
                      - 19903
                      - 17736
                      - 11385
                      - 27972
                      - 27869
                      - 23064
                      - 13487
                      - 22686
                      - 2040
                      - 22577
                      - 14841
                      - 34632
                      - 30000
                      - 9038
                      - 34754
                      - 40853
                      - 52437
                      - 27576
                      - 28768
                      - 52435
                      - 32527
                summary:
                  graph:
                    - 152
                    - 128
                    - 121
                    - 147
                    - 122
                    - 197
                    - 187
                    - 157
                    - 185
                    - 199
                    - 219
                    - 211
                    - 217
                    - 197
                    - 155
                    - 193
                    - 228
                    - 170
                    - 189
                    - 195
                    - 188
                    - 158
                    - 175
                    - 189
                    - 198
                    - 171
                    - 186
                    - 170
                    - 167
                    - 197
                  graph_revenue:
                    - 19731719
                    - 20036603
                    - 20049981
                    - 21860359
                    - 20161945
                    - 21456713
                    - 20629659
                    - 21348746
                    - 20502398
                    - 19914638
                    - 19044937
                    - 17456793
                    - 22428024
                    - 19419840
                    - 20625962
                    - 21810711
                    - 21458910
                    - 21390640
                    - 21850831
                    - 22133729
                    - 22458589
                    - 24229292
                    - 24461782
                    - 24818557
                    - 23086344
                    - 22986686
                    - 23371630
                    - 23947394
                    - 24620611
                    - 25329730
  /seller/trends:
    post:
      summary: Тренды продавца
      tags:
        - seller
      parameters:
        - name: path
          in: query
          description: Id продавца
          required: false
          example: 7
          schema:
            type: integer
        - name: trends_by
          in: query
          description: Период трендов (день / неделя / месяц)
          required: false
          example: week
          schema:
            type: string
        - name: year
          in: query
          description: Год
          required: false
          example: 2025
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - date: '2020-02-01'
                  items: 3387
                  items_with_sells: 621
                  brands: 42
                  brands_with_sells: 30
                  sellers: 1
                  sellers_with_sells: 1
                  sales: 972
                  revenue: 1581405
                  product_revenue: 2547
                  average_order_value: 1627
                  end_date: '2020-02-29'
                  label_date: 2020-02
                - date: '2020-03-01'
                  items: 3184
                  items_with_sells: 810
                  brands: 47
                  brands_with_sells: 34
                  sellers: 1
                  sellers_with_sells: 1
                  sales: 1308
                  revenue: 2093602
                  product_revenue: 2585
                  average_order_value: 1601
                  end_date: '2020-03-31'
                  label_date: 2020-03
  /seller/by_date:
    post:
      summary: Показатели за период по продавцу
      tags:
        - seller
      parameters:
        - name: path
          in: query
          description: Id продавца
          required: false
          example: 7
          schema:
            type: integer
        - name: groupBy
          in: query
          description: Период (day / week / month / quarter)
          required: false
          example: week
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - period: '2025-07-20'
                  balance: 987259
                  balance_price: 8711665952
                  avg_price: 7342.99
                  items: 152160
                  items_with_sells: 3339
                  brands: 7901
                  brands_with_sells: 818
                  sellers: 7461
                  sellers_with_sells: 829
                  sales: 7177
                  revenue: 40693538
                  comments: 33.34
                  rating: 4.64
                  avg_sale_price: 5669.99
                - period: '2025-07-19'
                  balance: 984248
                  balance_price: 8681202149
                  avg_price: 7338.01
                  items: 152106
                  items_with_sells: 2917
                  brands: 7903
                  brands_with_sells: 767
                  sellers: 7462
                  sellers_with_sells: 769
                  sales: 5690
                  revenue: 34244128
                  comments: 33.33
                  rating: 4.64
                  avg_sale_price: 6018.3
                - period: '2025-07-18'
                  balance: 989134
                  balance_price: 8528299459
                  avg_price: 7297.34
                  items: 152070
                  items_with_sells: 2812
                  brands: 7904
                  brands_with_sells: 760
                  sellers: 7464
                  sellers_with_sells: 779
                  sales: 5634
                  revenue: 65263547
                  comments: 32.98
                  rating: 4.64
                  avg_sale_price: 11583.87
  /seller/price_segmentation:
    post:
      summary: Ценовая сегментация продавца
      tags:
        - seller
      parameters:
        - name: path
          in: query
          description: Id продавца
          required: false
          example: 7
          schema:
            type: integer
        - name: minPrice
          in: query
          description: Минимальная цена
          required: false
          example: 1000
          schema:
            type: integer
        - name: maxPrice
          in: query
          description: Максимальная цена
          required: false
          example: 20000
          schema:
            type: integer
        - name: priceStep
          in: query
          description: Шаг ценового диапазона
          required: false
          example: 1000
          schema:
            type: integer
        - name: segmentsCnt
          in: query
          description: Кол-во сегментов
          required: false
          example: 10
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - range: 50-1155
                  items: 6120
                  items_with_sells: 149
                  brands: 1356
                  brands_with_sells: 74
                  sellers: 1268
                  sellers_with_sells: 73
                  revenue: 1435646
                  sales: 1299
                  product_revenue: 9635.21
                  min_range_price: 50
                  max_range_price: 1155
                  revenue_potential: 6170274.86
                  lost_profit: 4754366.86
                  lost_profit_percent: 77.05
                - range: 1155-1576
                  items: 6119
                  items_with_sells: 370
                  brands: 1554
                  brands_with_sells: 165
                  sellers: 1479
                  sellers_with_sells: 168
                  revenue: 5522225
                  sales: 3686
                  product_revenue: 14924.93
                  min_range_price: 1156
                  max_range_price: 1576
                  revenue_potential: 17412867.5
                  lost_profit: 11934997.5
                  lost_profit_percent: 68.54
  /seller/keywords:
    post:
      summary: Запросы по продавцу
      tags:
        - seller
      parameters:
        - name: path
          in: query
          description: Id продавца
          required: false
          example: 7
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по поисковым запросам
          content:
            application/json:
              example:
                queries:
                  - word: игрушки для собак
                    count: 9735
                    wb_count: 99158
                    query_cluster: игрушки для собак
                    items_count: 76
                  - word: игрушка для собак
                    count: 6155
                    wb_count: 38877
                    query_cluster: игрушки для собак
                    items_count: 76
                words:
                  - count: 2856
                    word: собак
                    words:
                      - собак
                      - собаки
                      - собака
                      - собаке
                      - собаку
                      - собакам
                      - собакой
                      - собаками
                    keys:
                      - word: игрушки для собак
                        count: 9735
                        wb_count: 99158
                        query_cluster: игрушки для собак
                        items_count: 76
                      - word: игрушка для собак
                        count: 6155
                        wb_count: 38877
                        query_cluster: игрушки для собак
                        items_count: 76
                    mp: 0
                    keys_count_sum: 6386
                    keys_wb_count_sum: 66145
                  - count: 280
                    word: крупных
                    words:
                      - крупных
                      - крупной
                      - крупные
                      - крупная
                    keys:
                      - word: игрушки для щенков крупных пород
                        count: 116
                        wb_count: 533
                        query_cluster: игрушки для щенков крупных пород
                        items_count: 43
                      - word: игрушки для собак крупных пород
                        count: 2465
                        wb_count: 10255
                        query_cluster: игрушки для собак крупных пород
                        items_count: 42
                    mp: 0
                    keys_count_sum: 10135
                    keys_wb_count_sum: 62429
  /seller/geography:
    get:
      summary: География продавца
      tags:
        - seller
      parameters:
        - name: path
          in: query
          description: Id продавца
          required: false
          example: 7
          schema:
            type: integer
        - name: date
          in: query
          description: Дата в формате YYYY-MM
          required: true
          example: 2025-01
          schema:
            type: string
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
      responses:
        '200':
          description: Данные по регионам и складам
          content:
            application/json:
              example:
                period: 2025-07
                region_data:
                  - region: Москва, МО и Дальние регионы
                    sales: 702831
                    count: 24799730
                    revenue: 1535922940
                    sales_percent: 32.12
                    count_percent: 38.32
                    revenue_percent: 32.34
                  - region: Санкт-Петербург и СЗО
                    sales: 311168
                    count: 9137892
                    revenue: 684599487
                    sales_percent: 14.22
                    count_percent: 14.12
                    revenue_percent: 14.42
                storage_data:
                  - name: ПУШКИНО_1_РФЦ
                    region: Москва, МО и Дальние регионы
                    sales: 106563
                    count: 4399210
                    revenue: 223395038
                    sales_percent: 4.87
                    count_percent: 6.8
                    revenue_percent: 4.7
                  - name: СПБ_БУГРЫ_РФЦ
                    region: Санкт-Петербург и СЗО
                    sales: 120361
                    count: 3772210
                    revenue: 267257984
                    sales_percent: 5.5
                    count_percent: 5.83
                    revenue_percent: 5.63
  /seller/compare:
    post:
      summary: Сравнение периодов по товарам продавца
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - seller
      parameters:
        - name: path
          in: query
          description: Id продавца
          required: false
          example: 7
          schema:
            type: integer
        - name: d11
          in: query
          description: Дата начала первого периода
          required: true
          example: '2025-01-01'
          schema:
            type: string
        - name: d12
          in: query
          description: Дата конца первого периода
          required: true
          example: '2025-02-01'
          schema:
            type: string
        - name: d21
          in: query
          description: Дата начала второго периода
          required: true
          example: '2025-02-01'
          schema:
            type: string
        - name: d22
          in: query
          description: Дата конца второго периода
          required: true
          example: '2025-03-01'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по товарам за выбранные периоды
          content:
            application/json:
              example:
                startRow: 0
                endRow: 200
                total: 10043800
                data:
                  - id: 1592320262
                    name: Футболка GoldenCate-I внуки
                    brand: GoldenCate-I
                    seller: GoldenCate-I
                    seller_id: 1882627
                    sales_1: 0
                    sales_2: 0
                    revenue_1: 0
                    revenue_2: 0
                    days_in_stock_1: 0
                    days_in_stock_2: 0
                    price_1: 1522
                    price_2: 1582
                    avg_price_1: 2179.17
                    avg_price_2: 1612.57
                    sales_diff: 0
                    revenue_diff: 0
                    days_in_stock_diff: 0
                    price_diff: 60
                    avg_price_diff: -566.6
                    thumb: https://cdn1.ozone.ru/s3/multimedia-1-n/7043160515.jpg
                  - id: 640524872
                    name: Платье пляжное
                    brand: ''
                    seller: самый быстрый, лучший, дешевый
                    seller_id: 281568
                    sales_1: 0
                    sales_2: 0
                    revenue_1: 0
                    revenue_2: 0
                    days_in_stock_1: 0
                    days_in_stock_2: 0
                    price_1: 706
                    price_2: 740
                    avg_price_1: 711.17
                    avg_price_2: 707.87
                    sales_diff: 0
                    revenue_diff: 0
                    days_in_stock_diff: 0
                    price_diff: 34
                    avg_price_diff: -3.3
                    thumb: https://cdn1.ozone.ru/s3/multimedia-t/6093784529.jpg
                summary:
                  sales_1: 20551030
                  sales_2: 22862898
                  revenue_1: 30366243940
                  revenue_2: 36120196612
                  sales_diff: 2311868
                  revenue_diff: 5753952672
  /seller/feedback/comments:
    post:
      summary: Отзывы на товары продавца
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - seller
      parameters:
        - name: path
          in: query
          description: ID продавца
          required: true
          example: 65146
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Отзывы пользователей(я)
          content:
            application/json:
              example:
                startRow: 0
                endRow: 200
                total: 2673
                data:
                  - id: 1916581720
                    name: Купальник слитный SVYATAYA
                    thumb: https://ir.ozone.ru/s3/multimedia-1-q/7385504750.jpg
                    seller_name: СВЯТАЯ
                    seller_id: 142329
                    brand_name: SVYATAYA
                    date: '2025-11-25'
                    valuation: 3
                    likes: 0
                    text: Не держится на груди
                  - id: 1916584186
                    name: Купальник слитный SVYATAYA
                    thumb: https://ir.ozone.ru/s3/multimedia-1-q/7385504750.jpg
                    seller_name: СВЯТАЯ
                    seller_id: 142329
                    brand_name: SVYATAYA
                    date: '2025-11-25'
                    valuation: 5
                    likes: 0
                    text: ''
                  - id: 1916584899
                    name: Купальник слитный SVYATAYA
                    thumb: https://ir.ozone.ru/s3/multimedia-1-f/7385504631.jpg
                    seller_name: СВЯТАЯ
                    seller_id: 142329
                    brand_name: SVYATAYA
                    date: '2025-11-20'
                    valuation: 5
                    likes: 0
                    text: купальник идеалный
  /seller/feedback/comments/stats:
    get:
      summary: Статистика по отзывам на товары продавца
      tags:
        - seller
      parameters:
        - name: path
          in: query
          description: ID продавца
          required: true
          example: 65146
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
      responses:
        '200':
          description: Статистика по отзывам
          content:
            application/json:
              example:
                count: 127154
                count_negative: 5812
                negative_percent: 4.57
                avg_valuation: 4.8
  /seller/feedback/comments/graph:
    get:
      summary: Статистика по отзывам по дням на товары продавца
      tags:
        - seller
      parameters:
        - name: path
          in: query
          description: ID продавца
          required: true
          example: 65146
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
      responses:
        '200':
          description: Статистика по дням
          content:
            application/json:
              example:
                - date: '2025-05-27'
                  count: 2055
                  count_negative: 607
                  count_with_text: 609
                  count_negative_with_text: 93
                  avg_valuation: 4.03
                - date: '2025-05-28'
                  count: 2169
                  count_negative: 695
                  count_with_text: 670
                  count_negative_with_text: 105
                  avg_valuation: 3.92
                - date: '2025-05-29'
                  count: 2029
                  count_negative: 714
                  count_with_text: 620
                  count_negative_with_text: 124
                  avg_valuation: 3.85
  /seller/feedback/comments/ai_recommendations:
    get:
      summary: AI рекомендации по отзывам на товары продавца
      tags:
        - seller
      parameters:
        - name: path
          in: query
          description: ID продавца
          required: true
          example: 65146
          schema:
            type: integer
      responses:
        '200':
          description: AI рекомендации
          content:
            application/json:
              example:
                id: 19b36ac20ac2970db60f113c23c27a76
                status: 10
                data:
                  pain_points:
                    - topic: Просвечивание ткани
                      description: >-
                        Покупатели жалуются, что материал топа слишком тонкий и
                        сильно просвечивает, что делает изделие непригодным для
                        ношения без подкладки.
                      solution: >-
                        Использовать более плотную или многослойную ткань,
                        протестировать материал на просвечивание при разных
                        условиях освещения.
                    - topic: Несоответствие цены качеству
                      description: >-
                        Клиенты отмечают, что качество изделия не оправдывает
                        его стоимости, что снижает доверие к бренду.
                      solution: >-
                        Провести анализ себестоимости и уровня восприятия цены,
                        возможно, скорректировать цену или повысить качество
                        материалов и пошива.
                    - topic: Разочарование ожиданий
                      description: >-
                        Отзыв с низкой оценкой указывает, что товар не
                        соответствует ожиданиям пользователя по изображению или
                        описанию.
                      solution: >-
                        Пересмотреть описание и фотографии товара, добавить
                        реальные фото на модели при разном освещении и в разных
                        позах.
                  advantages:
                    - topic: Современный дизайн
                      description: >-
                        Из отзыва следует, что изделие привлекательно визуально
                        (есть интерес к покупке топа несмотря на недостатки).
                      solution: >-
                        Сохранить стиль, но усилить функциональность за счёт
                        выбора качественных материалов.
                    - topic: Лёгкость материала
                      description: >-
                        Ткань, вероятно, тонкая и приятная на ощупь, что оценят
                        в жаркое время года.
                      solution: >-
                        Оставить лёгкость как характеристику, но добавить
                        плотную подкладку или продумать двойной слой в зонах,
                        где просвечивание критично.
                    - topic: Минималистичный стиль
                      description: >-
                        Топ, судя по отзыву, имеет простой дизайн, что
                        соответствует модным трендам.
                      solution: >-
                        Подчеркнуть минимализм в маркетинговых материалах, делая
                        акцент на универсальности и сочетании с другими вещами.
  /brand/list:
    post:
      summary: Список брендов
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - brand
      parameters:
        - name: type
          in: query
          description: Необходимы тип данных (csv, xls, json по умолчанию)
          required: false
          example: json
          schema:
            type: string
        - name: date
          in: query
          description: Дата
          required: false
          example: '2025-02-01'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: onlyFavorite
          in: query
          description: Только избранные
          required: false
          example: 1
          schema:
            type: boolean
        - name: search
          in: query
          description: Поисковый запрос
          required: false
          example: Святая
          schema:
            type: string
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список предметов
          content:
            application/json:
              example:
                startRow: 0
                endRow: 100
                total: 7353
                data:
                  - name: weissgauff
                    position: 1
                    first_date: '2020-01-04'
                    niches: 51
                    niches_with_sells: 41
                    niches_with_sells_percent: 80
                    items: 3336
                    items_with_count: 614
                    items_with_sells: 791
                    items_with_sells_percent: 24
                    live_items: 820
                    items_new: 163
                    items_new_percent: 5
                    items_new_with_sells: 37
                    items_new_with_sells_percent: 1
                    sellers: 43
                    sellers_with_sells: 6
                    sellers_with_sells_percent: 14
                    sales: 83170
                    balance: 143398
                    revenue: 1528916312
                    revenue_potential: 1813139044.14
                    lost_profit: 284222732.14
                    lost_profit_percent: 16
                    min_price: 207
                    min_price_with_sells: 258
                    max_price: 206408
                    max_price_with_sells: 146152
                    avg_price: 28520.86
                    avg_price_with_sells: 26747.63
                    median_price: 22221
                    median_price_with_sells: 21406
                    avg_rating: 2.47
                    avg_rating_with_sells: 4.55
                    turnover_in_days: 17
                    frozen_stocks: 67117
                    frozen_stocks_cost: 1192656749
                    frozen_stocks_percent: 47
                    sells_on_wb: 1
                    favorite: false
                  - name: eurolux
                    position: 2
                    first_date: '2020-01-04'
                    niches: 211
                    niches_with_sells: 120
                    niches_with_sells_percent: 57
                    items: 23501
                    items_with_count: 2013
                    items_with_sells: 2104
                    items_with_sells_percent: 9
                    live_items: 2373
                    items_new: 621
                    items_new_percent: 3
                    items_new_with_sells: 49
                    items_new_with_sells_percent: 0
                    sellers: 474
                    sellers_with_sells: 49
                    sellers_with_sells_percent: 10
                    sales: 143789
                    balance: 246059
                    revenue: 973030627
                    revenue_potential: 1159053930.8
                    lost_profit: 186023303.8
                    lost_profit_percent: 16
                    min_price: 45
                    min_price_with_sells: 123
                    max_price: 426607
                    max_price_with_sells: 79544
                    avg_price: 16298.36
                    avg_price_with_sells: 8936.38
                    median_price: 7612.5
                    median_price_with_sells: 5767.5
                    avg_rating: 2.36
                    avg_rating_with_sells: 4.71
                    turnover_in_days: 14
                    frozen_stocks: 111857
                    frozen_stocks_cost: 748545638
                    frozen_stocks_percent: 45
                    sells_on_wb: 1
                    favorite: false
  /brand/info:
    get:
      summary: Информация о бренде
      tags:
        - brand
      parameters:
        - name: path
          in: query
          description: Название бренда
          required: true
          example: Adidas
          schema:
            type: string
      responses:
        '200':
          description: Бренд
          content:
            application/json:
              example:
                name: adidas
                sells_on_wb: 1
  /brand/items:
    post:
      summary: Товары бренда
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - brand
      parameters:
        - name: path
          in: query
          description: Название бренда
          required: true
          example: Adidas
          schema:
            type: string
        - name: type
          in: query
          description: Необходимы тип данных (csv, json по умолчанию)
          required: false
          example: json
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список товаров
          content:
            application/json:
              example:
                startRow: 0
                endRow: 200
                total: 9755
                data:
                  - id: 3137867761
                    name: >-
                      Xiaomi Аэрогриль электрический Smart Air Fryer, 6.5л,
                      MAF10, белый
                    url: https://www.ozon.ru/context/detail/id/3137867761/
                    thumb: https://ir.ozone.ru/s3/multimedia-1-s/d100/8492959288.jpg
                    thumb_middle: https://ir.ozone.ru/s3/multimedia-1-s/d250/8492959288.jpg
                    niche_id: 10550
                    niche: Бытовая техника/Техника для кухни/Печи и грили/Аэрогрили
                    brand: Xiaomi
                    seller: МИЭНТЕК
                    seller_id: 3628678
                    category: Бытовая техника/Техника для кухни/Печи и грили/Аэрогрили
                    category_position: 118
                    final_price: 12448
                    final_price_average: 11933.56
                    final_price_min: 10874
                    final_price_max: 14257
                    final_price_median: 12180.5
                    start_price: 40000
                    ozon_card_price: 11415
                    balance: 2679
                    balance_fbs: 0
                    days_in_stock: 30
                    days_in_site: 56
                    sales: 3959
                    sales_per_day_average: 131.97
                    sales_per_comments: 2.73
                    revenue: 47244959
                    days_with_sales: 30
                    average_if_in_stock: 131.97
                    revenue_potential: 47244959
                    revenue_average: 1574831.97
                    lost_profit: 0
                    lost_profit_percent: 0
                    percent_from_revenue: 3.26
                    comments: 1804
                    comments_for_period: 1450
                    rating: 4.9
                    is_fbs: 0
                    sku_first_date: '2025-11-27'
                    picscount: 6
                    hasvideo: 0
                    turnover_days: 20.3
                    turnover_once: 1.88
                    frozen_stocks: 0
                    frozen_stocks_cost: 0
                    frozen_stocks_percent: 0
                    warehouses_count: 12
                    name_length: 66
                    groups: []
                    category_graph:
                      - 3
                      - 3
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                    search_words_count_graph:
                      - 399
                      - 415
                      - 401
                      - 424
                      - 419
                      - 427
                      - 445
                      - 455
                      - 464
                      - 432
                      - 408
                      - 451
                      - 441
                      - 408
                      - 369
                      - 401
                      - 367
                      - 378
                      - 364
                      - 393
                      - 373
                      - 355
                      - 382
                      - 366
                      - 417
                      - 442
                      - 440
                      - 409
                      - 394
                      - 355
                    graph:
                      - 288
                      - 245
                      - 193
                      - 264
                      - 284
                      - 221
                      - 200
                      - 82
                      - 102
                      - 160
                      - 181
                      - 212
                      - 166
                      - 145
                      - 160
                      - 65
                      - 52
                      - 65
                      - 57
                      - 65
                      - 67
                      - 65
                      - 70
                      - 93
                      - 74
                      - 77
                      - 88
                      - 81
                      - 80
                      - 57
                    stocks_graph:
                      - 1525
                      - 1338
                      - 2146
                      - 2385
                      - 2109
                      - 2013
                      - 1824
                      - 1746
                      - 1647
                      - 1581
                      - 1404
                      - 1197
                      - 1045
                      - 936
                      - 818
                      - 783
                      - 758
                      - 714
                      - 679
                      - 634
                      - 586
                      - 535
                      - 2090
                      - 2552
                      - 2868
                      - 2931
                      - 2855
                      - 2792
                      - 2727
                      - 2679
                    price_graph:
                      - 10874
                      - 11150
                      - 11628
                      - 11598
                      - 12185
                      - 11870
                      - 11796
                      - 11796
                      - 11531
                      - 11415
                      - 11178
                      - 11183
                      - 12107
                      - 11484
                      - 11976
                      - 14257
                      - 13174
                      - 13593
                      - 13835
                      - 13225
                      - 13275
                      - 12919
                      - 13311
                      - 12176
                      - 12799
                      - 12837
                      - 12544
                      - 12462
                      - 12278
                      - 12448
                    revenue_graph:
                      - 3131712
                      - 2731750
                      - 2244204
                      - 3061872
                      - 3460540
                      - 2623270
                      - 2359200
                      - 967272
                      - 1176162
                      - 1826400
                      - 2023218
                      - 2370796
                      - 2009762
                      - 1665180
                      - 1916160
                      - 926705
                      - 685048
                      - 883545
                      - 788595
                      - 859625
                      - 889425
                      - 839735
                      - 931770
                      - 1132368
                      - 947126
                      - 988449
                      - 1103872
                      - 1009422
                      - 982240
                      - 709536
                    rating_graph:
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                    search_position_graph:
                      - 41
                      - 27
                      - 41
                      - 63
                      - 43
                      - 80
                      - 72
                      - 91
                      - 96
                      - 96
                      - 16
                      - 103
                      - 62
                      - 37
                      - 35
                      - 100
                      - 58
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
  /brand/niches:
    post:
      summary: Предметы (ниши) бренда
      tags:
        - brand
      parameters:
        - name: path
          in: query
          description: Название бренда
          required: true
          example: Xiaomi
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по нишам
          content:
            application/json:
              example:
                - niche_id: 15502
                  niche: Электроника/Телефоны и смарт-часы/Смартфоны
                  sales: 7642
                  balance: 7693
                  revenue: 177234983
                  revenue_potential: 301509391.13
                  revenue_per_items_average: 5913.35
                  revenue_per_items_with_sells_average: 305577.56
                  lost_profit: 124274408.13
                  lost_profit_percent: 41.22
                  items: 29972
                  items_with_sells: 580
                  items_with_sells_percent: 1.94
                  items_with_count: 532
                  items_with_count_percent: 1.77
                  sellers: 535
                  sellers_with_sells: 57
                  sellers_with_sells_percent: 10.65
                  brands: 1
                  brands_with_sells: 1
                  brands_with_sells_percent: 100
                  sales_per_items_average: 0.25
                  sales_per_items_with_sells_average: 13.18
                  avg_price: 31800.98
                  avg_price_with_sells: 27274.69
                  min_price: 20
                  min_price_with_sells: 3297
                  max_price: 999999
                  max_price_with_sells: 135018
                  median_price: 24621.5
                  median_price_with_sells: 24105
                  rating: 477.08
                  rating_with_sells: 488.03
                  comments: 86.82
                  live_items: 777
                  turnover_in_days: 30.2
                  revenue_percent: 13.65
                  graph:
                    - 213
                    - 250
                    - 264
                    - 284
                    - 238
                    - 230
                    - 245
                    - 231
                    - 267
                    - 193
                    - 166
                    - 165
                    - 177
                    - 198
                    - 228
                    - 325
                    - 374
                    - 310
                    - 251
                    - 263
                    - 352
                    - 245
                    - 248
                    - 203
                    - 264
                    - 300
                    - 289
                    - 273
                    - 314
                    - 282
                - niche_id: 15738
                  niche: Электроника/Компьютеры и периферия/Мониторы
                  sales: 8509
                  balance: 5570
                  revenue: 125859573
                  revenue_potential: 162773636.89
                  revenue_per_items_average: 79306.6
                  revenue_per_items_with_sells_average: 1187354.46
                  lost_profit: 36914063.89
                  lost_profit_percent: 22.68
                  items: 1587
                  items_with_sells: 106
                  items_with_sells_percent: 6.68
                  items_with_count: 90
                  items_with_count_percent: 5.67
                  sellers: 203
                  sellers_with_sells: 30
                  sellers_with_sells_percent: 14.78
                  brands: 1
                  brands_with_sells: 1
                  brands_with_sells_percent: 100
                  sales_per_items_average: 5.36
                  sales_per_items_with_sells_average: 80.27
                  avg_price: 20468.26
                  avg_price_with_sells: 18177.39
                  min_price: 202
                  min_price_with_sells: 6072
                  max_price: 276675
                  max_price_with_sells: 80650
                  median_price: 16347
                  median_price_with_sells: 14452.5
                  rating: 486.27
                  rating_with_sells: 488.53
                  comments: 403.81
                  live_items: 126
                  turnover_in_days: 19.64
                  revenue_percent: 9.69
                  graph:
                    - 224
                    - 263
                    - 272
                    - 322
                    - 332
                    - 271
                    - 227
                    - 298
                    - 354
                    - 340
                    - 264
                    - 318
                    - 270
                    - 229
                    - 249
                    - 291
                    - 277
                    - 281
                    - 268
                    - 279
                    - 263
                    - 292
                    - 307
                    - 323
                    - 318
                    - 326
                    - 273
                    - 220
                    - 240
                    - 318
  /brand/categories:
    post:
      summary: Категории бренда
      tags:
        - brand
      parameters:
        - name: path
          in: query
          description: Название бренда
          required: true
          example: Xiaomi
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список категорий
          content:
            application/json:
              example:
                - name: >-
                    Ozon fresh/Другие товары/Электроника/Телефоны и
                    смарт-часы/Смартфоны
                  items: 24421
                  items_with_sells: 577
                  items_with_sells_percent: 2.36
                  brands: 1
                  brands_with_sells: 1
                  brands_with_sells_percent: 100
                  sellers: 475
                  sellers_with_sells: 55
                  sellers_with_sells_percent: 11.58
                  sales_per_items_average: 0.31
                  sales_per_items_with_sells_average: 13.24
                  sales: 7637
                  revenue: 177093515
                  revenue_per_items_average: 7251.69
                  revenue_per_items_with_sells_average: 306921.17
                  avg_price: 31282.01
                  comments: 91.71
                  rating: 4.78
                - name: Электроника/Компьютеры и периферия/Мониторы
                  items: 1587
                  items_with_sells: 106
                  items_with_sells_percent: 6.68
                  brands: 1
                  brands_with_sells: 1
                  brands_with_sells_percent: 100
                  sellers: 203
                  sellers_with_sells: 30
                  sellers_with_sells_percent: 14.78
                  sales_per_items_average: 5.36
                  sales_per_items_with_sells_average: 80.27
                  sales: 8509
                  revenue: 125859573
                  revenue_per_items_average: 79306.6
                  revenue_per_items_with_sells_average: 1187354.46
                  avg_price: 20160.09
                  comments: 410.23
                  rating: 4.87
  /brand/sellers:
    post:
      summary: Продавцы бренда
      tags:
        - brand
      parameters:
        - name: path
          in: query
          description: Название бренда
          required: true
          example: Xiaomi
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список продавцов
          content:
            application/json:
              example:
                data:
                  - position: 1
                    id: 7984
                    name: ELECTRONIC ECOSYSTEMS
                    ogrn: '1177746271196'
                    items: 280
                    items_with_sells: 229
                    items_with_sells_percent: 81.79
                    brands: 1
                    brands_with_sells: 1
                    brands_with_sells_percent: 100
                    sales: 5324
                    revenue: 72671285
                    sales_per_items_average: 19.01
                    sales_per_items_with_sells_average: 23.25
                    revenue_per_items_average: 259540.3
                    revenue_per_items_with_sells_average: 317341.86
                    balance: 4049
                    balance_price: 71176295
                    avg_price: 14268.06
                    rating: 485.27
                    comments: 399.69
                    graph:
                      - 182
                      - 147
                      - 133
                      - 204
                      - 257
                      - 198
                      - 175
                      - 189
                      - 220
                      - 194
                      - 154
                      - 160
                      - 151
                      - 171
                      - 214
                      - 207
                      - 187
                      - 158
                      - 160
                      - 223
                      - 344
                      - 169
                      - 89
                      - 113
                      - 158
                      - 144
                      - 159
                      - 164
                      - 171
                      - 129
                    graph_revenue:
                      - 12721
                      - 15405
                      - 16942
                      - 18640
                      - 5808
                      - 29872
                      - 12565
                      - 12604
                      - 24544
                      - 19903
                      - 17736
                      - 11385
                      - 27972
                      - 27869
                      - 23064
                      - 13487
                      - 22686
                      - 2040
                      - 22577
                      - 14841
                      - 34632
                      - 30000
                      - 9038
                      - 34754
                      - 40853
                      - 52437
                      - 27576
                      - 28768
                      - 52435
                      - 32527
                summary:
                  graph:
                    - 152
                    - 128
                    - 121
                    - 147
                    - 122
                    - 197
                    - 187
                    - 157
                    - 185
                    - 199
                    - 219
                    - 211
                    - 217
                    - 197
                    - 155
                    - 193
                    - 228
                    - 170
                    - 189
                    - 195
                    - 188
                    - 158
                    - 175
                    - 189
                    - 198
                    - 171
                    - 186
                    - 170
                    - 167
                    - 197
                  graph_revenue:
                    - 19731719
                    - 20036603
                    - 20049981
                    - 21860359
                    - 20161945
                    - 21456713
                    - 20629659
                    - 21348746
                    - 20502398
                    - 19914638
                    - 19044937
                    - 17456793
                    - 22428024
                    - 19419840
                    - 20625962
                    - 21810711
                    - 21458910
                    - 21390640
                    - 21850831
                    - 22133729
                    - 22458589
                    - 24229292
                    - 24461782
                    - 24818557
                    - 23086344
                    - 22986686
                    - 23371630
                    - 23947394
                    - 24620611
                    - 25329730
  /brand/trends:
    post:
      summary: Тренды бренда
      tags:
        - brand
      parameters:
        - name: path
          in: query
          description: Название бренда
          required: true
          example: Xiaomi
          schema:
            type: string
        - name: trends_by
          in: query
          description: Период трендов (день / неделя / месяц)
          required: false
          example: week
          schema:
            type: string
        - name: year
          in: query
          description: Год
          required: false
          example: 2025
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - date: '2020-02-01'
                  items: 4940
                  items_with_sells: 309
                  brands: 1
                  brands_with_sells: 1
                  sellers: 42
                  sellers_with_sells: 15
                  sales: 6251
                  revenue: 21123027
                  product_revenue: 68359
                  average_order_value: 3379
                  end_date: '2020-02-29'
                  label_date: 2020-02
                - date: '2020-03-01'
                  items: 4009
                  items_with_sells: 311
                  brands: 1
                  brands_with_sells: 1
                  sellers: 45
                  sellers_with_sells: 14
                  sales: 4828
                  revenue: 20158053
                  product_revenue: 64817
                  average_order_value: 4175
                  end_date: '2020-03-31'
                  label_date: 2020-03
  /brand/by_date:
    post:
      summary: Показатели за период по бренду
      tags:
        - brand
      parameters:
        - name: path
          in: query
          description: Название бренда
          required: true
          example: Xiaomi
          schema:
            type: string
        - name: groupBy
          in: query
          description: Период (day / week / month / quarter)
          required: false
          example: week
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - period: '2025-08-05'
                  balance: 285480
                  balance_price: 1217577625
                  avg_price: 13691.02
                  items: 103302
                  items_with_sells: 1590
                  brands: 1
                  brands_with_sells: 1
                  sellers: 6621
                  sellers_with_sells: 243
                  sales: 12589
                  revenue: 46192917
                  comments: 268.26
                  rating: 471.08
                  avg_sale_price: 3669.31
                - period: '2025-08-04'
                  balance: 288102
                  balance_price: 1260534469
                  avg_price: 14021.47
                  items: 103439
                  items_with_sells: 1510
                  brands: 1
                  brands_with_sells: 1
                  sellers: 6596
                  sellers_with_sells: 234
                  sales: 11074
                  revenue: 43143478
                  comments: 268.26
                  rating: 471.23
                  avg_sale_price: 3895.93
  /brand/price_segmentation:
    post:
      summary: Ценовая сегментация бренда
      tags:
        - brand
      parameters:
        - name: path
          in: query
          description: Название бренда
          required: true
          example: Xiaomi
          schema:
            type: string
        - name: minPrice
          in: query
          description: Минимальная цена
          required: false
          example: 1000
          schema:
            type: integer
        - name: maxPrice
          in: query
          description: Максимальная цена
          required: false
          example: 20000
          schema:
            type: integer
        - name: priceStep
          in: query
          description: Шаг ценового диапазона
          required: false
          example: 1000
          schema:
            type: integer
        - name: segmentsCnt
          in: query
          description: Кол-во сегментов
          required: false
          example: 10
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - range: 2-288
                  items: 5911
                  items_with_sells: 10
                  brands: 1
                  brands_with_sells: 1
                  sellers: 491
                  sellers_with_sells: 10
                  revenue: 110919
                  sales: 496
                  product_revenue: 11091.9
                  min_range_price: 2
                  max_range_price: 288
                  revenue_potential: 118582.88
                  lost_profit: 7663.88
                  lost_profit_percent: 6.46
                - range: 288-598
                  items: 6139
                  items_with_sells: 124
                  brands: 1
                  brands_with_sells: 1
                  sellers: 1187
                  sellers_with_sells: 60
                  revenue: 7403380
                  sales: 15622
                  product_revenue: 59704.68
                  min_range_price: 289
                  max_range_price: 598
                  revenue_potential: 8406237.38
                  lost_profit: 1003283.38
                  lost_profit_percent: 11.93
  /brand/keywords:
    post:
      summary: Запросы по бренду
      tags:
        - brand
      parameters:
        - name: path
          in: query
          description: Название бренда
          required: true
          example: Xiaomi
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по поисковым запросам
          content:
            application/json:
              example:
                queries:
                  - word: xiaomi 14 global
                    count: 463
                    wb_count: 0
                    items_count: 649
                  - word: 14 т xiaomi смартфон
                    count: 89
                    wb_count: 0
                    items_count: 648
                words:
                  - count: 2550
                    word: xiaomi
                    words:
                      - xiaomi
                    keys:
                      - word: xiaomi 14 global
                        count: 463
                        wb_count: 0
                        items_count: 649
                      - word: 14 т xiaomi смартфон
                        count: 89
                        wb_count: 0
                        items_count: 648
                    keys_count_sum: 1495890
                    keys_wb_count_sum: 874207
                    keys_items_count_sum: 631962
                  - count: 1356
                    word: смартфон
                    words:
                      - смартфон
                      - смартфоны
                      - смартфона
                    keys:
                      - word: 14 т xiaomi смартфон
                        count: 89
                        wb_count: 0
                        items_count: 648
                      - word: ксиоми 13 т смартфон
                        count: 105
                        wb_count: 0
                        items_count: 628
                    keys_count_sum: 10135
                    keys_wb_count_sum: 62429
                    keys_items_count_sum: 631962
  /brand/geography:
    get:
      summary: География бренда
      tags:
        - brand
      parameters:
        - name: path
          in: query
          description: Название бренда
          required: true
          example: Adidas
          schema:
            type: string
        - name: date
          in: query
          description: Дата в формате YYYY-MM
          required: true
          example: 2025-01
          schema:
            type: string
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
      responses:
        '200':
          description: Данные по регионам и складам
          content:
            application/json:
              example:
                period: 2025-07
                region_data:
                  - region: Москва, МО и Дальние регионы
                    sales: 702831
                    count: 24799730
                    revenue: 1535922940
                    sales_percent: 32.12
                    count_percent: 38.32
                    revenue_percent: 32.34
                  - region: Санкт-Петербург и СЗО
                    sales: 311168
                    count: 9137892
                    revenue: 684599487
                    sales_percent: 14.22
                    count_percent: 14.12
                    revenue_percent: 14.42
                storage_data:
                  - name: ПУШКИНО_1_РФЦ
                    region: Москва, МО и Дальние регионы
                    sales: 106563
                    count: 4399210
                    revenue: 223395038
                    sales_percent: 4.87
                    count_percent: 6.8
                    revenue_percent: 4.7
                  - name: СПБ_БУГРЫ_РФЦ
                    region: Санкт-Петербург и СЗО
                    sales: 120361
                    count: 3772210
                    revenue: 267257984
                    sales_percent: 5.5
                    count_percent: 5.83
                    revenue_percent: 5.63
  /brand/compare:
    post:
      summary: Сравнение периодов по товарам бренда
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - brand
      parameters:
        - name: path
          in: query
          description: Название бренда
          required: true
          example: Adidas
          schema:
            type: string
        - name: d11
          in: query
          description: Дата начала первого периода
          required: true
          example: '2025-01-01'
          schema:
            type: string
        - name: d12
          in: query
          description: Дата конца первого периода
          required: true
          example: '2025-02-01'
          schema:
            type: string
        - name: d21
          in: query
          description: Дата начала второго периода
          required: true
          example: '2025-02-01'
          schema:
            type: string
        - name: d22
          in: query
          description: Дата конца второго периода
          required: true
          example: '2025-03-01'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по товарам за выбранные периоды
          content:
            application/json:
              example:
                startRow: 0
                endRow: 200
                total: 10043800
                data:
                  - id: 1592320262
                    name: Футболка GoldenCate-I внуки
                    brand: GoldenCate-I
                    seller: GoldenCate-I
                    seller_id: 1882627
                    sales_1: 0
                    sales_2: 0
                    revenue_1: 0
                    revenue_2: 0
                    days_in_stock_1: 0
                    days_in_stock_2: 0
                    price_1: 1522
                    price_2: 1582
                    avg_price_1: 2179.17
                    avg_price_2: 1612.57
                    sales_diff: 0
                    revenue_diff: 0
                    days_in_stock_diff: 0
                    price_diff: 60
                    avg_price_diff: -566.6
                    thumb: https://cdn1.ozone.ru/s3/multimedia-1-n/7043160515.jpg
                  - id: 640524872
                    name: Платье пляжное
                    brand: ''
                    seller: самый быстрый, лучший, дешевый
                    seller_id: 281568
                    sales_1: 0
                    sales_2: 0
                    revenue_1: 0
                    revenue_2: 0
                    days_in_stock_1: 0
                    days_in_stock_2: 0
                    price_1: 706
                    price_2: 740
                    avg_price_1: 711.17
                    avg_price_2: 707.87
                    sales_diff: 0
                    revenue_diff: 0
                    days_in_stock_diff: 0
                    price_diff: 34
                    avg_price_diff: -3.3
                    thumb: https://cdn1.ozone.ru/s3/multimedia-t/6093784529.jpg
                summary:
                  sales_1: 20551030
                  sales_2: 22862898
                  revenue_1: 30366243940
                  revenue_2: 36120196612
                  sales_diff: 2311868
                  revenue_diff: 5753952672
  /brand/feedback/comments:
    post:
      summary: Отзывы на товары бренда
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - brand
      parameters:
        - name: path
          in: query
          description: Название бренда
          required: true
          example: Xiaomi
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Отзывы пользователей(я)
          content:
            application/json:
              example:
                startRow: 0
                endRow: 200
                total: 2673
                data:
                  - id: 1916581720
                    name: Купальник слитный SVYATAYA
                    thumb: https://ir.ozone.ru/s3/multimedia-1-q/7385504750.jpg
                    seller_name: СВЯТАЯ
                    seller_id: 142329
                    brand_name: SVYATAYA
                    date: '2025-11-25'
                    valuation: 3
                    likes: 0
                    text: Не держится на груди
                  - id: 1916584186
                    name: Купальник слитный SVYATAYA
                    thumb: https://ir.ozone.ru/s3/multimedia-1-q/7385504750.jpg
                    seller_name: СВЯТАЯ
                    seller_id: 142329
                    brand_name: SVYATAYA
                    date: '2025-11-25'
                    valuation: 5
                    likes: 0
                    text: ''
                  - id: 1916584899
                    name: Купальник слитный SVYATAYA
                    thumb: https://ir.ozone.ru/s3/multimedia-1-f/7385504631.jpg
                    seller_name: СВЯТАЯ
                    seller_id: 142329
                    brand_name: SVYATAYA
                    date: '2025-11-20'
                    valuation: 5
                    likes: 0
                    text: купальник идеалный
  /brand/feedback/comments/stats:
    get:
      summary: Статистика по отзывам на товары бренда
      tags:
        - brand
      parameters:
        - name: path
          in: query
          description: Название бренда
          required: true
          example: Xiaomi
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
      responses:
        '200':
          description: Статистика по отзывам
          content:
            application/json:
              example:
                count: 127154
                count_negative: 5812
                negative_percent: 4.57
                avg_valuation: 4.8
  /brand/feedback/comments/graph:
    get:
      summary: Статистика по отзывам по дням на товары бренда
      tags:
        - brand
      parameters:
        - name: path
          in: query
          description: Название бренда
          required: true
          example: Xiaomi
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
      responses:
        '200':
          description: Статистика по дням
          content:
            application/json:
              example:
                - date: '2025-11-04'
                  count: 3268
                  count_negative: 150
                  count_with_text: 1260
                  count_negative_with_text: 150
                  avg_valuation: 4.8
                - date: '2025-11-05'
                  count: 3491
                  count_negative: 162
                  count_with_text: 1469
                  count_negative_with_text: 162
                  avg_valuation: 4.79
                - date: '2025-11-06'
                  count: 3156
                  count_negative: 133
                  count_with_text: 1119
                  count_negative_with_text: 133
                  avg_valuation: 4.81
  /brand/feedback/comments/ai_recommendations:
    get:
      summary: AI рекомендации по отзывам на товары бренда
      tags:
        - brand
      parameters:
        - name: path
          in: query
          description: Название бренда
          required: true
          example: Xiaomi
          schema:
            type: string
      responses:
        '200':
          description: AI рекомендации
          content:
            application/json:
              example:
                id: 19b36ac20ac2970db60f113c23c27a76
                status: 10
                data:
                  pain_points:
                    - topic: Просвечивание ткани
                      description: >-
                        Покупатели жалуются, что материал топа слишком тонкий и
                        сильно просвечивает, что делает изделие непригодным для
                        ношения без подкладки.
                      solution: >-
                        Использовать более плотную или многослойную ткань,
                        протестировать материал на просвечивание при разных
                        условиях освещения.
                    - topic: Несоответствие цены качеству
                      description: >-
                        Клиенты отмечают, что качество изделия не оправдывает
                        его стоимости, что снижает доверие к бренду.
                      solution: >-
                        Провести анализ себестоимости и уровня восприятия цены,
                        возможно, скорректировать цену или повысить качество
                        материалов и пошива.
                    - topic: Разочарование ожиданий
                      description: >-
                        Отзыв с низкой оценкой указывает, что товар не
                        соответствует ожиданиям пользователя по изображению или
                        описанию.
                      solution: >-
                        Пересмотреть описание и фотографии товара, добавить
                        реальные фото на модели при разном освещении и в разных
                        позах.
                  advantages:
                    - topic: Современный дизайн
                      description: >-
                        Из отзыва следует, что изделие привлекательно визуально
                        (есть интерес к покупке топа несмотря на недостатки).
                      solution: >-
                        Сохранить стиль, но усилить функциональность за счёт
                        выбора качественных материалов.
                    - topic: Лёгкость материала
                      description: >-
                        Ткань, вероятно, тонкая и приятная на ощупь, что оценят
                        в жаркое время года.
                      solution: >-
                        Оставить лёгкость как характеристику, но добавить
                        плотную подкладку или продумать двойной слой в зонах,
                        где просвечивание критично.
                    - topic: Минималистичный стиль
                      description: >-
                        Топ, судя по отзыву, имеет простой дизайн, что
                        соответствует модным трендам.
                      solution: >-
                        Подчеркнуть минимализм в маркетинговых материалах, делая
                        акцент на универсальности и сочетании с другими вещами.
  /identical/items:
    post:
      summary: Похожие товары
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - identical
      parameters:
        - name: path
          in: query
          description: SKU
          required: true
          example: 151623766
          schema:
            type: integer
        - name: type
          in: query
          description: Необходимы тип данных (csv, json по умолчанию)
          required: false
          example: json
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список товаров
          content:
            application/json:
              example:
                startRow: 0
                endRow: 200
                total: 9755
                data:
                  - id: 3137867761
                    name: >-
                      Xiaomi Аэрогриль электрический Smart Air Fryer, 6.5л,
                      MAF10, белый
                    url: https://www.ozon.ru/context/detail/id/3137867761/
                    thumb: https://ir.ozone.ru/s3/multimedia-1-s/d100/8492959288.jpg
                    thumb_middle: https://ir.ozone.ru/s3/multimedia-1-s/d250/8492959288.jpg
                    niche_id: 10550
                    niche: Бытовая техника/Техника для кухни/Печи и грили/Аэрогрили
                    brand: Xiaomi
                    seller: МИЭНТЕК
                    seller_id: 3628678
                    category: Бытовая техника/Техника для кухни/Печи и грили/Аэрогрили
                    category_position: 118
                    final_price: 12448
                    final_price_average: 11933.56
                    final_price_min: 10874
                    final_price_max: 14257
                    final_price_median: 12180.5
                    start_price: 40000
                    ozon_card_price: 11415
                    balance: 2679
                    balance_fbs: 0
                    days_in_stock: 30
                    days_in_site: 56
                    sales: 3959
                    sales_per_day_average: 131.97
                    sales_per_comments: 2.73
                    revenue: 47244959
                    days_with_sales: 30
                    average_if_in_stock: 131.97
                    revenue_potential: 47244959
                    revenue_average: 1574831.97
                    lost_profit: 0
                    lost_profit_percent: 0
                    percent_from_revenue: 3.26
                    comments: 1804
                    comments_for_period: 1450
                    rating: 4.9
                    is_fbs: 0
                    sku_first_date: '2025-11-27'
                    picscount: 6
                    hasvideo: 0
                    turnover_days: 20.3
                    turnover_once: 1.88
                    frozen_stocks: 0
                    frozen_stocks_cost: 0
                    frozen_stocks_percent: 0
                    warehouses_count: 12
                    name_length: 66
                    groups: []
                    category_graph:
                      - 3
                      - 3
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                    search_words_count_graph:
                      - 399
                      - 415
                      - 401
                      - 424
                      - 419
                      - 427
                      - 445
                      - 455
                      - 464
                      - 432
                      - 408
                      - 451
                      - 441
                      - 408
                      - 369
                      - 401
                      - 367
                      - 378
                      - 364
                      - 393
                      - 373
                      - 355
                      - 382
                      - 366
                      - 417
                      - 442
                      - 440
                      - 409
                      - 394
                      - 355
                    graph:
                      - 288
                      - 245
                      - 193
                      - 264
                      - 284
                      - 221
                      - 200
                      - 82
                      - 102
                      - 160
                      - 181
                      - 212
                      - 166
                      - 145
                      - 160
                      - 65
                      - 52
                      - 65
                      - 57
                      - 65
                      - 67
                      - 65
                      - 70
                      - 93
                      - 74
                      - 77
                      - 88
                      - 81
                      - 80
                      - 57
                    stocks_graph:
                      - 1525
                      - 1338
                      - 2146
                      - 2385
                      - 2109
                      - 2013
                      - 1824
                      - 1746
                      - 1647
                      - 1581
                      - 1404
                      - 1197
                      - 1045
                      - 936
                      - 818
                      - 783
                      - 758
                      - 714
                      - 679
                      - 634
                      - 586
                      - 535
                      - 2090
                      - 2552
                      - 2868
                      - 2931
                      - 2855
                      - 2792
                      - 2727
                      - 2679
                    price_graph:
                      - 10874
                      - 11150
                      - 11628
                      - 11598
                      - 12185
                      - 11870
                      - 11796
                      - 11796
                      - 11531
                      - 11415
                      - 11178
                      - 11183
                      - 12107
                      - 11484
                      - 11976
                      - 14257
                      - 13174
                      - 13593
                      - 13835
                      - 13225
                      - 13275
                      - 12919
                      - 13311
                      - 12176
                      - 12799
                      - 12837
                      - 12544
                      - 12462
                      - 12278
                      - 12448
                    revenue_graph:
                      - 3131712
                      - 2731750
                      - 2244204
                      - 3061872
                      - 3460540
                      - 2623270
                      - 2359200
                      - 967272
                      - 1176162
                      - 1826400
                      - 2023218
                      - 2370796
                      - 2009762
                      - 1665180
                      - 1916160
                      - 926705
                      - 685048
                      - 883545
                      - 788595
                      - 859625
                      - 889425
                      - 839735
                      - 931770
                      - 1132368
                      - 947126
                      - 988449
                      - 1103872
                      - 1009422
                      - 982240
                      - 709536
                    rating_graph:
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                    search_position_graph:
                      - 41
                      - 27
                      - 41
                      - 63
                      - 43
                      - 80
                      - 72
                      - 91
                      - 96
                      - 96
                      - 16
                      - 103
                      - 62
                      - 37
                      - 35
                      - 100
                      - 58
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
  /identical/niches:
    post:
      summary: Предметы (ниши) похожих товаров
      tags:
        - identical
      parameters:
        - name: path
          in: query
          description: SKU
          required: true
          example: 151623766
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по нишам
          content:
            application/json:
              example:
                - id: 6519
                  name: Красота и здоровье/Макияж/Глаза/Туши для ресниц
                  sales: 12
                  balance: 2
                  revenue: 5155
                  revenue_potential: 30980.36
                  revenue_per_items_average: 161.09
                  revenue_per_items_with_sells_average: 859.17
                  lost_profit: 25825.36
                  lost_profit_percent: 83.36
                  items: 32
                  items_with_sells: 6
                  items_with_sells_percent: 18.75
                  items_with_count: 1
                  items_with_count_percent: 3.12
                  live_items: 6
                  sellers: 10
                  sellers_with_sells: 4
                  sellers_with_sells_percent: 40
                  brands: 2
                  brands_with_sells: 2
                  brands_with_sells_percent: 100
                  sales_per_items_average: 0.38
                  sales_per_items_with_sells_average: 2
                  avg_price: 583.94
                  avg_price_with_sells: 562.33
                  min_price: 199
                  min_price_with_sells: 327
                  max_price: 950
                  max_price_with_sells: 810
                  median_price: 567
                  median_price_with_sells: 526
                  rating: 479.38
                  rating_with_sells: 481.67
                  comments: 32665.41
                  turnover_in_days: 5
                  revenue_percent: 100
                  graph:
                    - 0
                    - 0
                    - 0
                    - 0
                    - 0
                    - 1
                    - 1
                    - 0
                    - 0
                    - 0
                    - 1
                    - 0
                    - 0
                    - 2
                    - 0
                    - 0
                    - 2
                    - 0
                    - 0
                    - 1
                    - 1
                    - 2
                    - 0
                    - 0
                    - 0
                    - 0
                    - 0
                    - 0
                    - 0
                    - 1
  /identical/categories:
    post:
      summary: Категории похожих товаров
      tags:
        - identical
      parameters:
        - name: path
          in: query
          description: SKU
          required: true
          example: 151623766
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список категорий
          content:
            application/json:
              example:
                - name: Ozon fresh/Красота и здоровье/Макияж/Глаза и брови/Ресницы
                  items: 31
                  items_with_sells: 6
                  items_with_sells_percent: 19.35
                  brands: 2
                  brands_with_sells: 2
                  brands_with_sells_percent: 100
                  sellers: 9
                  sellers_with_sells: 4
                  sellers_with_sells_percent: 44.44
                  sales_per_items_average: 0.39
                  sales_per_items_with_sells_average: 2
                  sales: 12
                  revenue: 5155
                  revenue_per_items_average: 166.29
                  revenue_per_items_with_sells_average: 859.17
                  avg_price: 574.01
                  comments: 33568.05
                  rating: 4.8
                - name: Красота и здоровье/Макияж/Глаза/Туши для ресниц
                  items: 32
                  items_with_sells: 6
                  items_with_sells_percent: 18.75
                  brands: 2
                  brands_with_sells: 2
                  brands_with_sells_percent: 100
                  sellers: 10
                  sellers_with_sells: 4
                  sellers_with_sells_percent: 40
                  sales_per_items_average: 0.38
                  sales_per_items_with_sells_average: 2
                  sales: 12
                  revenue: 5155
                  revenue_per_items_average: 161.09
                  revenue_per_items_with_sells_average: 859.17
                  avg_price: 571.14
                  comments: 33314.34
                  rating: 4.8
  /identical/brands:
    post:
      summary: Бренды похожих товаров
      tags:
        - identical
      parameters:
        - name: path
          in: query
          description: SKU
          required: true
          example: 151623766
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список брендов
          content:
            application/json:
              example:
                data:
                  - name: SELA
                    items: 273
                    items_with_sells: 72
                    items_with_sells_percent: 26.37
                    sellers: 4
                    sellers_with_sells: 1
                    sellers_with_sells_percent: 25
                    sales: 10538
                    revenue: 41977009
                    sales_per_items_average: 38.6
                    sales_per_items_with_sells_average: 146.36
                    revenue_per_items_average: 153761.94
                    revenue_per_items_with_sells_average: 583014.01
                    balance: 8052
                    balance_price: 30745817
                    avg_price: 2195.93
                    rating: 4.78
                    comments: 110.67
                    position: 1
                    graph:
                      - 164
                      - 185
                      - 131
                      - 163
                      - 229
                      - 211
                      - 224
                      - 200
                      - 244
                      - 288
                      - 322
                      - 244
                      - 217
                      - 235
                      - 238
                      - 303
                      - 286
                      - 298
                      - 541
                      - 376
                      - 461
                      - 793
                      - 665
                      - 499
                      - 524
                      - 525
                      - 475
                      - 461
                      - 480
                      - 556
                    graph_revenue:
                      - 12721
                      - 15405
                      - 16942
                      - 18640
                      - 5808
                      - 29872
                      - 12565
                      - 12604
                      - 24544
                      - 19903
                      - 17736
                      - 11385
                      - 27972
                      - 27869
                      - 23064
                      - 13487
                      - 22686
                      - 2040
                      - 22577
                      - 14841
                      - 34632
                      - 30000
                      - 9038
                      - 34754
                      - 40853
                      - 52437
                      - 27576
                      - 28768
                      - 52435
                      - 32527
                summary:
                  graph:
                    - 152
                    - 128
                    - 121
                    - 147
                    - 122
                    - 197
                    - 187
                    - 157
                    - 185
                    - 199
                    - 219
                    - 211
                    - 217
                    - 197
                    - 155
                    - 193
                    - 228
                    - 170
                    - 189
                    - 195
                    - 188
                    - 158
                    - 175
                    - 189
                    - 198
                    - 171
                    - 186
                    - 170
                    - 167
                    - 197
                  graph_revenue:
                    - 19731719
                    - 20036603
                    - 20049981
                    - 21860359
                    - 20161945
                    - 21456713
                    - 20629659
                    - 21348746
                    - 20502398
                    - 19914638
                    - 19044937
                    - 17456793
                    - 22428024
                    - 19419840
                    - 20625962
                    - 21810711
                    - 21458910
                    - 21390640
                    - 21850831
                    - 22133729
                    - 22458589
                    - 24229292
                    - 24461782
                    - 24818557
                    - 23086344
                    - 22986686
                    - 23371630
                    - 23947394
                    - 24620611
                    - 25329730
  /identical/sellers:
    post:
      summary: Продавцы похожих товаров
      tags:
        - identical
      parameters:
        - name: path
          in: query
          description: SKU
          required: true
          example: 151623766
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список продавцов
          content:
            application/json:
              example:
                data:
                  - position: 1
                    id: 7984
                    name: ELECTRONIC ECOSYSTEMS
                    ogrn: '1177746271196'
                    items: 280
                    items_with_sells: 229
                    items_with_sells_percent: 81.79
                    brands: 1
                    brands_with_sells: 1
                    brands_with_sells_percent: 100
                    sales: 5324
                    revenue: 72671285
                    sales_per_items_average: 19.01
                    sales_per_items_with_sells_average: 23.25
                    revenue_per_items_average: 259540.3
                    revenue_per_items_with_sells_average: 317341.86
                    balance: 4049
                    balance_price: 71176295
                    avg_price: 14268.06
                    rating: 485.27
                    comments: 399.69
                    graph:
                      - 182
                      - 147
                      - 133
                      - 204
                      - 257
                      - 198
                      - 175
                      - 189
                      - 220
                      - 194
                      - 154
                      - 160
                      - 151
                      - 171
                      - 214
                      - 207
                      - 187
                      - 158
                      - 160
                      - 223
                      - 344
                      - 169
                      - 89
                      - 113
                      - 158
                      - 144
                      - 159
                      - 164
                      - 171
                      - 129
                    graph_revenue:
                      - 12721
                      - 15405
                      - 16942
                      - 18640
                      - 5808
                      - 29872
                      - 12565
                      - 12604
                      - 24544
                      - 19903
                      - 17736
                      - 11385
                      - 27972
                      - 27869
                      - 23064
                      - 13487
                      - 22686
                      - 2040
                      - 22577
                      - 14841
                      - 34632
                      - 30000
                      - 9038
                      - 34754
                      - 40853
                      - 52437
                      - 27576
                      - 28768
                      - 52435
                      - 32527
                summary:
                  graph:
                    - 152
                    - 128
                    - 121
                    - 147
                    - 122
                    - 197
                    - 187
                    - 157
                    - 185
                    - 199
                    - 219
                    - 211
                    - 217
                    - 197
                    - 155
                    - 193
                    - 228
                    - 170
                    - 189
                    - 195
                    - 188
                    - 158
                    - 175
                    - 189
                    - 198
                    - 171
                    - 186
                    - 170
                    - 167
                    - 197
                  graph_revenue:
                    - 19731719
                    - 20036603
                    - 20049981
                    - 21860359
                    - 20161945
                    - 21456713
                    - 20629659
                    - 21348746
                    - 20502398
                    - 19914638
                    - 19044937
                    - 17456793
                    - 22428024
                    - 19419840
                    - 20625962
                    - 21810711
                    - 21458910
                    - 21390640
                    - 21850831
                    - 22133729
                    - 22458589
                    - 24229292
                    - 24461782
                    - 24818557
                    - 23086344
                    - 22986686
                    - 23371630
                    - 23947394
                    - 24620611
                    - 25329730
  /identical/trends:
    post:
      summary: Тренды похожих товаров
      tags:
        - identical
      parameters:
        - name: path
          in: query
          description: SKU
          required: true
          example: 151623766
          schema:
            type: integer
        - name: trends_by
          in: query
          description: Период трендов (день / неделя / месяц)
          required: false
          example: week
          schema:
            type: string
        - name: year
          in: query
          description: Год
          required: false
          example: 2025
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - date: '2024-01-01'
                  items: 13585
                  items_with_sells: 1760
                  brands: 1287
                  brands_with_sells: 321
                  sellers: 1066
                  sellers_with_sells: 289
                  sales: 8458
                  revenue: 48026713
                  product_revenue: 27288
                  average_order_value: 5678
                  end_date: '2024-01-07'
                  label_date: '2024-01-07'
                - date: '2024-01-08'
                  items: 13599
                  items_with_sells: 3159
                  brands: 1290
                  brands_with_sells: 495
                  sellers: 1068
                  sellers_with_sells: 440
                  sales: 12977
                  revenue: 74944549
                  product_revenue: 23724
                  average_order_value: 5775
                  end_date: '2024-01-14'
                  label_date: '2024-01-14'
  /identical/by_date:
    post:
      summary: Показатели за период похожих товаров
      tags:
        - identical
      parameters:
        - name: path
          in: query
          description: SKU
          required: true
          example: 151623766
          schema:
            type: integer
        - name: groupBy
          in: query
          description: Период (day / week / month / quarter)
          required: false
          example: week
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - period: '2025-07-20'
                  balance: 987259
                  balance_price: 8711665952
                  avg_price: 7342.99
                  items: 152160
                  items_with_sells: 3339
                  brands: 7901
                  brands_with_sells: 818
                  sellers: 7461
                  sellers_with_sells: 829
                  sales: 7177
                  revenue: 40693538
                  comments: 33.34
                  rating: 4.64
                  avg_sale_price: 5669.99
                - period: '2025-07-19'
                  balance: 984248
                  balance_price: 8681202149
                  avg_price: 7338.01
                  items: 152106
                  items_with_sells: 2917
                  brands: 7903
                  brands_with_sells: 767
                  sellers: 7462
                  sellers_with_sells: 769
                  sales: 5690
                  revenue: 34244128
                  comments: 33.33
                  rating: 4.64
                  avg_sale_price: 6018.3
                - period: '2025-07-18'
                  balance: 989134
                  balance_price: 8528299459
                  avg_price: 7297.34
                  items: 152070
                  items_with_sells: 2812
                  brands: 7904
                  brands_with_sells: 760
                  sellers: 7464
                  sellers_with_sells: 779
                  sales: 5634
                  revenue: 65263547
                  comments: 32.98
                  rating: 4.64
                  avg_sale_price: 11583.87
  /identical/price_segmentation:
    post:
      summary: Ценовая сегментация похожих товаров
      tags:
        - identical
      parameters:
        - name: path
          in: query
          description: SKU
          required: true
          example: 151623766
          schema:
            type: integer
        - name: minPrice
          in: query
          description: Минимальная цена
          required: false
          example: 1000
          schema:
            type: integer
        - name: maxPrice
          in: query
          description: Максимальная цена
          required: false
          example: 20000
          schema:
            type: integer
        - name: priceStep
          in: query
          description: Шаг ценового диапазона
          required: false
          example: 1000
          schema:
            type: integer
        - name: segmentsCnt
          in: query
          description: Кол-во сегментов
          required: false
          example: 10
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - range: 50-1155
                  items: 6120
                  items_with_sells: 149
                  brands: 1356
                  brands_with_sells: 74
                  sellers: 1268
                  sellers_with_sells: 73
                  revenue: 1435646
                  sales: 1299
                  product_revenue: 9635.21
                  min_range_price: 50
                  max_range_price: 1155
                  revenue_potential: 6170274.86
                  lost_profit: 4754366.86
                  lost_profit_percent: 77.05
                - range: 1155-1576
                  items: 6119
                  items_with_sells: 370
                  brands: 1554
                  brands_with_sells: 165
                  sellers: 1479
                  sellers_with_sells: 168
                  revenue: 5522225
                  sales: 3686
                  product_revenue: 14924.93
                  min_range_price: 1156
                  max_range_price: 1576
                  revenue_potential: 17412867.5
                  lost_profit: 11934997.5
                  lost_profit_percent: 68.54
  /identical/keywords:
    post:
      summary: Запросы похожих товаров
      tags:
        - identical
      parameters:
        - name: path
          in: query
          description: SKU
          required: true
          example: 151623766
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по поисковым запросам
          content:
            application/json:
              example:
                queries:
                  - word: игрушки для собак
                    count: 9735
                    wb_count: 99158
                    query_cluster: игрушки для собак
                    items_count: 76
                  - word: игрушка для собак
                    count: 6155
                    wb_count: 38877
                    query_cluster: игрушки для собак
                    items_count: 76
                words:
                  - count: 2856
                    word: собак
                    words:
                      - собак
                      - собаки
                      - собака
                      - собаке
                      - собаку
                      - собакам
                      - собакой
                      - собаками
                    keys:
                      - word: игрушки для собак
                        count: 9735
                        wb_count: 99158
                        query_cluster: игрушки для собак
                        items_count: 76
                      - word: игрушка для собак
                        count: 6155
                        wb_count: 38877
                        query_cluster: игрушки для собак
                        items_count: 76
                    mp: 0
                    keys_count_sum: 6386
                    keys_wb_count_sum: 66145
                  - count: 280
                    word: крупных
                    words:
                      - крупных
                      - крупной
                      - крупные
                      - крупная
                    keys:
                      - word: игрушки для щенков крупных пород
                        count: 116
                        wb_count: 533
                        query_cluster: игрушки для щенков крупных пород
                        items_count: 43
                      - word: игрушки для собак крупных пород
                        count: 2465
                        wb_count: 10255
                        query_cluster: игрушки для собак крупных пород
                        items_count: 42
                    mp: 0
                    keys_count_sum: 10135
                    keys_wb_count_sum: 62429
  /identical/compare:
    post:
      summary: Сравнение периодов по похожим товарам
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - identical
      parameters:
        - name: path
          in: query
          description: SKU
          required: true
          example: 151623766
          schema:
            type: integer
        - name: d11
          in: query
          description: Дата начала первого периода
          required: true
          example: '2025-01-01'
          schema:
            type: string
        - name: d12
          in: query
          description: Дата конца первого периода
          required: true
          example: '2025-02-01'
          schema:
            type: string
        - name: d21
          in: query
          description: Дата начала второго периода
          required: true
          example: '2025-02-01'
          schema:
            type: string
        - name: d22
          in: query
          description: Дата конца второго периода
          required: true
          example: '2025-03-01'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по товарам за выбранные периоды
          content:
            application/json:
              example:
                startRow: 0
                endRow: 200
                total: 10043800
                data:
                  - id: 1592320262
                    name: Футболка GoldenCate-I внуки
                    brand: GoldenCate-I
                    seller: GoldenCate-I
                    seller_id: 1882627
                    sales_1: 0
                    sales_2: 0
                    revenue_1: 0
                    revenue_2: 0
                    days_in_stock_1: 0
                    days_in_stock_2: 0
                    price_1: 1522
                    price_2: 1582
                    avg_price_1: 2179.17
                    avg_price_2: 1612.57
                    sales_diff: 0
                    revenue_diff: 0
                    days_in_stock_diff: 0
                    price_diff: 60
                    avg_price_diff: -566.6
                    thumb: https://cdn1.ozone.ru/s3/multimedia-1-n/7043160515.jpg
                  - id: 640524872
                    name: Платье пляжное
                    brand: ''
                    seller: самый быстрый, лучший, дешевый
                    seller_id: 281568
                    sales_1: 0
                    sales_2: 0
                    revenue_1: 0
                    revenue_2: 0
                    days_in_stock_1: 0
                    days_in_stock_2: 0
                    price_1: 706
                    price_2: 740
                    avg_price_1: 711.17
                    avg_price_2: 707.87
                    sales_diff: 0
                    revenue_diff: 0
                    days_in_stock_diff: 0
                    price_diff: 34
                    avg_price_diff: -3.3
                    thumb: https://cdn1.ozone.ru/s3/multimedia-t/6093784529.jpg
                summary:
                  sales_1: 20551030
                  sales_2: 22862898
                  revenue_1: 30366243940
                  revenue_2: 36120196612
                  sales_diff: 2311868
                  revenue_diff: 5753952672
  /groups:
    get:
      summary: Получение списка групп пользователя
      tags:
        - groups
      parameters:
        - name: archived
          in: query
          description: Отображать группы из архива
          required: false
          example: false
          schema:
            type: boolean
        - name: sku
          in: query
          description: SKU товара, если нужно найти группы, в которых он присутствует
          required: false
          example: 265906486
          schema:
            type: boolean
      responses:
        '200':
          description: Список групп пользователя
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/groups'
              example:
                groups:
                  - id: 81503
                    name: обувь ozon
                  - id: 565488
                    name: test
                defaultGroup: null
    put:
      summary: Создание новой группы
      tags:
        - groups
      parameters:
        - name: name
          in: query
          description: Название группы
          required: true
          example: Новая группа
          schema:
            type: string
      responses:
        '201':
          description: Статус операции и ID новой группы
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/groups.put'
              example:
                success: true
                id: 565489
  /groups/stats:
    post:
      summary: Получение списка групп пользователя со статистикой по товарам
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - groups
      parameters:
        - name: type
          in: query
          description: Необходимый тип данных (csv, xls, json по умолчанию)
          required: false
          example: json
          schema:
            type: string
        - name: days
          in: query
          description: Кол-во дней в отчёте
          required: false
          example: 30
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Включить в отчёт данные по FBS-товарам
          required: false
          example: false
          schema:
            type: boolean
        - name: archived
          in: query
          description: Отображать группы из архива
          required: false
          example: false
          schema:
            type: boolean
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
        - name: salesFields
          in: query
          description: Экспортировать график продаж по дням
          required: false
          schema:
            type: boolean
      responses:
        '200':
          description: Список групп пользователя
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/groups.stats'
              example:
                startRow: 0
                endRow: 3
                total: 3
                data:
                  - id: 81503
                    name: Название группы
                    created: '2024-06-13'
                    updated: '2024-07-04'
                    items_count: 100000
                    items_count_in_period: 21069
                    sales: 1046
                    revenue: 3124261
                    count_brands: 16
                    count_sellers: 908
                    graph:
                      - 38
                      - 36
                      - 34
                      - 40
                      - 26
  /groups/{id}:
    get:
      summary: Получение данных по ID группы
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - groups
      parameters:
        - name: id
          in: path
          description: ID группы
          required: true
          example: 565488
          schema:
            type: integer
      responses:
        '200':
          description: Основные данные группы
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/groups.id'
              example:
                id: 565488
                name: Название группы
                onmain: 1
                archived: 0
                created: '2024-11-25 09:29:01'
                updated: '2024-11-25 09:37:33'
    patch:
      summary: Изменение названия группы
      tags:
        - groups
      parameters:
        - name: id
          in: path
          description: ID группы
          required: true
          example: 565488
          schema:
            type: integer
        - name: name
          in: query
          description: Название группы
          required: true
          example: Новое название группы
          schema:
            type: string
      responses:
        '200':
          description: Результат
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/success'
              example:
                success: true
    delete:
      summary: Удаление группы и её товаров
      tags:
        - groups
      parameters:
        - name: id
          in: path
          description: ID группы
          required: true
          example: 565488
          schema:
            type: integer
      responses:
        '200':
          description: Результат
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/success'
              example:
                success: true
    put:
      summary: Добавление товаров в группу
      description: >-
        Обязательно передавать хотя бы один из указанных параметров (skus /
        brands / sellers / keyword)
      tags:
        - groups
      parameters:
        - name: id
          in: path
          description: ID группы
          required: true
          example: 565488
          schema:
            type: integer
        - name: skus
          in: query
          description: Список SKU
          required: false
          example: 35995104, 153525562, 142257239
          schema:
            type: string
        - name: exceptSkus
          in: query
          description: Список исключённых SKU (которые не будут добавлены в группу)
          required: false
          schema:
            type: array
        - name: brands
          in: query
          description: Список брендов (названия)
          required: false
          example:
            - adidas
            - nike
          schema:
            type: array
            items:
              type: string
        - name: sellers
          in: query
          description: Список продавцов (id)
          required: false
          example:
            - 7
            - 8145
          schema:
            type: array
            items:
              type: string
        - name: keyword
          in: query
          description: Ключевое слово
          required: false
          example: кроссовки
          schema:
            type: string
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы (как в методе POST /items)
          required: false
          schema:
            type: array
      responses:
        '201':
          description: Результат
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/success'
              example:
                success: true
  /groups/{id}/main:
    patch:
      summary: Выбрать группу в качестве группы по умолчанию
      tags:
        - groups
      parameters:
        - name: id
          in: path
          description: ID группы
          required: true
          example: 565488
          schema:
            type: integer
      responses:
        '200':
          description: Результат
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/success'
              example:
                success: true
  /groups/{id}/archive:
    patch:
      summary: Переместить группу в архив
      tags:
        - groups
      parameters:
        - name: id
          in: path
          description: ID группы
          required: true
          example: 565488
          schema:
            type: integer
      responses:
        '200':
          description: Результат
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/success'
              example:
                success: true
  /groups/{id}/restore:
    patch:
      summary: Восстановить группу из архива
      tags:
        - groups
      parameters:
        - name: id
          in: path
          description: ID группы
          required: true
          example: 565488
          schema:
            type: integer
      responses:
        '200':
          description: Результат
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/success'
              example:
                success: true
  /groups/{id}/items:
    delete:
      summary: Удаление товаров из группы
      description: Если skus пустой (не передан), то удаляются все товары из группы
      tags:
        - groups
      parameters:
        - name: id
          in: path
          description: ID группы
          required: true
          example: 565488
          schema:
            type: integer
        - name: skus
          in: query
          description: Список SKU товаров в группе
          required: false
          example: 565488
          schema:
            type: array
            items:
              type: integer
      responses:
        '200':
          description: Результат
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/success'
              example:
                success: true
  /groups/items:
    post:
      summary: Товары группы
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - groups
      parameters:
        - name: path
          in: query
          description: Id группы
          required: true
          example: 565488
          schema:
            type: integer
        - name: type
          in: query
          description: Необходимы тип данных (csv, json по умолчанию)
          required: false
          example: json
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список товаров
          content:
            application/json:
              example:
                startRow: 0
                endRow: 200
                total: 9755
                data:
                  - id: 3137867761
                    name: >-
                      Xiaomi Аэрогриль электрический Smart Air Fryer, 6.5л,
                      MAF10, белый
                    url: //www.ozon.ru/context/detail/id/3137867761/
                    thumb: //ir.ozone.ru/s3/multimedia-1-s/d100/8492959288.jpg
                    thumb_middle: //ir.ozone.ru/s3/multimedia-1-s/d250/8492959288.jpg
                    niche_id: 10550
                    niche: Бытовая техника/Техника для кухни/Печи и грили/Аэрогрили
                    brand: Xiaomi
                    seller: МИЭНТЕК
                    seller_id: 3628678
                    category: Бытовая техника/Техника для кухни/Печи и грили/Аэрогрили
                    category_position: 118
                    final_price: 12448
                    final_price_average: 11933.56
                    final_price_min: 10874
                    final_price_max: 14257
                    final_price_median: 12180.5
                    start_price: 40000
                    ozon_card_price: 11415
                    balance: 2679
                    balance_fbs: 0
                    days_in_stock: 30
                    days_in_site: 56
                    sales: 3959
                    sales_per_day_average: 131.97
                    sales_per_comments: 2.73
                    revenue: 47244959
                    days_with_sales: 30
                    average_if_in_stock: 131.97
                    revenue_potential: 47244959
                    revenue_average: 1574831.97
                    lost_profit: 0
                    lost_profit_percent: 0
                    percent_from_revenue: 3.26
                    comments: 1804
                    comments_for_period: 1450
                    rating: 4.9
                    is_fbs: 0
                    sku_first_date: '2025-11-27'
                    picscount: 6
                    hasvideo: 0
                    turnover_days: 20.3
                    turnover_once: 1.88
                    frozen_stocks: 0
                    frozen_stocks_cost: 0
                    frozen_stocks_percent: 0
                    warehouses_count: 12
                    name_length: 66
                    groups: []
                    category_graph:
                      - 3
                      - 3
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                      - 4
                    search_words_count_graph:
                      - 399
                      - 415
                      - 401
                      - 424
                      - 419
                      - 427
                      - 445
                      - 455
                      - 464
                      - 432
                      - 408
                      - 451
                      - 441
                      - 408
                      - 369
                      - 401
                      - 367
                      - 378
                      - 364
                      - 393
                      - 373
                      - 355
                      - 382
                      - 366
                      - 417
                      - 442
                      - 440
                      - 409
                      - 394
                      - 355
                    graph:
                      - 288
                      - 245
                      - 193
                      - 264
                      - 284
                      - 221
                      - 200
                      - 82
                      - 102
                      - 160
                      - 181
                      - 212
                      - 166
                      - 145
                      - 160
                      - 65
                      - 52
                      - 65
                      - 57
                      - 65
                      - 67
                      - 65
                      - 70
                      - 93
                      - 74
                      - 77
                      - 88
                      - 81
                      - 80
                      - 57
                    stocks_graph:
                      - 1525
                      - 1338
                      - 2146
                      - 2385
                      - 2109
                      - 2013
                      - 1824
                      - 1746
                      - 1647
                      - 1581
                      - 1404
                      - 1197
                      - 1045
                      - 936
                      - 818
                      - 783
                      - 758
                      - 714
                      - 679
                      - 634
                      - 586
                      - 535
                      - 2090
                      - 2552
                      - 2868
                      - 2931
                      - 2855
                      - 2792
                      - 2727
                      - 2679
                    price_graph:
                      - 10874
                      - 11150
                      - 11628
                      - 11598
                      - 12185
                      - 11870
                      - 11796
                      - 11796
                      - 11531
                      - 11415
                      - 11178
                      - 11183
                      - 12107
                      - 11484
                      - 11976
                      - 14257
                      - 13174
                      - 13593
                      - 13835
                      - 13225
                      - 13275
                      - 12919
                      - 13311
                      - 12176
                      - 12799
                      - 12837
                      - 12544
                      - 12462
                      - 12278
                      - 12448
                    revenue_graph:
                      - 3131712
                      - 2731750
                      - 2244204
                      - 3061872
                      - 3460540
                      - 2623270
                      - 2359200
                      - 967272
                      - 1176162
                      - 1826400
                      - 2023218
                      - 2370796
                      - 2009762
                      - 1665180
                      - 1916160
                      - 926705
                      - 685048
                      - 883545
                      - 788595
                      - 859625
                      - 889425
                      - 839735
                      - 931770
                      - 1132368
                      - 947126
                      - 988449
                      - 1103872
                      - 1009422
                      - 982240
                      - 709536
                    rating_graph:
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                      - 4.9
                    search_position_graph:
                      - 41
                      - 27
                      - 41
                      - 63
                      - 43
                      - 80
                      - 72
                      - 91
                      - 96
                      - 96
                      - 16
                      - 103
                      - 62
                      - 37
                      - 35
                      - 100
                      - 58
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
                      - 0
  /groups/niches:
    post:
      summary: Предметы (ниши) группы
      tags:
        - groups
      parameters:
        - name: path
          in: query
          description: Id группы
          required: true
          example: 123
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по нишам
          content:
            application/json:
              example:
                - id: 7540
                  name: >-
                    Одежда/Женская одежда/Купальники и пляжная одежда
                    женская/Купальники женские
                  sales: 196
                  balance: 168
                  revenue: 559591
                  revenue_potential: 634395.44
                  revenue_per_items_average: 15988.31
                  revenue_per_items_with_sells_average: 19296.24
                  lost_profit: 74804.44
                  lost_profit_percent: 11.79
                  items: 35
                  items_with_sells: 29
                  items_with_sells_percent: 82.86
                  items_with_count: 32
                  items_with_count_percent: 91.43
                  live_items: 34
                  sellers: 1
                  sellers_with_sells: 1
                  sellers_with_sells_percent: 100
                  brands: 3
                  brands_with_sells: 2
                  brands_with_sells_percent: 66.67
                  sales_per_items_average: 5.6
                  sales_per_items_with_sells_average: 6.76
                  avg_price: 2212.97
                  avg_price_with_sells: 2235.66
                  min_price: 1326
                  min_price_with_sells: 1532
                  max_price: 3790
                  max_price_with_sells: 2450
                  median_price: 2342
                  median_price_with_sells: 2354
                  rating: 465.88
                  rating_with_sells: 464.83
                  comments: 28
                  turnover_in_days: 25.71
                  revenue_percent: 27.7
                  graph:
                    - 2
                    - 0
                    - 2
                    - 17
                    - 11
                    - 6
                    - 7
                    - 14
                    - 19
                    - 3
                    - 7
                    - 4
                    - 4
                    - 7
                    - 5
                    - 6
                    - 6
                    - 7
                    - 8
                    - 4
                    - 6
                    - 7
                    - 7
                    - 6
                    - 4
                    - 2
                    - 6
                    - 1
                    - 9
                    - 9
  /groups/categories:
    post:
      summary: Категории группы
      tags:
        - groups
      parameters:
        - name: path
          in: query
          description: Id группы
          required: true
          example: 123
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список категорий
          content:
            application/json:
              example:
                - name: >-
                    Одежда/Женская одежда/Купальники и пляжная одежда
                    женская/Купальники женские
                  items: 35
                  items_with_sells: 29
                  items_with_sells_percent: 82.86
                  brands: 3
                  brands_with_sells: 2
                  brands_with_sells_percent: 66.67
                  sellers: 1
                  sellers_with_sells: 1
                  sellers_with_sells_percent: 100
                  sales_per_items_average: 5.6
                  sales_per_items_with_sells_average: 6.76
                  sales: 196
                  revenue: 559591
                  revenue_per_items_average: 15988.31
                  revenue_per_items_with_sells_average: 19296.24
                  avg_price: 2651.64
                  comments: 23.28
                  rating: 4.63
                - name: >-
                    Ozon fresh/Другие товары/Одежда и аксессуары/Аксессуары для
                    путешествий
                  items: 34
                  items_with_sells: 29
                  items_with_sells_percent: 85.29
                  brands: 3
                  brands_with_sells: 2
                  brands_with_sells_percent: 66.67
                  sellers: 1
                  sellers_with_sells: 1
                  sellers_with_sells_percent: 100
                  sales_per_items_average: 5.76
                  sales_per_items_with_sells_average: 6.76
                  sales: 196
                  revenue: 559591
                  revenue_per_items_average: 16458.56
                  revenue_per_items_with_sells_average: 19296.24
                  avg_price: 2648.61
                  comments: 22.93
                  rating: 4.64
  /groups/brands:
    post:
      summary: Бренды группы
      tags:
        - groups
      parameters:
        - name: path
          in: query
          description: Id группы
          required: true
          example: 123
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список брендов
          content:
            application/json:
              example:
                data:
                  - name: SELA
                    items: 273
                    items_with_sells: 72
                    items_with_sells_percent: 26.37
                    sellers: 4
                    sellers_with_sells: 1
                    sellers_with_sells_percent: 25
                    sales: 10538
                    revenue: 41977009
                    sales_per_items_average: 38.6
                    sales_per_items_with_sells_average: 146.36
                    revenue_per_items_average: 153761.94
                    revenue_per_items_with_sells_average: 583014.01
                    balance: 8052
                    balance_price: 30745817
                    avg_price: 2195.93
                    rating: 4.78
                    comments: 110.67
                    position: 1
                    graph:
                      - 164
                      - 185
                      - 131
                      - 163
                      - 229
                      - 211
                      - 224
                      - 200
                      - 244
                      - 288
                      - 322
                      - 244
                      - 217
                      - 235
                      - 238
                      - 303
                      - 286
                      - 298
                      - 541
                      - 376
                      - 461
                      - 793
                      - 665
                      - 499
                      - 524
                      - 525
                      - 475
                      - 461
                      - 480
                      - 556
                    graph_revenue:
                      - 12721
                      - 15405
                      - 16942
                      - 18640
                      - 5808
                      - 29872
                      - 12565
                      - 12604
                      - 24544
                      - 19903
                      - 17736
                      - 11385
                      - 27972
                      - 27869
                      - 23064
                      - 13487
                      - 22686
                      - 2040
                      - 22577
                      - 14841
                      - 34632
                      - 30000
                      - 9038
                      - 34754
                      - 40853
                      - 52437
                      - 27576
                      - 28768
                      - 52435
                      - 32527
                summary:
                  graph:
                    - 152
                    - 128
                    - 121
                    - 147
                    - 122
                    - 197
                    - 187
                    - 157
                    - 185
                    - 199
                    - 219
                    - 211
                    - 217
                    - 197
                    - 155
                    - 193
                    - 228
                    - 170
                    - 189
                    - 195
                    - 188
                    - 158
                    - 175
                    - 189
                    - 198
                    - 171
                    - 186
                    - 170
                    - 167
                    - 197
                  graph_revenue:
                    - 19731719
                    - 20036603
                    - 20049981
                    - 21860359
                    - 20161945
                    - 21456713
                    - 20629659
                    - 21348746
                    - 20502398
                    - 19914638
                    - 19044937
                    - 17456793
                    - 22428024
                    - 19419840
                    - 20625962
                    - 21810711
                    - 21458910
                    - 21390640
                    - 21850831
                    - 22133729
                    - 22458589
                    - 24229292
                    - 24461782
                    - 24818557
                    - 23086344
                    - 22986686
                    - 23371630
                    - 23947394
                    - 24620611
                    - 25329730
  /groups/sellers:
    post:
      summary: Продавцы группы
      tags:
        - groups
      parameters:
        - name: path
          in: query
          description: Id группы
          required: true
          example: 123
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Список продавцов
          content:
            application/json:
              example:
                data:
                  - position: 1
                    id: 7984
                    name: ELECTRONIC ECOSYSTEMS
                    ogrn: '1177746271196'
                    items: 280
                    items_with_sells: 229
                    items_with_sells_percent: 81.79
                    brands: 1
                    brands_with_sells: 1
                    brands_with_sells_percent: 100
                    sales: 5324
                    revenue: 72671285
                    sales_per_items_average: 19.01
                    sales_per_items_with_sells_average: 23.25
                    revenue_per_items_average: 259540.3
                    revenue_per_items_with_sells_average: 317341.86
                    balance: 4049
                    balance_price: 71176295
                    avg_price: 14268.06
                    rating: 485.27
                    comments: 399.69
                    graph:
                      - 182
                      - 147
                      - 133
                      - 204
                      - 257
                      - 198
                      - 175
                      - 189
                      - 220
                      - 194
                      - 154
                      - 160
                      - 151
                      - 171
                      - 214
                      - 207
                      - 187
                      - 158
                      - 160
                      - 223
                      - 344
                      - 169
                      - 89
                      - 113
                      - 158
                      - 144
                      - 159
                      - 164
                      - 171
                      - 129
                    graph_revenue:
                      - 12721
                      - 15405
                      - 16942
                      - 18640
                      - 5808
                      - 29872
                      - 12565
                      - 12604
                      - 24544
                      - 19903
                      - 17736
                      - 11385
                      - 27972
                      - 27869
                      - 23064
                      - 13487
                      - 22686
                      - 2040
                      - 22577
                      - 14841
                      - 34632
                      - 30000
                      - 9038
                      - 34754
                      - 40853
                      - 52437
                      - 27576
                      - 28768
                      - 52435
                      - 32527
                summary:
                  graph:
                    - 152
                    - 128
                    - 121
                    - 147
                    - 122
                    - 197
                    - 187
                    - 157
                    - 185
                    - 199
                    - 219
                    - 211
                    - 217
                    - 197
                    - 155
                    - 193
                    - 228
                    - 170
                    - 189
                    - 195
                    - 188
                    - 158
                    - 175
                    - 189
                    - 198
                    - 171
                    - 186
                    - 170
                    - 167
                    - 197
                  graph_revenue:
                    - 19731719
                    - 20036603
                    - 20049981
                    - 21860359
                    - 20161945
                    - 21456713
                    - 20629659
                    - 21348746
                    - 20502398
                    - 19914638
                    - 19044937
                    - 17456793
                    - 22428024
                    - 19419840
                    - 20625962
                    - 21810711
                    - 21458910
                    - 21390640
                    - 21850831
                    - 22133729
                    - 22458589
                    - 24229292
                    - 24461782
                    - 24818557
                    - 23086344
                    - 22986686
                    - 23371630
                    - 23947394
                    - 24620611
                    - 25329730
  /groups/trends:
    post:
      summary: Тренды группы
      tags:
        - groups
      parameters:
        - name: path
          in: query
          description: Id группы
          required: true
          example: 123
          schema:
            type: integer
        - name: trends_by
          in: query
          description: Период трендов (день / неделя / месяц)
          required: false
          example: week
          schema:
            type: string
        - name: year
          in: query
          description: Год
          required: false
          example: 2025
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - date: '2024-01-01'
                  items: 13585
                  items_with_sells: 1760
                  brands: 1287
                  brands_with_sells: 321
                  sellers: 1066
                  sellers_with_sells: 289
                  sales: 8458
                  revenue: 48026713
                  product_revenue: 27288
                  average_order_value: 5678
                  end_date: '2024-01-07'
                  label_date: '2024-01-07'
                - date: '2024-01-08'
                  items: 13599
                  items_with_sells: 3159
                  brands: 1290
                  brands_with_sells: 495
                  sellers: 1068
                  sellers_with_sells: 440
                  sales: 12977
                  revenue: 74944549
                  product_revenue: 23724
                  average_order_value: 5775
                  end_date: '2024-01-14'
                  label_date: '2024-01-14'
  /groups/by_date:
    post:
      summary: Показатели за период по группе
      tags:
        - groups
      parameters:
        - name: path
          in: query
          description: Id группы
          required: true
          example: 123
          schema:
            type: integer
        - name: groupBy
          in: query
          description: Период (day / week / month / quarter)
          required: false
          example: week
          schema:
            type: string
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - period: '2025-08-01'
                  balance: 689
                  balance_price: 2140505
                  avg_price: 3537.19
                  items: 147
                  items_with_sells: 62
                  brands: 4
                  brands_with_sells: 3
                  sellers: 1
                  sellers_with_sells: 1
                  sales: 106
                  revenue: 359476
                  comments: 62.55
                  rating: 481.47
                  avg_sale_price: 3391.28
                - period: '2025-07-01'
                  balance: 731
                  balance_price: 2370248
                  avg_price: 3609.69
                  items: 159
                  items_with_sells: 113
                  brands: 4
                  brands_with_sells: 4
                  sellers: 1
                  sellers_with_sells: 1
                  sales: 464
                  revenue: 1660509
                  comments: 82.13
                  rating: 479.5
                  avg_sale_price: 3578.68
  /groups/price_segmentation:
    post:
      summary: Ценовая сегментация группы
      tags:
        - groups
      parameters:
        - name: path
          in: query
          description: Id группы
          required: true
          example: 123
          schema:
            type: integer
        - name: minPrice
          in: query
          description: Минимальная цена
          required: false
          example: 1000
          schema:
            type: integer
        - name: maxPrice
          in: query
          description: Максимальная цена
          required: false
          example: 20000
          schema:
            type: integer
        - name: priceStep
          in: query
          description: Шаг ценового диапазона
          required: false
          example: 1000
          schema:
            type: integer
        - name: segmentsCnt
          in: query
          description: Кол-во сегментов
          required: false
          example: 10
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по периодам
          content:
            application/json:
              example:
                - range: 50-1155
                  items: 6120
                  items_with_sells: 149
                  brands: 1356
                  brands_with_sells: 74
                  sellers: 1268
                  sellers_with_sells: 73
                  revenue: 1435646
                  sales: 1299
                  product_revenue: 9635.21
                  min_range_price: 50
                  max_range_price: 1155
                  revenue_potential: 6170274.86
                  lost_profit: 4754366.86
                  lost_profit_percent: 77.05
                - range: 1155-1576
                  items: 6119
                  items_with_sells: 370
                  brands: 1554
                  brands_with_sells: 165
                  sellers: 1479
                  sellers_with_sells: 168
                  revenue: 5522225
                  sales: 3686
                  product_revenue: 14924.93
                  min_range_price: 1156
                  max_range_price: 1576
                  revenue_potential: 17412867.5
                  lost_profit: 11934997.5
                  lost_profit_percent: 68.54
  /groups/keywords:
    post:
      summary: Запросы по группе
      tags:
        - groups
      parameters:
        - name: path
          in: query
          description: Id группы
          required: true
          example: 123
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по поисковым запросам
          content:
            application/json:
              example:
                queries:
                  - word: игрушки для собак
                    count: 9735
                    wb_count: 99158
                    query_cluster: игрушки для собак
                    items_count: 76
                  - word: игрушка для собак
                    count: 6155
                    wb_count: 38877
                    query_cluster: игрушки для собак
                    items_count: 76
                words:
                  - count: 2856
                    word: собак
                    words:
                      - собак
                      - собаки
                      - собака
                      - собаке
                      - собаку
                      - собакам
                      - собакой
                      - собаками
                    keys:
                      - word: игрушки для собак
                        count: 9735
                        wb_count: 99158
                        query_cluster: игрушки для собак
                        items_count: 76
                      - word: игрушка для собак
                        count: 6155
                        wb_count: 38877
                        query_cluster: игрушки для собак
                        items_count: 76
                    mp: 0
                    keys_count_sum: 6386
                    keys_wb_count_sum: 66145
                  - count: 280
                    word: крупных
                    words:
                      - крупных
                      - крупной
                      - крупные
                      - крупная
                    keys:
                      - word: игрушки для щенков крупных пород
                        count: 116
                        wb_count: 533
                        query_cluster: игрушки для щенков крупных пород
                        items_count: 43
                      - word: игрушки для собак крупных пород
                        count: 2465
                        wb_count: 10255
                        query_cluster: игрушки для собак крупных пород
                        items_count: 42
                    mp: 0
                    keys_count_sum: 10135
                    keys_wb_count_sum: 62429
  /groups/geography:
    get:
      summary: География товаров группы
      tags:
        - groups
      parameters:
        - name: path
          in: query
          description: Id группы
          required: true
          example: 123
          schema:
            type: integer
        - name: date
          in: query
          description: Дата в формате YYYY-MM
          required: true
          example: 2025-01
          schema:
            type: string
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
      responses:
        '200':
          description: Данные по регионам и складам
          content:
            application/json:
              example:
                period: 2025-07
                region_data:
                  - region: Москва, МО и Дальние регионы
                    sales: 702831
                    count: 24799730
                    revenue: 1535922940
                    sales_percent: 32.12
                    count_percent: 38.32
                    revenue_percent: 32.34
                  - region: Санкт-Петербург и СЗО
                    sales: 311168
                    count: 9137892
                    revenue: 684599487
                    sales_percent: 14.22
                    count_percent: 14.12
                    revenue_percent: 14.42
                storage_data:
                  - name: ПУШКИНО_1_РФЦ
                    region: Москва, МО и Дальние регионы
                    sales: 106563
                    count: 4399210
                    revenue: 223395038
                    sales_percent: 4.87
                    count_percent: 6.8
                    revenue_percent: 4.7
                  - name: СПБ_БУГРЫ_РФЦ
                    region: Санкт-Петербург и СЗО
                    sales: 120361
                    count: 3772210
                    revenue: 267257984
                    sales_percent: 5.5
                    count_percent: 5.83
                    revenue_percent: 5.63
  /groups/compare:
    post:
      summary: Сравнение периодов по товарам группы
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - groups
      parameters:
        - name: path
          in: query
          description: Id группы
          required: true
          example: 123
          schema:
            type: integer
        - name: d11
          in: query
          description: Дата начала первого периода
          required: true
          example: '2025-01-01'
          schema:
            type: string
        - name: d12
          in: query
          description: Дата конца первого периода
          required: true
          example: '2025-02-01'
          schema:
            type: string
        - name: d21
          in: query
          description: Дата начала второго периода
          required: true
          example: '2025-02-01'
          schema:
            type: string
        - name: d22
          in: query
          description: Дата конца второго периода
          required: true
          example: '2025-03-01'
          schema:
            type: string
        - name: fbs
          in: query
          description: Учитывать данные по FBS-товарам
          required: false
          example: 1
          schema:
            type: boolean
        - name: currency
          in: query
          description: Пересчёт в валюту / Название валюты (по умолчанию "RUB")
          required: false
          example: USD
          schema:
            type: string
        - name: currency_rate
          in: query
          description: Пересчёт в валюту / Курс
          required: false
          example: 100
          schema:
            type: integer
        - name: filters
          in: query
          description: Фильтры
          required: false
          schema:
            type: array
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Данные по товарам за выбранные периоды
          content:
            application/json:
              example:
                startRow: 0
                endRow: 200
                total: 10043800
                data:
                  - id: 1592320262
                    name: Футболка GoldenCate-I внуки
                    brand: GoldenCate-I
                    seller: GoldenCate-I
                    seller_id: 1882627
                    sales_1: 0
                    sales_2: 0
                    revenue_1: 0
                    revenue_2: 0
                    days_in_stock_1: 0
                    days_in_stock_2: 0
                    price_1: 1522
                    price_2: 1582
                    avg_price_1: 2179.17
                    avg_price_2: 1612.57
                    sales_diff: 0
                    revenue_diff: 0
                    days_in_stock_diff: 0
                    price_diff: 60
                    avg_price_diff: -566.6
                    thumb: https://cdn1.ozone.ru/s3/multimedia-1-n/7043160515.jpg
                  - id: 640524872
                    name: Платье пляжное
                    brand: ''
                    seller: самый быстрый, лучший, дешевый
                    seller_id: 281568
                    sales_1: 0
                    sales_2: 0
                    revenue_1: 0
                    revenue_2: 0
                    days_in_stock_1: 0
                    days_in_stock_2: 0
                    price_1: 706
                    price_2: 740
                    avg_price_1: 711.17
                    avg_price_2: 707.87
                    sales_diff: 0
                    revenue_diff: 0
                    days_in_stock_diff: 0
                    price_diff: 34
                    avg_price_diff: -3.3
                    thumb: https://cdn1.ozone.ru/s3/multimedia-t/6093784529.jpg
                summary:
                  sales_1: 20551030
                  sales_2: 22862898
                  revenue_1: 30366243940
                  revenue_2: 36120196612
                  sales_diff: 2311868
                  revenue_diff: 5753952672
  /groups/feedback/comments:
    post:
      summary: Отзывы на товары группы
      description: >
        [Документация по параметрам тела
        запроса](/integrations/docs/body-parameters)
      tags:
        - groups
      parameters:
        - name: path
          in: query
          description: ID группы
          required: true
          example: 265906486
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
        - name: startRow
          in: query
          description: >-
            С какой строки вернуть данные (пагинация - "от .."). По умолчанию,
            0.
          required: false
          example: 100
          schema:
            type: integer
        - name: endRow
          in: query
          description: >-
            До какой строки вернуть данные (пагинация - "до .."). По умолчанию,
            100.
          required: false
          example: 200
          schema:
            type: integer
        - name: filterModel
          in: query
          description: Фильтры по колонкам таблицы
          required: false
          schema:
            type: array
        - name: sortModel
          in: query
          description: Сортировка данных по колонке и направлению
          required: false
          schema:
            type: array
        - name: fields
          in: query
          description: Список полей для отображения / экспорта
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Отзывы пользователей(я)
          content:
            application/json:
              example:
                startRow: 0
                endRow: 200
                total: 2673
                data:
                  - id: 1916581720
                    name: Купальник слитный SVYATAYA
                    thumb: https://ir.ozone.ru/s3/multimedia-1-q/7385504750.jpg
                    seller_name: СВЯТАЯ
                    seller_id: 142329
                    brand_name: SVYATAYA
                    date: '2025-11-25'
                    valuation: 3
                    likes: 0
                    text: Не держится на груди
                  - id: 1916584186
                    name: Купальник слитный SVYATAYA
                    thumb: https://ir.ozone.ru/s3/multimedia-1-q/7385504750.jpg
                    seller_name: СВЯТАЯ
                    seller_id: 142329
                    brand_name: SVYATAYA
                    date: '2025-11-25'
                    valuation: 5
                    likes: 0
                    text: ''
                  - id: 1916584899
                    name: Купальник слитный SVYATAYA
                    thumb: https://ir.ozone.ru/s3/multimedia-1-f/7385504631.jpg
                    seller_name: СВЯТАЯ
                    seller_id: 142329
                    brand_name: SVYATAYA
                    date: '2025-11-20'
                    valuation: 5
                    likes: 0
                    text: купальник идеалный
  /groups/feedback/comments/stats:
    get:
      summary: Статистика по отзывам на товары группы
      tags:
        - groups
      parameters:
        - name: path
          in: query
          description: ID группы
          required: true
          example: 265906486
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
      responses:
        '200':
          description: Статистика по отзывам
          content:
            application/json:
              example:
                count: 127154
                count_negative: 5812
                negative_percent: 4.57
                avg_valuation: 4.8
  /groups/feedback/comments/graph:
    get:
      summary: Статистика по отзывам по дням на товары группы
      tags:
        - groups
      parameters:
        - name: path
          in: query
          description: ID группы
          required: true
          example: 265906486
          schema:
            type: integer
        - name: d1
          in: query
          description: Дата начала отчёта
          required: false
          example: '2025-01-01'
          schema:
            type: string
        - name: d2
          in: query
          description: Дата конца отчёта
          required: false
          example: '2025-01-31'
          schema:
            type: string
      responses:
        '200':
          description: Статистика по дням
          content:
            application/json:
              example:
                - date: '2025-05-27'
                  count: 2055
                  count_negative: 607
                  count_with_text: 609
                  count_negative_with_text: 93
                  avg_valuation: 4.03
                - date: '2025-05-28'
                  count: 2169
                  count_negative: 695
                  count_with_text: 670
                  count_negative_with_text: 105
                  avg_valuation: 3.92
                - date: '2025-05-29'
                  count: 2029
                  count_negative: 714
                  count_with_text: 620
                  count_negative_with_text: 124
                  avg_valuation: 3.85
  /groups/feedback/comments/ai_recommendations:
    get:
      summary: AI рекомендации по отзывам на товары группы
      tags:
        - groups
      parameters:
        - name: path
          in: query
          description: ID группы
          required: true
          example: 265906486
          schema:
            type: integer
      responses:
        '200':
          description: AI рекомендации
          content:
            application/json:
              example:
                id: 19b36ac20ac2970db60f113c23c27a76
                status: 10
                data:
                  pain_points:
                    - topic: Просвечивание ткани
                      description: >-
                        Покупатели жалуются, что материал топа слишком тонкий и
                        сильно просвечивает, что делает изделие непригодным для
                        ношения без подкладки.
                      solution: >-
                        Использовать более плотную или многослойную ткань,
                        протестировать материал на просвечивание при разных
                        условиях освещения.
                    - topic: Несоответствие цены качеству
                      description: >-
                        Клиенты отмечают, что качество изделия не оправдывает
                        его стоимости, что снижает доверие к бренду.
                      solution: >-
                        Провести анализ себестоимости и уровня восприятия цены,
                        возможно, скорректировать цену или повысить качество
                        материалов и пошива.
                    - topic: Разочарование ожиданий
                      description: >-
                        Отзыв с низкой оценкой указывает, что товар не
                        соответствует ожиданиям пользователя по изображению или
                        описанию.
                      solution: >-
                        Пересмотреть описание и фотографии товара, добавить
                        реальные фото на модели при разном освещении и в разных
                        позах.
                  advantages:
                    - topic: Современный дизайн
                      description: >-
                        Из отзыва следует, что изделие привлекательно визуально
                        (есть интерес к покупке топа несмотря на недостатки).
                      solution: >-
                        Сохранить стиль, но усилить функциональность за счёт
                        выбора качественных материалов.
                    - topic: Лёгкость материала
                      description: >-
                        Ткань, вероятно, тонкая и приятная на ощупь, что оценят
                        в жаркое время года.
                      solution: >-
                        Оставить лёгкость как характеристику, но добавить
                        плотную подкладку или продумать двойной слой в зонах,
                        где просвечивание критично.
                    - topic: Минималистичный стиль
                      description: >-
                        Топ, судя по отзыву, имеет простой дизайн, что
                        соответствует модным трендам.
                      solution: >-
                        Подчеркнуть минимализм в маркетинговых материалах, делая
                        акцент на универсальности и сочетании с другими вещами.
  /keywords/frequency:
    get: &ref_1
      summary: Частотность поискового запроса
      tags:
        - keywords
      parameters:
        - name: keyword
          in: query
          description: Поисковый запрос
          required: true
          example: ботинки
          schema:
            type: string
      responses:
        '200':
          description: Частотности запроса по датам
          content:
            application/json:
              example:
                - date: '2026-02-16'
                  frequency: 70406
                - date: '2026-02-09'
                  frequency: 69635
                - date: '2026-02-02'
                  frequency: 68277
  /keywords/wb-frequency:
    get: *ref_1
components:
  schemas:
    item:
      type: object
      properties:
        id:
          description: ID (SKU) товара
          type: integer|string
        name:
          description: Название товара
          type: string
        brand:
          description: Бренд
          type: object
          properties:
            id:
              description: ID бренда
              type: integer
            name:
              description: Название бренда
              type: string
        seller:
          description: Продавец
          type: object
          properties:
            id:
              description: ID продавца
              type: integer
            name:
              description: Название продавца
              type: string
        thumb:
          description: Ссылка на картинку
          type: string
    groups:
      type: object
      properties:
        groups:
          description: Список групп
          type: array
          items:
            type: object
            properties:
              id:
                description: ID группы
                type: integer
              name:
                description: Название группы
                type: string
        defaultGroup:
          description: ID группы по умолчанию
          type: integer
    groups.put:
      type: object
      properties:
        success:
          description: Статус операции
          type: boolean
        id:
          description: ID новой группы
          type: integer
    groups.stats:
      type: array
      items:
        type: object
        properties:
          id:
            description: ID группы
            type: integer
          name:
            description: Название группы
            type: string
          created:
            description: Дата создания
            type: string
          updated:
            description: Дата обновления
            type: string
          on_main:
            description: Наличие на главной
            type: boolean
          archived:
            description: Группа в архиве
            type: boolean
          items_count:
            description: Количество товаров в группе
            type: integer
          items_count_in_period:
            description: Количество товаров в группе за период
            type: integer
          sales:
            description: Продажи в группе
            type: integer
          revenue:
            description: Выручка в группе
            type: integer
          count_brands:
            description: Количество брендов в группе
            type: integer
          count_sellers:
            description: Количество продавцов в группе
            type: integer
          graph:
            description: График продаж в группе
            type: array
            items:
              type: integer
    groups.id:
      type: object
      properties:
        id:
          description: ID группы
          type: integer
        name:
          description: Название группы
          type: string
        created:
          description: Дата создания
          type: string
        updated:
          description: Дата обновления
          type: string
        on_main:
          description: Наличие на главной
          type: boolean
        archived:
          description: Группа в архиве
          type: boolean
    success:
      type: object
      properties:
        success:
          description: Успешность операции
          type: boolean
