Ninjabuy-LogoBusiness
Vertrieb kontaktieren
Katalog-API2026-11Vorschau

Bestände

Wie viele einer Variante du gerade verkaufen kannst: der Bestand des Verkäufers in China plus alles, was du in unserem Lager hast.

Bestände ändern sich, wenn wir ein Angebot erneut lesen oder sich dein Regal bewegt. Abonniere product.out_of_stock, statt zu pollen.

Endpunkte

Das Inventory-Level-Objekt

variant, product, skustring
Was es zählt.
seller_in_stockboolean
Ob der Verkäufer es verkaufen kann, Stand checked_at.
seller_countinteger|null
Die eigene Zahl des Verkäufers, wenn das Angebot eine zeigt.
warehouse_on_handinteger
Stücke in unserem Regal, die dir gehören, geprüft und fotografiert. Bestellungen werden zuerst daraus versendet.
availableinteger
Was dein Shop zeigt: dein Regal plus die Zahl des Verkäufers, begrenzt auf 100, da wir bei Bedarf kaufen. 0, wenn der Verkäufer ausverkauft und dein Regal leer ist oder das Produkt pausiert ist.
checked_atstring
Wann wir das Angebot zuletzt gelesen haben.
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"
}

Bestände auflisten

GET/v1/inventory_levels

Jede Variante, die du verkaufst, oder die eines Produkts.

Scopeinventory:read

Query-Parameter

productstring
Optional. Eine Produkt-ID.
availablestring
Optional. zero für die Varianten, die dein Shop als ausverkauft zeigt.
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
}

Den Bestand einer Variante abrufen

GET/v1/inventory_levels/{variant}

Eine Variante, wie zuletzt gelesen. Das Abrufen liest den Marktplatz nicht erneut.

Scopeinventory:read

Pfadparameter

variantstringerforderlich
Eine Varianten-ID.

Fehler

StatusTypWann
404not-foundKeine solche Variante in diesem Konto.
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"
}