1688 APIdetail.m.1688.com ↗

{
  "type": "object",
  "fields": {
    "url": "canonical product page URL",
    "skus": "array of concrete variants {sku_id, spec, spec_values, price, discount_price, available_quantity, sale_count}",
    "price": "object: currency (CNY), min_price, max_price (numbers), display_price, unit, min_order_quantity, tiers (array of {price, min_quantity} quantity-break prices), price_type",
    "sales": "object: sale_count (number, last year), sale_count_text (display string), sale_count_period, favorite_count, visitors_7_day",
    "title": "product title",
    "images": "array of main product image URLs",
    "seller": "object: name (shop login name), company_name, registered_company_name, member_id, shop_url, service_score_text, repeat_buyer_rate_3m, is_verified_manufacturer",
    "status": "listing status, e.g. PUBLISHED",
    "reviews": "object: review_count, rating (out of 5), positive_rate_percent, impression_tags (array of {name, count})",
    "category": "object with leaf_id and leaf_name of the site category",
    "offer_id": "the product's offer id as a string",
    "shipping": "object: ships_from, shipping_fee (CNY number), shipping_fee_type, free_shipping, delivery_promise, delivery_limit_days, unit_weight_kg, buyer_protections (array of {name, description})",
    "video_url": "main product video URL or null",
    "description": "object: text (plain text or null), images (array of URLs), html (raw description HTML)",
    "sku_properties": "array of variant axes {name, values:[{name, image_url}]}",
    "specifications": "array of product attributes {name, value, values}",
    "available_quantity": "total orderable stock across SKUs"
  },
  "sample": {
    "data": {
      "url": "https://detail.1688.com/offer/1027862723893.html",
      "skus": [
        {
          "spec": "289黑色>29码内长18CM",
          "price": 36.5,
          "sku_id": "6206571579226",
          "sale_count": 0,
          "spec_values": [
            "289黑色",
            "29码内长18CM"
          ],
          "discount_price": 36.5,
          "available_quantity": 990
        }
      ],
      "price": {
        "unit": "双",
        "tiers": [
          {
            "price": 35.5,
            "min_quantity": 1
          }
        ],
        "currency": "CNY",
        "max_price": 35.5,
        "min_price": 35.5,
        "price_type": "skuPrice",
        "display_price": "35.50",
        "min_order_quantity": 1
      },
      "sales": {
        "sale_count": 324,
        "favorite_count": 136,
        "visitors_7_day": 2461,
        "sale_count_text": "300+",
        "sale_count_period": "一年内"
      },
      "title": "女童运动鞋2026新款春秋中大童跑步鞋女孩软底百搭老爹鞋儿童鞋子",
      "images": [
        "https://cbu01.alicdn.com/img/ibank/O1CN018hBw8D1ps7p4n1WDn_!!2219095015415-0-cib.jpg"
      ],
      "seller": {
        "name": "牛麦麦鞋厂",
        "shop_url": "https://shop45542c44q08h0.1688.com",
        "member_id": "b2b-222051805603625550",
        "company_name": "温岭市泽国牛麦麦鞋业商行",
        "service_score_text": "3.5分",
        "repeat_buyer_rate_3m": "53.87%",
        "registered_company_name": "温岭市泽国牛麦麦鞋业商行（个体工商户）",
        "is_verified_manufacturer": true
      },
      "status": "PUBLISHED",
      "reviews": {
        "rating": 4.2,
        "review_count": 101,
        "impression_tags": [
          {
            "name": "价格不贵",
            "count": 7
          }
        ],
        "positive_rate_percent": 79
      },
      "category": {
        "leaf_id": "125314003",
        "leaf_name": "童运动鞋"
      },
      "offer_id": "1027862723893",
      "shipping": {
        "ships_from": "浙江省台州市",
        "shipping_fee": 5,
        "free_shipping": false,
        "unit_weight_kg": 0.6,
        "delivery_promise": "承诺48小时发货",
        "buyer_protections": [
          {
            "name": "7天无理由退货",
            "description": "满足相应条件下，卖家需支持7天无理由，其中定制订单不支持“7天无理由退货”。"
          }
        ],
        "shipping_fee_type": "TEMPLATED",
        "delivery_limit_days": 2
      },
      "video_url": "https://cloud.video.taobao.com/play/u/2220518056036/p/2/e/6/t/1/530844179001.mp4",
      "description": {
        "html": "<div id=\"offer-template-0\"></div><div><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN017vh7231ps7p4nXXQX_!!2219095015415-0-cib.jpg\"/></div>",
        "text": null,
        "images": [
          "https://cbu01.alicdn.com/img/ibank/O1CN017vh7231ps7p4nXXQX_!!2219095015415-0-cib.jpg"
        ]
      },
      "sku_properties": [
        {
          "name": "颜色",
          "values": [
            {
              "name": "289黄色",
              "image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ZgGaoR1ps7p4z0D4M_!!2219095015415-0-cib.jpg"
            }
          ]
        }
      ],
      "specifications": [
        {
          "name": "鞋面材质",
          "value": "超纤",
          "values": [
            "超纤"
          ]
        }
      ],
      "available_quantity": 27597
    },
    "status": "success"
  }
}