Документация API UStats

Авторизация

В каждом запросе передавайте API-ключ в заголовке:

Authorization: Bearer <ваш_токен>

Ключ создаётся в личном кабинете UStats: Профиль → блок API-ключи. Выберите проект и название ключа. Токен показывается один раз — сохраните его. Один ключ привязан к одному проекту; данные отдаются только по этому проекту.

Базовый URL

https://api.ustats.io/v1/

Все эндпоинты — GET, ответ — JSON. Пагинация: per_page (до 1000), page. Период: date_from, date_to (формат YYYY-MM-DD); максимальный диапазон — 90 дней (где применимо).

Эндпоинты

Информация о токене

Возвращает информацию о текущем токене (проект, лимиты по эндпоинтам).

Данные Wildberries (сырые таблицы)

Данные читаются из БД тенанта по проекту токена.

Заказы. Фильтры: date_from, date_to, nm_id, supplier_article.

Товары. Фильтры: nm_id, vendor_code, brand, title.

Продажи. Фильтры: date_from, date_to, nm_id, supplier_article.

Цены. Фильтры: date_from, date_to, nm_id.

Отчёт по периодам. Фильтры: date_from, date_to, nm_id, sa_name.

Остатки на складах. Фильтры: nm_id, warehouse_id, barcode.

Возвраты. Фильтры: date_from, date_to, nm_id, status.

Статистика рекламы по товарам. Фильтры: date_from, date_to, nm_id, campaign_id.

Рекламные товары. Фильтры: nm_id, campaign_id.

Платное хранение (wb_storage_items). Фильтры: date_from, date_to, nm_id, vendor_code, office_id, warehouse.

Расширенная воронка продаж (wb_sales_funnel_daily): переходы, корзина, заказы, выкупы, конверсии, WB Клуб. Фильтры: date_from, date_to, nm_id, vendor_code, brand_name, subject_name.

Данные Ozon

Данные читаются из БД тенанта по проекту токена.

Заказы. Фильтры: date_from, date_to, status, order_number, posting_number.

Товары. Фильтры: offer_id, product_id, brand.

Остатки. Фильтры: offer_id, product_id, warehouse_id.

Возвраты. Фильтры: date_from, date_to, visual_status_sys_name, product_offer_id.

Цены. Фильтры: date_from, date_to, offer_id, product_id.

Статистика рекламы. Фильтры: date_from, date_to, sku, campaign_id, search_query.

Фин отчёт о реализации (ozon_realization): комиссии, доставка, возвраты по товарам. Фильтры: report_year, report_month, date_from, date_to, offer_id, sku, product_name.

Данные МойСклад

Товары, склады и остатки из МойСклад (internal_*). Данные по проекту токена.

Товары. Фильтры: sku, barcode, name, is_active.

Склады. Фильтры: external_id, name, is_active.

Остатки. Фильтры: product_id, warehouse_id.

Лимиты

• Rate limit: ограничение запросов в минуту на один токен (значение в заголовках X-RateLimit-Limit, X-RateLimit-Remaining). При превышении — ответ 429.
• Тяжесть запроса: максимальный период (90 дней), максимальное число строк в ответе, максимальный размер страницы per_page. При нарушении — 422 с кодом PERIOD_TOO_LARGE, MAX_ROWS_EXCEEDED или PAGE_SIZE_TOO_LARGE.

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

Успех:

{"success": true, "data": [...], "meta": {"pagination": {...}}}

Ошибка:

{"success": false, "error": {"code": "...", "message": "...", "details": {...}}}