### GET /api/v2/nm-report/downloads Source: https://dev.wildberries.ru/api/swagger/yaml/ru/11-analytics.yaml Метод возвращает список отчётов с расширенной аналитикой продавца. Ответ содержит ID [созданных отчётов](/openapi/analytics#tag/Analitika-prodavca-CSV/paths/~1api~1v2~1nm-report~1downloads/post) и статусы генерации.
Лимит запросов на один аккаунт продавца: | Тип | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | --- | | Персональный | 1 мин | 3 запроса | 20 сек | 3 запроса | | Сервисный | 1 мин | 3 запроса | 20 сек | 3 запроса | | Базовый | 1 ч | 1 запрос | 1 ч | 1 запрос |
```markdown ### Parameters - **filter[downloadIds]** (array (string (uuid)), query, optional): ID отчёта ### Responses #### 200 - Успешно **NmReportGetReportsResponse** - **data** (array (object)) (required) Array items: - **id** (string (uuid)) (required): ID отчёта (example: "06eae887-9d9f-491f-b16a-bb1766fcb8d2") - **createdAt** (string) (required): Дата и время завершения генерации (example: "2024-06-26 20:05:32") - **status** (string) (required): Статус отчёта: * `WAITING` — в очереди на обработку * `PROCESSING` — генерируется * `SUCCESS —` готов * `RETRY` — ожидает повторной обработки * `FAILED` — не получилось сгенерировать, сгенерируйте повторно (example: "SUCCESS") - **name** (string) (required): Название отчёта (example: "Card report") - **size** (integer) (required): Размер отчёта, Б (example: 123) - **startDate** (string (date)) (required): Начало периода (example: "2024-06-21") - **endDate** (string (date)) (required): Конец периода (example: "2024-06-23") #### 400 - Неправильный запрос - **title** (string) (required): Заголовок ошибки - **detail** (string) (required): Детали ошибки - **requestId** (string) (required): Уникальный ID запроса - **origin** (string) (required): ID внутреннего сервиса WB #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 403 - Доступ запрещён - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/api/v2/nm-report/downloads?filter[downloadIds]=item1,item2" ``` ``` -------------------------------- ### GET /api/v2/nm-report/downloads/file/{downloadId} Source: https://dev.wildberries.ru/api/swagger/yaml/ru/11-analytics.yaml Метод возвращает отчёт с расширенной аналитикой продавца по ID [задания на генерацию](/openapi/analytics#tag/Analitika-prodavca-CSV/paths/~1api~1v2~1nm-report~1downloads/post).

Можно получить отчёт, который сгенерирован за последние 48 часов.
Отчёт будет загружен внутри архива ZIP в формате CSV.
Лимит запросов на один аккаунт продавца: | Тип | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | --- | | Персональный | 1 мин | 3 запроса | 20 сек | 3 запроса | | Сервисный | 1 мин | 3 запроса | 20 сек | 3 запроса | | Базовый | 1 ч | 1 запрос | 1 ч | 1 запрос |
```markdown ### Parameters - **downloadId** (string (uuid), path, required): ID отчёта ### Responses #### 200 - Успешно #### 400 - Неправильный запрос - **title** (string) (required): Заголовок ошибки - **detail** (string) (required): Детали ошибки - **requestId** (string) (required): Уникальный ID запроса - **origin** (string) (required): ID внутреннего сервиса WB #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 402 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) #### 403 - Доступ запрещён - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/api/v2/nm-report/downloads/file/{downloadId}" ``` ``` -------------------------------- ### API Overview: Аналитика и данные Source: https://dev.wildberries.ru/api/swagger/yaml/ru/11-analytics.yaml
Узнать больше об аналитике и данных можно в справочном центре
В разделе описаны методы получения: 1. [Воронки продаж](/openapi/analytics#tag/Voronka-prodazh) 2. [Поисковых запросов по вашим товарам](/openapi/analytics#tag/Poiskovye-zaprosy-po-vashim-tovaram) 3. [Истории остатков](/openapi/analytics#tag/Istoriya-ostatkov) 4. [Аналитики продавца в формате CSV](/openapi/analytics#tag/Analitika-prodavca-CSV) ```yaml # Аналитика и данные # Version: analytics
Узнать больше об аналитике и данных можно в справочном центре
В разделе описаны методы получения: 1. [Воронки продаж](/openapi/analytics#tag/Voronka-prodazh) 2. [Поисковых запросов по вашим товарам](/openapi/analytics#tag/Poiskovye-zaprosy-po-vashim-tovaram) 3. [Истории остатков](/openapi/analytics#tag/Istoriya-ostatkov) 4. [Аналитики продавца в формате CSV](/openapi/analytics#tag/Analitika-prodavca-CSV) # Base URL: Not specified ``` -------------------------------- ### POST /api/v2/nm-report/downloads/retry Source: https://dev.wildberries.ru/api/swagger/yaml/ru/11-analytics.yaml Метод создает повторное [задание на генерацию](/openapi/analytics#tag/Analitika-prodavca-CSV/paths/~1api~1v2~1nm-report~1downloads/post) отчёта с расширенной аналитикой продавца. Необходимо, если при генерации отчёта вы [получили статус](/openapi/analytics#tag/Analitika-prodavca-CSV/paths/~1api~1v2~1nm-report~1downloads/get) `FAILED`.
Лимит запросов на один аккаунт продавца: | Тип | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | --- | | Персональный | 1 мин | 3 запроса | 20 сек | 3 запроса | | Сервисный | 1 мин | 3 запроса | 20 сек | 3 запроса | | Базовый | 1 ч | 1 запрос | 1 ч | 1 запрос |
```markdown ### Request Body **Content-Type:** application/json ### Responses #### 200 - Успешно **NmReportRetryReportResponse** - **data** (string) (required): Уведомление, что началась повторная генерация отчёта (example: "Retry") #### 400 - Неправильный запрос - **title** (string) (required): Заголовок ошибки - **detail** (string) (required): Детали ошибки - **requestId** (string) (required): Уникальный ID запроса - **origin** (string) (required): ID внутреннего сервиса WB #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 403 - Доступ запрещён - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X POST "https://api.example.com/api/v2/nm-report/downloads/retry" \ -H "Content-Type: application/json" \ -d '"value"' ``` ``` -------------------------------- ### Schema: ProductSearchTextsRequest Source: https://dev.wildberries.ru/api/swagger/yaml/ru/11-analytics.yaml Параметры для запроса по рейтингу поисковых запросов: - `currentPeriod` — текущий период - `pastPeriod` — предыдущий период для сравнения ```markdown ## Schema: ProductSearchTextsRequest Параметры для запроса по рейтингу поисковых запросов: - `currentPeriod` — текущий период - `pastPeriod` — предыдущий период для сравнения **Type:** object - **currentPeriod** (object) (required): Текущий период - **start** (string (date)) (required): Дата начала периода. Не позднее `end`. Не ранее 365 суток от сегодня (example: "2024-02-10") - **end** (string (date)) (required): Дата окончания периода. Не ранее 365 суток от сегодня (example: "2024-02-10") - **pastPeriod** (object): Прошлый период для сравнения. Количество дней — меньше или равно `currentPeriod` - **nmIds** (array (integer)) (required): Список артикулов WB (example: [162579635,166699779]) - **topOrderBy** (string (openCard|addToCart|openToCart|orders|cartToOrder)) (required): Фильтрация по поисковым запросам, по которым больше всего: - `openCard` — перешли в карточку - `addToCart` — добавили в корзину - `openToCart` — конверсия в корзину - `orders` — заказали товаров - `cartToOrder` — конверсия в заказ (example: "openToCart") ("openCard"|"addToCart"|"openToCart"|"orders"|"cartToOrder") - **includeSubstitutedSKUs** (boolean): Показать данные по прямым запросам с [подменным артикулом](https://seller.wildberries.ru/help-center/article/A-524) (example: true) - **includeSearchTexts** (boolean): Показать данные по поисковым запросам без учёта подменного артикула (example: false) - **orderBy** (object) (required): Параметры сортировки - **field** (string (avgPosition|openCard|addToCart|openToCart|orders|cartToOrder|visibility)) (required): Поле для сортировки: - `avgPosition` — по средней позиции - `addToCart` — по добавлениям в корзину - `openCard` — по открытию карточки (переход на страницу товара) - `orders` — по количеству заказов - `cartToOrder` — по конверсии в заказ из поиска - `openToCart` — по конверсии в корзину из поиска - `visibility` — по видимости товара (example: "avgPosition") ("avgPosition"|"openCard"|"addToCart"|"openToCart"|"orders"|"cartToOrder"|"visibility") - **mode** (string (asc|desc)) (required): Порядок сортировки: - `asc` — по возрастанию - `desc` — по убыванию (example: "asc") ("asc"|"desc") - **limit** (integer) (required): Количество поисковых запросов по товару для [стандартного](https://seller.wildberries.ru/monetization/tariffs) тарифа (example: 20) ``` -------------------------------- ### Schema: Product Source: https://dev.wildberries.ru/api/swagger/yaml/ru/11-analytics.yaml Schema definition for Product ```markdown ## Schema: Product Schema definition for Product **Type:** object ``` -------------------------------- ### Schema: InventoryWbResponse Source: https://dev.wildberries.ru/api/swagger/yaml/ru/11-analytics.yaml Текущие остатки товаров на складах WB ```markdown ## Schema: InventoryWbResponse Текущие остатки товаров на складах WB **Type:** object - **items** (array (object)) (required): Остатки товаров на складах WB по размерам Array items: - **nmId** (integer (int64)) (required): Артикул WB (example: 47254354) - **chrtId** (integer (int64)) (required): ID размера (example: 91663228) - **warehouseId** (integer (int64)) (required): ID склада (example: 507) - **warehouseName** (string) (required): Название склада (example: "Коледино") - **regionName** (string) (required): Регион отгрузки (example: "Центральный") - **quantity** (integer) (required): Количество товара на складе, доступное клиентам для добавления в корзину (example: 43) - **inWayToClient** (integer) (required): В пути к клиенту (example: 14) - **inWayFromClient** (integer) (required): В пути от клиента (example: 11) ``` -------------------------------- ### POST /api/analytics/v1/stocks-report/wb-warehouses Source: https://dev.wildberries.ru/api/swagger/yaml/ru/11-analytics.yaml
Метод доступен по типам токенов: Персональный, Сервисный
Метод возвращает текущие остатки товаров на складах WB.

Данные обновляются 1 раз в 30 минут.

1 строка ответа — данные об 1 размере товара на 1 складе WB.
Лимит запросов на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 3 запроса | 20 сек | 1 запрос |
```markdown ### Request Body **Content-Type:** application/json - **nmIds** (array (integer (int64))): Артикулы WB (example: [111222333,47254354]) - **chrtIds** (array (integer (int64))): ID размеров. Используется только для указанных в массиве `nmIds` артикулов (example: [111222333,91663228]) - **limit** (integer): Количество строк в ответе (example: 250000) - **offset** (integer): Сколько элементов пропустить. Например, для значения `10` ответ начнётся с 11 элемента (example: 500000) ### Responses #### 200 - Успешно - **data** (object) (required): Текущие остатки товаров на складах WB - **items** (array (object)) (required): Остатки товаров на складах WB по размерам Array items: - **nmId** (integer (int64)) (required): Артикул WB (example: 47254354) - **chrtId** (integer (int64)) (required): ID размера (example: 91663228) - **warehouseId** (integer (int64)) (required): ID склада (example: 507) - **warehouseName** (string) (required): Название склада (example: "Коледино") - **regionName** (string) (required): Регион отгрузки (example: "Центральный") - **quantity** (integer) (required): Количество товара на складе, доступное клиентам для добавления в корзину (example: 43) - **inWayToClient** (integer) (required): В пути к клиенту (example: 14) - **inWayFromClient** (integer) (required): В пути от клиента (example: 11) #### 400 - Неправильный запрос **ErrorObject400** - **title** (string) (required): Заголовок ошибки (example: "Invalid request body") - **detail** (string) (required): Детали ошибки (example: "code=400, message=invalid: positionCluster (field required), limit (field required), offset (field required), internal=invalid: positionCluster (field required), limit (field required), offset (field required") - **requestId** (string) (required): Уникальный ID запроса (example: "fb25c9e9-cae8-52db-b68e-736c1466a3f5") - **origin** (string) (required): ID внутреннего сервиса WB (example: "analytic-open-api") #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 403 - Доступ запрещён **ErrorObject403** - **title** (string) (required): Заголовок ошибки (example: "Authorization error") - **detail** (string) (required): Детали ошибки (example: "Authorization error") - **requestId** (string) (required): Уникальный ID запроса (example: "fb25c9e9-cae8-52db-b68e-736c1466a3f5") - **origin** (string) (required): ID внутреннего сервиса WB (example: "analytic-open-api") #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X POST "https://api.example.com/api/analytics/v1/stocks-report/wb-warehouses" \ -H "Content-Type: application/json" \ -d '{ "nmIds": [ 111222333, 47254354 ], "chrtIds": [ 111222333, 91663228 ], "limit": 250000, "offset": 500000 }' ``` ``` -------------------------------- ### Schema: MainRequest Source: https://dev.wildberries.ru/api/swagger/yaml/ru/11-analytics.yaml Параметры запроса для формирования главной страницы: - `currentPeriod` — текущий период - `pastPeriod` — предыдущий период для сравнения ```markdown ## Schema: MainRequest Параметры запроса для формирования главной страницы: - `currentPeriod` — текущий период - `pastPeriod` — предыдущий период для сравнения **Type:** object - **currentPeriod** (object) (required): Текущий период - **start** (string (date)) (required): Дата начала периода. Не позднее `end`. Не ранее 365 суток от сегодня (example: "2024-02-10") - **end** (string (date)) (required): Дата окончания периода. Не ранее 365 суток от сегодня (example: "2024-02-10") - **pastPeriod** (object): Прошлый период для сравнения. Количество дней — меньше или равно `currentPeriod` - **nmIds** (array (integer (int32))): Список артикулов WB для фильтрации (example: [162579635,166699779]) - **subjectIds** (array (integer (int32))): Список ID предметов для фильтрации (example: [32,64]) - **brandNames** (array (string)): Список брендов для фильтрации (example: ["Adidas","Nike"]) - **tagIds** (array (integer (int64))): Список ID ярлыков для фильтрации (example: [3,5,6]) - **positionCluster** (string (all|firstHundred|secondHundred|below)) (required): Товары с какой средней позицией в поиске показывать в отчёте: - `all` — все - `firstHundred` — от 1 до 100 - `secondHundred` — от 101 до 200 - `below` — от 201 и ниже (example: "all") ("all"|"firstHundred"|"secondHundred"|"below") - **orderBy** (object) (required): Параметры сортировки - **field** (string (avgPosition|openCard|addToCart|openToCart|orders|cartToOrder|visibility|minPrice|maxPrice)) (required): Поле для сортировки: - `avgPosition` — по средней позиции - `addToCart` — по добавлениям в корзину - `openCard` — по открытию карточки (переход на страницу товара) - `orders` — по количеству заказов - `cartToOrder` — по конверсии в заказ из поиска - `openToCart` — по конверсии в корзину из поиска - `visibility` — по видимости товара - `minPrice` — по минимальной цене - `maxPrice` — по максимальной цене (example: "avgPosition") ("avgPosition"|"openCard"|"addToCart"|"openToCart"|"orders"|"cartToOrder"|"visibility"|"minPrice"|"maxPrice") - **mode** (string (asc|desc)) (required): Порядок сортировки: - `asc` — по возрастанию - `desc` — по убыванию (example: "asc") ("asc"|"desc") - **includeSubstitutedSKUs** (boolean): Показать данные по прямым запросам с [подменным артикулом](https://seller.wildberries.ru/help-center/article/A-524) (example: true) - **includeSearchTexts** (boolean): Показать данные по поисковым запросам без учёта подменного артикула (example: false) - **limit** (integer) (required): Количество групп товаров в ответе (example: 130) - **offset** (integer) (required): После какого элемента выдавать данные (example: 50) ``` -------------------------------- ### POST /api/v2/search-report/product/orders Source: https://dev.wildberries.ru/api/swagger/yaml/ru/11-analytics.yaml Метод формирует данные для таблицы по количеству заказов и позиций в поиске по запросам покупателя. Данные указаны в рамках периода для [запрошенного товара](/openapi/analytics#tag/Poiskovye-zaprosy-po-vashim-tovaram/paths/~1api~1v2~1search-report~1product~1search-texts/post).

Данные отчёта обновляются 1 раз в час.
Лимит запросов на один аккаунт продавца: | Тип | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | --- | | Персональный | 1 мин | 3 запроса | 20 сек | 3 запроса | | Сервисный | 1 мин | 3 запроса | 20 сек | 3 запроса | | Базовый | 1 ч | 1 запрос | 1 ч | 1 запрос |
```markdown ### Request Body **Content-Type:** application/json - **period** (object) (required): Текущий период. Максимум 7 суток - **start** (string (date)) (required): Дата начала периода. Не позднее `end`. Не ранее 365 суток от сегодня (example: "2024-02-10") - **end** (string (date)) (required): Дата окончания периода. Не ранее 365 суток от сегодня (example: "2024-02-10") - **nmId** (integer) (required): Артикул WB (example: 211131895) - **searchTexts** (array (string)) (required): Поисковые запросы. Для тарифа [Продвинутый](https://seller.wildberries.ru/monetization/tariffs) максимум — 100 (example: ["костюм","пиджак"]) ### Responses #### 200 - Успешно - **data** (object) (required) - **total** (array (ProductOrdersMetrics)) (required): Итог по товарам Array items: - **dt** (string (date)) (required): Дата сбора статистики (example: "2024-02-10") - **avgPosition** (integer) (required): Средняя позиция товара в результатах поиска (example: 10) - **orders** (integer) (required): Сколько раз товары из поиска заказали (example: 20) - **items** (array (ProductOrdersTextItem)) (required): Элементы таблицы Array items: - **text** (string) (required): Текст поискового запроса - **frequency** (integer) (required): Количество обращений с поисковым запросом - **dateItems** (array (ProductOrdersMetrics)) (required): Статистика по датам Array items: #### 400 - Неправильный запрос **ErrorObject400** - **title** (string) (required): Заголовок ошибки (example: "Invalid request body") - **detail** (string) (required): Детали ошибки (example: "code=400, message=invalid: positionCluster (field required), limit (field required), offset (field required), internal=invalid: positionCluster (field required), limit (field required), offset (field required") - **requestId** (string) (required): Уникальный ID запроса (example: "fb25c9e9-cae8-52db-b68e-736c1466a3f5") - **origin** (string) (required): ID внутреннего сервиса WB (example: "analytic-open-api") #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 402 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) #### 403 - Доступ запрещён **ErrorObject403** - **title** (string) (required): Заголовок ошибки (example: "Authorization error") - **detail** (string) (required): Детали ошибки (example: "Authorization error") - **requestId** (string) (required): Уникальный ID запроса (example: "fb25c9e9-cae8-52db-b68e-736c1466a3f5") - **origin** (string) (required): ID внутреннего сервиса WB (example: "analytic-open-api") #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X POST "https://api.example.com/api/v2/search-report/product/orders" \ -H "Content-Type: application/json" \ -d '{ "period": "value", "nmId": 211131895, "searchTexts": [ "костюм", "пиджак" ] }' ``` ```