Product detail API

POST /v1/products/detail — fetch full product detail for checkout integration (SKU matrix, prices, stock).

Related: Product response models · Procurement mapping

Request body

Pass search id back as id. Do not put Taobao id into product_id — that field is the numeric item_id.

Taobao id / mi_id rotates periodically. Do not cache it long-term. Stale ids break detail, similar products, and order lines[].id. Re-fetch from search or detail before checkout.

Examples

Taobao id (same as search id / mi_id):

POST /v1/products/detail
{
  "channel": "taobao",
  "id": "0000Z-4oyqr-mVcYGcXO2JuqXweqkWsUCCNOt5pXct7_TgY",
  "language": "en"
}

Taobao口令:

POST /v1/products/detail
{
  "channel": "taobao",
  "tao_password": "￥abc123￥ 复制这条信息...",
  "language": "en"
}

1688 id (same as search id / offerId):

POST /v1/products/detail
{
  "channel": "1688",
  "id": "554456348334",
  "language": "en"
}

1688 offer id:

POST /v1/products/detail
{
  "channel": "1688",
  "product_id": "554456348334",
  "language": "en"
}

Response

StandardProductDetail wrapped as { "product": { ... }, "request_id": "req_..." } — see Product response models.

Variant selection

Build checkout UI from product.variants[] — see integration pattern.