Taobao & 1688 Product API Technical Overview and JSON Response Reference

Taobao & 1688 Product API Technical Overview and JSON Response Reference

1. Topic Overview

This article introduces the official Taobao and 1688 product detail API capabilities from an enterprise technical perspective. It covers API core functions, standard request rules, business application scenarios, and standard JSON data return structure. The API is widely used for commodity synchronization, store inventory management, price monitoring, cross-platform distribution, and e-commerce data analysis.

2. API Introduction

The Taobao / 1688 Product API is an official open interface provided by the Taobao Open Platform (TOP). It allows developers and enterprises to obtain standardized structured product data through formal authentication and signature verification.

Common official API methods:

• taobao.item.get: Obtain basic product details
• taobao.item.get_full: Obtain full product data (SKU, images, description, promotion)
• taobao.items.onsale.get: Get all on-sale products from a store
• 1688.item.get: Get 1688 wholesale product information

3. Core Technical Features

• Protocol: HTTPS
• Data format: JSON / XML (JSON is recommended for enterprise development)
• Authentication: AppKey + AppSecret MD5 signature verification
• Data feature: structured, standardized, stable version iteration
• Access control: QPS limit, frequency control, official traffic protection

4. Enterprise Application Scenarios

• Cross-store and cross-platform product distribution (dropshipping)
• Enterprise ERP commodity data synchronization
• Real-time price and inventory monitoring system
• Competitor product data analysis
• E-commerce big data statistics and automated report generation

5. Standard JSON Return Reference (Enterprise Version)

The following is the universal standard JSON response structure for Taobao and 1688 product detail API, including core fields required for enterprise development.

{
  "item_get_response": {
    "item": {
      "num_iid": "680123456789",
      "title": "2026 Summer New Casual Cotton Short Sleeve T-shirt",
      "price": "89.00",
      "promotion_price": "59.00",
      "num": 520,
      "sales": 12580,
      "cid": 50015261,
      "category_name": "Women's Clothing > T-shirt",
      "pic_url": "https://img.taobao.com/xxx.jpg",
      "location": "Guangdong, Guangzhou",
      "nick": "Official Flagship Store",
      "modified_time": "2026-05-20 15:30:10",
      "sku_list": {
        "sku": [
          {
            "sku_id": "123456789001",
            "properties_name": "White / L",
            "price": "59.00",
            "quantity": 120
          },
          {
            "sku_id": "123456789002",
            "properties_name": "Black / XL",
            "price": "59.00",
            "quantity": 95
          }
        ]
      }
    },
    "request_id": "2026052015301000123"
  }
}

6. Core Field Explanation

• num_iid: Unique product ID, the primary key for data synchronization
• title: Product official title
• price / promotion_price: Original price and discount price
• num: Current stock quantity
• sales: Cumulative sales volume
• pic_url: Main product image URL
• sku_list: Multi-specification price and inventory data
• modified_time: Last update time for incremental synchronization
• request_id: Full-link tracking ID for error troubleshooting

7. Enterprise Stability Guarantee Strategy

• Control QPS frequency to avoid platform flow restriction
• Retry mechanism for network timeout and 5xx errors
• Strict data validation for price, stock and fields
• Redis cache optimization to reduce API pressure
• Incremental update based on modified_time
• Full log recording and abnormal alarm monitoring

8. Summary

Taobao and 1688 Product API provides stable, standardized, and official compliant e-commerce commodity data services. It is the core data source for enterprise-level e-commerce systems, including commodity synchronization, distribution business, price monitoring, and data analysis. With standardized request logic, data verification, caching and flow control strategies, developers can ensure long-term stable operation of production-level business systems.