NinjabuyのロゴBusiness
営業に問い合わせる
カタログAPI2026-11プレビュー

インポート

出品リンクを貼り付けると、そのバリエーションと、それぞれの販売にかかる費用が返されます：商品代、出品者から当社への荷物の入庫料CN¥12.00、一律14%の税金、次に配送ルート、荷物ごとの出荷作業料CN¥50.00、それらにかかる税金、マーケットプレイス手数料、そして利益を維持する価格。
  • インポートは無料で、商品数の制限もありません。支払うのは注文した分だけです。
  • すべての数値は1個分で、単独の注文で購入し単独の荷物で発送した場合、つまりドロップシップ1件の販売です。1つの注文や荷物に複数個ある場合は、これより安くなります。
  • マーケットプレイス手数料は、既定では各マーケットプレイスの公開標準料率です。カテゴリやプランが異なる場合は独自の値を送ってください。
エンドポイント

Importオブジェクト

当社が読み取った出品と、1回の販売で購入者の手元に届くまでのコスト：商品代、出品者から当社への荷物の入庫料CN¥12.00、一律14%の税金、次に配送ルート、荷物ごとの出荷作業料CN¥50.00、それらにかかる税金。US$表示は、US$カードに請求される額（通貨換算込み）です。
idstring
imp_ で始まります。
statusstring
running（おすすめ商品シートを読み取り中）、ready、failed のいずれか。
urlstring
送ったリンク。
marketplacestring
taobao、tmall、weidian、1688 のいずれか。
title, seller, images[]string
出品者が書いたまま。多くの場合は中国語です。
read_atstring
マーケットプレイスから出品を最後に読み取った日時。
analysis.ship_to, lane, weight_g
計算に使った入力値。
analysis.coveredboolean
そのルートでその国に発送する公開料金がない場合は false。その場合、どのバリエーションにも総コストはありません。
analysis.marketplace_feeobject
percent と fixed：マーケットプレイスが販売から取る額。何も送らず当社が公開標準料率を使った場合は default が true で、見積もりであり実際の請求額ではありません。
analysis.margin_reachableboolean
手数料と利益を合わせると価格全体を占める場合は false。どの価格でも達成できません。
analysis.brand_hintobject|null
タイトルに英語または中国語のブランド名やレプリカを示す言葉が見つかりました。あくまでヒントで、判定ではありません。写真のロゴは検出できず、問題なしの結果も何の保証にもなりません。
analysis.variants[].procurementobject
1個を購入する注文の goods、intake_fee、tax、total。
analysis.variants[].seller_shippingobject|null
出品者から当社倉庫までの送料。どの出品にも記載がないため null で、無料ではなく不明という意味です。
analysis.variants[].parcelobject|null
その商品を発送する荷物の lane、shipping、handling_fee、tax、total。
analysis.variants[].landedobject
商品と荷物の合計:CN¥とUS$で表示。US$には換算手数料を含みます。
analysis.variants[].minimum_priceobject|null
マーケットプレイス手数料の後も利益を維持できる最低価格。
analysis.variants[].suggestedobject|null
最低価格以上で最も低い x.99 の価格と、それによる手数料、利益、利益率。
productstring|null
保存後になった商品。
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"
}

リンクからインポート

POST/v1/imports

Taobao、Tmall、Weidian、1688の出品（短縮リンクや他の購入代行サービスのリンクも可）を読み取り、同じ呼び出しで分析結果を返します。直近5分以内に読み取った出品は再取得しません。

おすすめ商品シートのリンク（https://www.ninjabuy.com/spreadsheets/d/…）はシート上の全商品をインポートします：202とstatus: runningが返るので、その後インポートをポーリングしてください。

スコープproducts:write

ボディ

urlstring必須
商品リンク、またはおすすめ商品シート。
ship_tostring
荷物の料金を計算する国（2文字）。省略時は US。
lanestring
saver または fast。省略時は saver。
weight_ginteger必須
1個の梱包後の重さ（グラム）。出品ページには重さがないので、荷物はあなたの値で計算されます。
marketplacestring
販売先：ebay、shopify、amazon、tiktok のいずれか。省略時は shopify。
marketplace_feeobject
任意。カテゴリやプランに合わせて、マーケットプレイスの標準料率の代わりに使う percent と fixed（US$）。
margin_percentstring
販売価格に対する目標利益率。省略時は30。

エラー

ステータスタイプ時期
400bad-bodyweight_g がないか、フィールドが範囲外です。
422unprocessable読み取れないリンクか、出品が削除されています。
429rate-limitedマーケットプレイスの枠を使い切りました。レート制限をご覧ください。
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"
}

再計算

POST/v1/imports/{id}/analysis

同じ出品を別の国、ルート、重さ、マーケットプレイス、利益率で。読み取り済みのデータで計算するので、マーケットプレイスへの呼び出しは使いません。新しい分析を返し、インポートに保存します。

スコープproducts:write

パスパラメータ

idstring必須
インポートのID。

ボディ

ship_tostring
荷物の料金を計算する国（2文字）。省略時は US。
lanestring
saver または fast。省略時は saver。
weight_ginteger必須
1個の梱包後の重さ（グラム）。出品ページには重さがないので、荷物はあなたの値で計算されます。
marketplacestring
販売先：ebay、shopify、amazon、tiktok のいずれか。省略時は shopify。
marketplace_feeobject
任意。カテゴリやプランに合わせて、マーケットプレイスの標準料率の代わりに使う percent と fixed（US$）。
margin_percentstring
販売価格に対する目標利益率。省略時は30。

エラー

ステータスタイプ時期
404not-foundこのアカウントにそのインポートはありません。
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"
      }
    }
  ]
}

インポートを取得

GET/v1/imports/{id}

インポートを再読み込みするか、実行中のおすすめ商品シートをポーリングします。

スコープproducts:read

パスパラメータ

idstring必須
インポートのID。

エラー

ステータスタイプ時期
404not-foundこのアカウントにそのインポートはありません。
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
}

インポート一覧

GET/v1/imports

新しい順。保存しなかったインポートも、後で戻れるようここに残ります。

スコープproducts:read

クエリパラメータ

statusstring
任意。running、ready、failed のいずれか。
savedboolean
任意。商品になったものは true。
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"
}

商品として保存

POST/v1/imports/{id}/save

選んだバリエーションを、設定した価格または推奨価格で商品として保存します。push_to: shopifyを加えると、同じ呼び出しでストアに出品します（Shopifyに送信）。

スコープproducts:write

パスパラメータ

idstring必須
インポートのID。

ボディ

variants[]array
任意。残す各バリエーションの sku と price。省略時は在庫のあるすべてのバリエーションを推奨価格で。
titlestring
任意。あなた自身のタイトル。出品者のものは多くの場合中国語です。
push_tostring
任意。shopify。

エラー

ステータスタイプ時期
409invalid-state保存済みです。product がその商品を示します。
422unprocessable残したすべてのバリエーションが売り切れです。
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" }]
}