Technical Deep Dive: 1688.com Product Detail API - Full Guide & Standard JSON Re

原创

Anzexi58

发布于 2026-09-23 16:49:12

830

Introduction

1688.com, Alibaba’s flagship B2B wholesale marketplace, serves as the core supply chain hub for millions of global retailers, dropshippers, and enterprise procurement teams. Unlike consumer-facing e-commerce platforms, its open API ecosystem is purpose-built for bulk product sourcing, tiered price negotiation, supplier management, and automated B2B order fulfillment. The official product detail interface (part of the 1688 Open Platform suite) is the foundational technical gateway that enables third-party ERP systems, sourcing tools, and cross-border reselling platforms to access structured, real-time wholesale product data. This guide breaks down the full technical architecture, mandatory request parameters, and provides a production-grade standard JSON response reference to help developers build stable, compliant 1688 data integration pipelines.

1. Core Interface Basic Information

The 1688 Product Detail API is a production-grade RESTful service hosted on Alibaba’s B2B open platform infrastructure, optimized for high-frequency industrial and wholesale business scenarios.

Item	Specification
Official API Name	alibaba.product.get (Get Full Wholesale Product Details)
Communication Protocol	HTTPS POST (Recommended) / GET
Default Data Format	JSON (XML is supported for legacy enterprise ERP systems)
Official Gateway Endpoint	https://gw.open.1688.com/openapi
Authentication Mechanism	AppKey + AppSecret + OAuth 2.0 AccessToken + HMAC-SHA1 Signature
Typical Use Cases	Wholesale product sourcing, tiered price monitoring, supplier qualification verification, dropshipping inventory synchronization, cross-border e-commerce product listing automation

2. Full Request Parameter Breakdown

Calling this API strictly follows 1688 Open Platform’s proprietary signature specification. All non-empty parameters must be sorted lexicographically and encrypted with the AppSecret to generate a valid, tamper-proof signature value.

2.1 Mandatory Public Gateway Parameters

These parameters are required for every 1688 API call, used for platform authentication, permission validation and request tracing:

Parameter Name	Type	Required	Description
app_key	String	Yes	Unique application identifier, obtained after enterprise developer verification on 1688 Open Platform
method	String	Yes	Fixed asalibaba.product.getto specify the target product detail interface
access_token	String	Yes	OAuth 2.0 authorized token, which carries the requester’s permission scope (public data / enterprise exclusive price)
timestamp	String	Yes	East 8 timezone timestamp formatted asyyyy-MM-dd HH:mm:ss, used to prevent replay attacks
v	String	Yes	API protocol version, the current stable production version is2.0
sign_method	String	Yes	Signature algorithm,hmac-sha1is the platform standard for all B2B interfaces
sign	String	Yes	Final encrypted signature value generated by AppSecret and sorted parameters

2.2 Business Core Parameters

These parameters control the granularity and scope of the wholesale product data returned:

Parameter Name	Type	Required	Description
productId	Long	Yes	1688 unique product ID (Offer ID), extracted directly from the product detail page URL
fields	String	Yes	Custom return field list, for exampleproductId,title,price,sku,supplier. Explicitly specifying required fields can reduce response latency by over 40%
needCargoInfo	Boolean	No	Defaultfalse. Set totrueto return real-time warehouse stock distribution and logistics delivery information
includeExclusivePrice	Boolean	No	Defaultfalse. Only authorized enterprise buyers can set this totrueto view negotiated exclusive contract prices

3. Standard Production JSON Response Reference

Below is a standard full JSON response that strictly follows 1688’s official B2B interface return specification. This structure includes all unique high-value wholesale business fields, and can be directly used for debugging and enterprise ERP system docking:

Use the website: o0b.cn/anzexi

{
  "alibaba_product_get_response": {
    "code": 0,
    "msg": "success",
    "request_id": "1688_req_20260918102233456",
    "data": {
      "product_id": 678901234567,
      "subject": "Factory Direct 1000W Portable Outdoor Power Station 220V Solar Generator for Camping",
      "supplier_info": {
        "member_id": "123456789",
        "company_name": "Shenzhen New Energy Tech Co., Ltd.",
        "supplier_level": "A+",
        "gold_supplier_years": 8,
        "transaction_rate": "98.5%",
        "main_industry": "Portable Power Station"
      },
      "price_info": {
        "unit": "piece",
        "currency": "CNY",
        "price_tiers": [
          {"min_quantity": 1, "max_quantity": 9, "price": "689.00"},
          {"min_quantity": 10, "max_quantity": 99, "price": "620.00"},
          {"min_quantity": 100, "max_quantity": null, "price": "550.00"}
        ],
        "exclusive_contract_price": "520.00",
        "moq": 1
      },
      "stock_info": {
        "total_available_stock": 15600,
        "stock_status": "instock",
        "warehouse_distribution": [
          {"warehouse_code": "SZ001", "location": "Shenzhen", "stock": 9200, "lead_time_hours": 48},
          {"warehouse_code": "GZ002", "location": "Guangzhou", "stock": 6400, "lead_time_hours": 72}
        ]
      },
      "product_attrs": [
        {"attribute_name": "Battery Capacity", "attribute_value": "1024Wh"},
        {"attribute_name": "Rated Power", "attribute_value": "1000W"},
        {"attribute_name": "Interface Type", "attribute_value": "USB-A / Type-C / AC Outlet"},
        {"attribute_name": "Certification", "attribute_value": "CE, FCC, RoHS, PSE"}
      ],
      "sku_list": [
        {
          "sku_id": 987654321001,
          "specification": "Standard Version (No Solar Panel)",
          "sku_price": "689.00",
          "sku_stock": 8600
        },
        {
          "sku_id": 987654321002,
          "specification": "Pro Version (With 100W Solar Panel)",
          "sku_price": "899.00",
          "sku_stock": 7000
        }
      ],
      "media_resources": {
        "main_image": "https://cbu01.alicdn.com/img/ibank/2026/xxx/1.jpg",
        "image_gallery": [
          "https://cbu01.alicdn.com/img/ibank/2026/xxx/1.jpg",
          "https://cbu01.alicdn.com/img/ibank/2026/xxx/2.jpg",
          "https://cbu01.alicdn.com/img/ibank/2026/xxx/3.jpg"
        ],
        "detail_video": "https://cloud.video.1688.com/play/xxx.mp4"
      },
      "trade_info": {
        "payment_terms": "T/T, L/C, Alibaba Trade Assurance",
        "shipping_terms": "FOB Shenzhen",
        "supply_capability": "50000 pieces / Month",
        "customization_support": true
      }
    }
  }
}

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

api-key