API каталога2026-11Предпросмотр

Уровни запасов

Сколько единиц варианта можно продать прямо сейчас: запас продавца в Китае плюс всё, что вы храните на нашем складе.

Уровни меняются, когда мы заново читаем карточку или меняется ваша полка. Подпишитесь на product.out_of_stock вместо опроса.

Эндпоинты

GET/v1/inventory_levelsСписок уровней запасов
GET/v1/inventory_levels/{variant}Получение уровня запасов варианта

Объект Inventory level

variant, product, skustring: Что он считает.
seller_in_stockboolean: Может ли продавец его продать, на момент checked_at.
seller_countinteger|null: Количество у самого продавца, если карточка его показывает.
warehouse_on_handinteger: Ваши единицы на нашей полке, проверенные и сфотографированные. Заказы отправляются в первую очередь из них.
availableinteger: Что показывает ваш магазин: ваша полка плюс количество у продавца, не более 100, поскольку мы покупаем по требованию. 0, если у продавца нет товара и полка пуста или товар на паузе.
checked_atstring: Когда мы последний раз читали карточку.

inventory_level

{
  "variant": "var_41hz",
  "product": "prd_8f2k",
  "sku": "5187209554",
  "seller_in_stock": true,
  "seller_count": 812,
  "warehouse_on_hand": 24,
  "available": 124,
  "checked_at": "2026-11-04T09:12:40Z"
}

Список уровней запасов

GET/v1/inventory_levels

Все продаваемые вами варианты или варианты одного товара.

Область доступаinventory:read

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

productstring: Необязательно. ID товара.
availablestring: Необязательно. zero — для вариантов, которые ваш магазин показывает распроданными.
limit, cursor: Pagination

curl "https://www.ninjabuy.com/api/v1/inventory_levels?product=prd_8f2k" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11"

Response 200

HTTP/2 200 OK

{
  "data": [
    {
      "variant": "var_41hz",
      "product": "prd_8f2k",
      "sku": "5187209554",
      "seller_in_stock": true,
      "seller_count": 812,
      "warehouse_on_hand": 24,
      "available": 124,
      "checked_at": "2026-11-04T09:12:40Z"
    },
    {
      "variant": "var_41j0",
      "product": "prd_8f2k",
      "sku": "5187209555",
      "seller_in_stock": false,
      "seller_count": 0,
      "warehouse_on_hand": 0,
      "available": 0,
      "checked_at": "2026-11-04T09:12:40Z"
    }
  ],
  "has_more": false,
  "cursor": null
}

Получение уровня запасов варианта

GET/v1/inventory_levels/{variant}

Один вариант по последним данным. Его чтение не перечитывает маркетплейс.

Область доступаinventory:read

Параметры пути

variantstringобязательно: ID варианта.

Ошибки

Статус	Тип	Когда
404	not-found	В этом аккаунте нет такого варианта.

curl "https://www.ninjabuy.com/api/v1/inventory_levels/var_41hz" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11"

Response 200

HTTP/2 200 OK

{
  "variant": "var_41hz",
  "product": "prd_8f2k",
  "sku": "5187209554",
  "seller_in_stock": true,
  "seller_count": 812,
  "warehouse_on_hand": 24,
  "available": 124,
  "checked_at": "2026-11-04T09:12:40Z"
}