Catalogus-API2026-11Preview

Imports

Plak een listinglink en krijg de varianten terug en wat het verkopen van elk je kost: de goederen, onze CN¥ 12,00 ontvangstkosten voor het pakket van de verkoper naar ons, de vaste belasting van 14%, dan de verzendlijn, de CN¥ 50,00 verwerkingskosten per pakket en de belasting daarover, de kosten van de marktplaats, en de prijs die je marge behoudt.

Importeren is gratis, zonder productlimiet. Je betaalt alleen voor wat je bestelt.
Elk bedrag geldt voor één stuk, gekocht in een eigen bestelling en verzonden in een eigen pakket: één gedropshipte verkoop. Meerdere stuks in één bestelling of één pakket kosten minder dan dit aangeeft.
Marktplaatskosten staan standaard op het openbare basistarief van elke marktplaats. Stuur je eigen tarief als je categorie of abonnement afwijkt.

Endpoints

POST/v1/importsImporteren vanuit een link
POST/v1/imports/{id}/analysisOpnieuw prijzen
GET/v1/imports/{id}Een import ophalen
GET/v1/importsImports opvragen
POST/v1/imports/{id}/saveOpslaan als product

Het Import-object

Een listing zoals wij hem lezen, met wat één verkoop kost tot aan de deur van je koper: de goederen, onze CN¥ 12,00 ontvangstkosten voor het pakket van de verkoper naar ons, de vaste belasting van 14%, dan de verzendlijn, de CN¥ 50,00 verwerkingskosten per pakket en de belasting daarover. In US$ is het wat er van een US$-kaart wordt afgeschreven, valutaconversie inbegrepen.

idstring: Begint met imp_.
statusstring: running (een vondstenspreadsheet wordt nog gelezen), ready, of failed.
urlstring: De link die je stuurde.
marketplacestring: taobao, tmall, weidian of 1688.
title, seller, images[]string: Zoals de verkoper ze schreef, meestal in het Chinees.
read_atstring: Wanneer we de listing voor het laatst van de marktplaats lazen.
analysis.ship_to, lane, weight_g: De invoer waarvoor het is geprijsd.
analysis.coveredboolean: False als geen gepubliceerd tarief op die lijn naar dat land verzendt; dan heeft geen variant totale kosten.
analysis.marketplace_feeobject: percent en fixed: wat de marktplaats van een verkoop houdt. default is true als je niets stuurde en we het openbare basistarief gebruikten, een schatting, nooit je echte rekening.
analysis.margin_reachableboolean: False als de kosten en de marge samen de hele prijs opslokken: geen prijs kan dat halen.
analysis.brand_hintobject|null: Merk- of replicawoorden in de titel, in het Engels of Chinees. Een hint, nooit een oordeel: hij ziet geen logo op een foto, en een schoon resultaat bewijst niets.
analysis.variants[].procurementobject: goods, intake_fee, tax en total van de bestelling die één stuk koopt.
analysis.variants[].seller_shippingobject|null: De verzending van de verkoper naar ons magazijn. Geen listing vermeldt die, dus hij is null: onbekend, niet gratis.
analysis.variants[].parcelobject|null: lane, shipping, handling_fee, tax en total van het pakket dat het verzendt.
analysis.variants[].landedobject: Artikel en pakket samen: in CN¥, in US$, met de omrekenkosten inbegrepen in het US$-bedrag.
analysis.variants[].minimum_priceobject|null: De laagste prijs die je marge behoudt na de marktplaatskosten.
analysis.variants[].suggestedobject|null: De laagste x,99-prijs op of boven het minimum, met de kosten, winst en marge die hij overlaat.
productstring|null: Het product dat het werd nadat het was opgeslagen.

import

{
  "id": "imp_2c9d",
  "status": "ready",
  "url": "https://weidian.com/item.html?itemID=7750970856",
  "marketplace": "weidian",
  "title": "Heavyweight washed hoodie",
  "seller": "Ruoyi Studio",
  "images": [
    "https://media.ninjabuy.com/listings/weidian-7750970856/1.webp"
  ],
  "read_at": "2026-11-04T09:12:40Z",
  "analysis": {
    "ship_to": "US",
    "lane": "saver",
    "weight_g": 180,
    "covered": true,
    "marketplace": "ebay",
    "marketplace_fee": {
      "percent": "13.6",
      "fixed": { "amount": "0.40", "currency": "USD" },
      "default": true
    },
    "margin_percent": "30",
    "margin_reachable": true,
    "brand_hint": null,
    "variants": [
      {
        "sku": "5187209554",
        "label": "Black / M",
        "in_stock": true,
        "procurement": {
          "goods": { "amount": "38.00", "currency": "CNY" },
          "intake_fee": { "amount": "12.00", "currency": "CNY" },
          "tax": { "amount": "7.00", "currency": "CNY" },
          "total": { "amount": "57.00", "currency": "CNY" }
        },
        "seller_shipping": null,
        "parcel": {
          "lane": "saver",
          "shipping": { "amount": "68.00", "currency": "CNY" },
          "handling_fee": { "amount": "50.00", "currency": "CNY" },
          "tax": { "amount": "16.52", "currency": "CNY" },
          "total": { "amount": "134.52", "currency": "CNY" }
        },
        "landed": {
          "cny": { "amount": "191.52", "currency": "CNY" },
          "usd": { "amount": "27.71", "currency": "USD" },
          "fx_fee": { "amount": "5.75", "currency": "CNY" }
        },
        "minimum_price": { "amount": "49.84", "currency": "USD" },
        "suggested": {
          "price": { "amount": "49.99", "currency": "USD" },
          "marketplace_fee": { "amount": "7.20", "currency": "USD" },
          "profit": { "amount": "15.08", "currency": "USD" },
          "margin_percent": "30.16"
        }
      },
      {
        "sku": "5187209555",
        "label": "Black / L",
        "in_stock": false,
        "procurement": {
          "goods": { "amount": "38.00", "currency": "CNY" },
          "intake_fee": { "amount": "12.00", "currency": "CNY" },
          "tax": { "amount": "7.00", "currency": "CNY" },
          "total": { "amount": "57.00", "currency": "CNY" }
        },
        "seller_shipping": null,
        "parcel": {
          "lane": "saver",
          "shipping": { "amount": "68.00", "currency": "CNY" },
          "handling_fee": { "amount": "50.00", "currency": "CNY" },
          "tax": { "amount": "16.52", "currency": "CNY" },
          "total": { "amount": "134.52", "currency": "CNY" }
        },
        "landed": {
          "cny": { "amount": "191.52", "currency": "CNY" },
          "usd": { "amount": "27.71", "currency": "USD" },
          "fx_fee": { "amount": "5.75", "currency": "CNY" }
        },
        "minimum_price": { "amount": "49.84", "currency": "USD" },
        "suggested": {
          "price": { "amount": "49.99", "currency": "USD" },
          "marketplace_fee": { "amount": "7.20", "currency": "USD" },
          "profit": { "amount": "15.08", "currency": "USD" },
          "margin_percent": "30.16"
        }
      }
    ]
  },
  "product": null,
  "created_at": "2026-11-04T09:12:41Z"
}

Importeren vanuit een link

POST/v1/imports

Leest een Taobao-, Tmall-, Weidian- of 1688-listing (een korte link, of de link van een andere inkoopagent ernaar, werkt ook) en antwoordt in dezelfde aanroep met de analyse. Een listing die we de afgelopen vijf minuten hebben gelezen, wordt niet opnieuw opgehaald.

Een link naar een vondstenspreadsheet (https://www.ninjabuy.com/spreadsheets/d/…) importeert elk product erop: 202 met status: running, en vraag daarna de import op.

Scopeproducts:write

Body

urlstringverplicht: Een productlink of een vondstenspreadsheet.
ship_tostring: Land van twee letters waarvoor het pakket wordt geprijsd. US als je het weglaat.
lanestring: saver of fast. saver als je het weglaat.
weight_gintegerverplicht: Het verpakte gewicht van één stuk, in gram. Listings hebben geen gewicht, dus het pakket wordt geprijsd op jouw gewicht.
marketplacestring: Waar je het verkoopt: ebay, shopify, amazon of tiktok. shopify als je het weglaat.
marketplace_feeobject: Optioneel. percent en fixed (US$) om te gebruiken in plaats van het basistarief van de marktplaats, voor je categorie of abonnement.
margin_percentstring: De marge waarop wordt geprijsd, van de verkoopprijs. 30 als je het weglaat.

Fouten

Status	Type	Wanneer
400	bad-body	weight_g ontbreekt, of een veld valt buiten het bereik.
422	unprocessable	Geen link die we kunnen lezen, of de listing is weg.
429	rate-limited	Het marktplaatsvenster is op; zie Rate limits.

curl -X POST "https://www.ninjabuy.com/api/v1/imports" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://weidian.com/item.html?itemID=7750970856",
    "ship_to": "US",
    "weight_g": 180,
    "marketplace": "ebay",
    "margin_percent": "30"
  }'

Response 201

HTTP/2 201 Created

{
  "id": "imp_2c9d",
  "status": "ready",
  "url": "https://weidian.com/item.html?itemID=7750970856",
  "marketplace": "weidian",
  "title": "Heavyweight washed hoodie",
  "seller": "Ruoyi Studio",
  "images": [
    "https://media.ninjabuy.com/listings/weidian-7750970856/1.webp"
  ],
  "read_at": "2026-11-04T09:12:40Z",
  "analysis": {
    "ship_to": "US",
    "lane": "saver",
    "weight_g": 180,
    "covered": true,
    "marketplace": "ebay",
    "marketplace_fee": {
      "percent": "13.6",
      "fixed": { "amount": "0.40", "currency": "USD" },
      "default": true
    },
    "margin_percent": "30",
    "margin_reachable": true,
    "brand_hint": null,
    "variants": [
      {
        "sku": "5187209554",
        "label": "Black / M",
        "in_stock": true,
        "procurement": {
          "goods": { "amount": "38.00", "currency": "CNY" },
          "intake_fee": { "amount": "12.00", "currency": "CNY" },
          "tax": { "amount": "7.00", "currency": "CNY" },
          "total": { "amount": "57.00", "currency": "CNY" }
        },
        "seller_shipping": null,
        "parcel": {
          "lane": "saver",
          "shipping": { "amount": "68.00", "currency": "CNY" },
          "handling_fee": { "amount": "50.00", "currency": "CNY" },
          "tax": { "amount": "16.52", "currency": "CNY" },
          "total": { "amount": "134.52", "currency": "CNY" }
        },
        "landed": {
          "cny": { "amount": "191.52", "currency": "CNY" },
          "usd": { "amount": "27.71", "currency": "USD" },
          "fx_fee": { "amount": "5.75", "currency": "CNY" }
        },
        "minimum_price": { "amount": "49.84", "currency": "USD" },
        "suggested": {
          "price": { "amount": "49.99", "currency": "USD" },
          "marketplace_fee": { "amount": "7.20", "currency": "USD" },
          "profit": { "amount": "15.08", "currency": "USD" },
          "margin_percent": "30.16"
        }
      },
      {
        "sku": "5187209555",
        "label": "Black / L",
        "in_stock": false,
        "procurement": {
          "goods": { "amount": "38.00", "currency": "CNY" },
          "intake_fee": { "amount": "12.00", "currency": "CNY" },
          "tax": { "amount": "7.00", "currency": "CNY" },
          "total": { "amount": "57.00", "currency": "CNY" }
        },
        "seller_shipping": null,
        "parcel": {
          "lane": "saver",
          "shipping": { "amount": "68.00", "currency": "CNY" },
          "handling_fee": { "amount": "50.00", "currency": "CNY" },
          "tax": { "amount": "16.52", "currency": "CNY" },
          "total": { "amount": "134.52", "currency": "CNY" }
        },
        "landed": {
          "cny": { "amount": "191.52", "currency": "CNY" },
          "usd": { "amount": "27.71", "currency": "USD" },
          "fx_fee": { "amount": "5.75", "currency": "CNY" }
        },
        "minimum_price": { "amount": "49.84", "currency": "USD" },
        "suggested": {
          "price": { "amount": "49.99", "currency": "USD" },
          "marketplace_fee": { "amount": "7.20", "currency": "USD" },
          "profit": { "amount": "15.08", "currency": "USD" },
          "margin_percent": "30.16"
        }
      }
    ]
  },
  "product": null,
  "created_at": "2026-11-04T09:12:41Z"
}

Opnieuw prijzen

POST/v1/imports/{id}/analysis

Dezelfde listing voor een ander land, andere lijn, ander gewicht, andere marktplaats of andere marge. Geprijsd op basis van wat we al hebben gelezen, dus het kost geen marktplaatsaanroep. Antwoordt met de nieuwe analyse en bewaart die bij de import.

Scopeproducts:write

Padparameters

idstringverplicht: De id van de import.

Body

ship_tostring: Land van twee letters waarvoor het pakket wordt geprijsd. US als je het weglaat.
lanestring: saver of fast. saver als je het weglaat.
weight_gintegerverplicht: Het verpakte gewicht van één stuk, in gram. Listings hebben geen gewicht, dus het pakket wordt geprijsd op jouw gewicht.
marketplacestring: Waar je het verkoopt: ebay, shopify, amazon of tiktok. shopify als je het weglaat.
marketplace_feeobject: Optioneel. percent en fixed (US$) om te gebruiken in plaats van het basistarief van de marktplaats, voor je categorie of abonnement.
margin_percentstring: De marge waarop wordt geprijsd, van de verkoopprijs. 30 als je het weglaat.

Fouten

Status	Type	Wanneer
404	not-found	Deze import bestaat niet op dit account.

curl -X POST "https://www.ninjabuy.com/api/v1/imports/imp_2c9d/analysis" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ship_to": "GB",
    "lane": "fast",
    "weight_g": 180,
    "marketplace": "tiktok",
    "margin_percent": "35"
  }'

Response 200

HTTP/2 200 OK

{
  "ship_to": "GB",
  "lane": "fast",
  "weight_g": 180,
  "covered": true,
  "marketplace": "tiktok",
  "marketplace_fee": {
    "percent": "6",
    "fixed": { "amount": "0.00", "currency": "USD" },
    "default": true
  },
  "margin_percent": "35",
  "margin_reachable": true,
  "brand_hint": null,
  "variants": [
    {
      "sku": "5187209554",
      "label": "Black / M",
      "in_stock": true,
      "procurement": {
        "goods": { "amount": "38.00", "currency": "CNY" },
        "intake_fee": { "amount": "12.00", "currency": "CNY" },
        "tax": { "amount": "7.00", "currency": "CNY" },
        "total": { "amount": "57.00", "currency": "CNY" }
      },
      "seller_shipping": null,
      "parcel": {
        "lane": "saver",
        "shipping": { "amount": "68.00", "currency": "CNY" },
        "handling_fee": { "amount": "50.00", "currency": "CNY" },
        "tax": { "amount": "16.52", "currency": "CNY" },
        "total": { "amount": "134.52", "currency": "CNY" }
      },
      "landed": {
        "cny": { "amount": "191.52", "currency": "CNY" },
        "usd": { "amount": "27.71", "currency": "USD" },
        "fx_fee": { "amount": "5.75", "currency": "CNY" }
      },
      "minimum_price": { "amount": "49.84", "currency": "USD" },
      "suggested": {
        "price": { "amount": "49.99", "currency": "USD" },
        "marketplace_fee": { "amount": "7.20", "currency": "USD" },
        "profit": { "amount": "15.08", "currency": "USD" },
        "margin_percent": "30.16"
      }
    },
    {
      "sku": "5187209555",
      "label": "Black / L",
      "in_stock": false,
      "procurement": {
        "goods": { "amount": "38.00", "currency": "CNY" },
        "intake_fee": { "amount": "12.00", "currency": "CNY" },
        "tax": { "amount": "7.00", "currency": "CNY" },
        "total": { "amount": "57.00", "currency": "CNY" }
      },
      "seller_shipping": null,
      "parcel": {
        "lane": "saver",
        "shipping": { "amount": "68.00", "currency": "CNY" },
        "handling_fee": { "amount": "50.00", "currency": "CNY" },
        "tax": { "amount": "16.52", "currency": "CNY" },
        "total": { "amount": "134.52", "currency": "CNY" }
      },
      "landed": {
        "cny": { "amount": "191.52", "currency": "CNY" },
        "usd": { "amount": "27.71", "currency": "USD" },
        "fx_fee": { "amount": "5.75", "currency": "CNY" }
      },
      "minimum_price": { "amount": "49.84", "currency": "USD" },
      "suggested": {
        "price": { "amount": "49.99", "currency": "USD" },
        "marketplace_fee": { "amount": "7.20", "currency": "USD" },
        "profit": { "amount": "15.08", "currency": "USD" },
        "margin_percent": "30.16"
      }
    }
  ]
}

Een import ophalen

GET/v1/imports/{id}

Lees een import opnieuw, of vraag een vondstenspreadsheet op terwijl die loopt.

Scopeproducts:read

Padparameters

idstringverplicht: De id van de import.

Fouten

Status	Type	Wanneer
404	not-found	Deze import bestaat niet op dit account.

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

Response 200

HTTP/2 200 OK

{
  "id": "imp_6t1b",
  "status": "running",
  "url": "https://www.ninjabuy.com/spreadsheets/d/1aBcD3fGh",
  "progress": { "done": 41, "total": 120 },
  "poll_after_seconds": 10
}

Imports opvragen

GET/v1/imports

Nieuwste eerst. Imports die je nooit hebt opgeslagen, blijven hier zodat je erop terug kunt komen.

Scopeproducts:read

Queryparameters

statusstring: Optioneel. running, ready of failed.
savedboolean: Optioneel. true voor de imports die producten zijn geworden.
limit, cursor: Pagination

curl "https://www.ninjabuy.com/api/v1/imports?saved=false&limit=2" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11"

Response 200

HTTP/2 200 OK

{
  "data": [
    {
      "id": "imp_2c9d",
      "status": "ready",
      "title": "Heavyweight washed hoodie",
      "product": null
    },
    {
      "id": "imp_2c7a",
      "status": "ready",
      "title": "Canvas tote, 3 colours",
      "product": null
    }
  ],
  "has_more": true,
  "cursor": "c_2c7a"
}

Opslaan als product

POST/v1/imports/{id}/save

Bewaart de varianten die je kiest als product, tegen de prijzen die je instelt of de voorgestelde. Voeg push_to: shopify toe om het in dezelfde aanroep in je winkel te zetten (Naar Shopify sturen).

Scopeproducts:write

Padparameters

idstringverplicht: De id van de import.

Body

variants[]array: Optioneel. sku en price van elke variant die je houdt. Als je het weglaat, elke variant op voorraad tegen de voorgestelde prijs.
titlestring: Optioneel. Je eigen titel; die van de verkoper is meestal in het Chinees.
push_tostring: Optioneel. shopify.

Fouten

Status	Type	Wanneer
409	invalid-state	Al opgeslagen; product noemt het.
422	unprocessable	Elke variant die je hebt gehouden, is uitverkocht.

curl -X POST "https://www.ninjabuy.com/api/v1/imports/imp_2c9d/save" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Heavyweight Washed Hoodie",
    "variants": [
      {
        "sku": "5187209554",
        "price": { "amount": "49.99", "currency": "USD" }
      }
    ],
    "push_to": "shopify"
  }'

Response 201

HTTP/2 201 Created

{
  "import": "imp_2c9d",
  "product": "prd_8f2k",
  "status": "draft",
  "channels": [{ "channel": "shopify", "status": "draft" }]
}