カタログAPI2026-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

販売しているすべてのバリエーション、または1商品のもの。

スコープ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}

最後に読み取った時点のバリエーション1つ。これを読んでもマーケットプレイスは再読み込みされません。

スコープ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"
}