Taobao and Tmall API Docs & Endpoint Directory
Taobao and Tmall marketplace product, review, search, and shop catalog data for commerce intelligence workflows.
Available APIs
| Endpoint | Method | Description |
|---|---|---|
| Product Details (V1) | GET | Retrieves Taobao or Tmall product details by item ID through the V1 endpoint. Use it to perform direct product lookup for catalog research, product monitoring,… |
| Product Details (V2) | GET | Retrieves Taobao or Tmall product details by item ID, including product attributes, main images and video, shop information, shipping information, and SKU pric… |
| Product Details (V3) | GET | Retrieves Taobao or Tmall product details by item ID through the V3 endpoint. Use it to perform direct product lookup for catalog research, product monitoring,… |
| Product Details (V4) | GET | Retrieves Taobao or Tmall product details by item ID through the V4 endpoint. Use it to perform direct product lookup for catalog research, product monitoring,… |
| Product Details (V5) | GET | Retrieves Taobao or Tmall product details by item ID through the V5 endpoint. Use it to perform direct product lookup for catalog research, product monitoring,… |
| Product Details (V6) | GET | Retrieves Taobao or Tmall product details by item ID through the V6 endpoint, including approximate sales, shipping fees and free-shipping status. Use it for p… |
| Product Details (V8) | GET | Retrieves Taobao or Tmall product details by item ID through the V8 endpoint, which provides accurate SKU quantity information. Use it to perform direct produc… |
| Product Details (V9) | GET | Retrieves Taobao or Tmall product details by item ID through the V9 endpoint. Use it to perform direct product lookup for catalog research, product monitoring,… |
| Product Description Images (V1) | GET | Retrieves Taobao or Tmall product description HTML and a separate list of description images by item ID. Use it to collect listing description assets for catal… |
| Product Reviews (V3) | GET | Retrieves Taobao and Tmall product reviews by item ID with page-based pagination and configurable sorting. Use it to analyze customer feedback. |
| Product Questions (V1) | GET | Retrieves the Taobao or Tmall product social feed by item ID with page-based pagination. Use it to review product questions and related discussion during custo… |
| Shop Product List (V1) | GET | Retrieves products from a Taobao or Tmall shop by seller or user ID, with page-based pagination and default or sales sorting. Use it to browse or monitor a sel… |
| Shop Product List (V2) | GET | Retrieves products from a Taobao or Tmall shop using both seller or user ID and shop ID, with page-based pagination and sorting by sales, new arrivals, credit,… |
| Shop Product List (V3) | GET | Retrieves products from a Taobao or Tmall shop by seller ID and shop ID with page-based pagination and configurable sorting, including a new-arrivals sort for… |
| Shop Product List (V4) | GET | Retrieves products from a Taobao or Tmall shop by seller ID with page-based pagination. Use it to browse or monitor a known seller's catalog across result page… |
| Product Search (V1) | GET | Searches Taobao and Tmall products by keyword with page, sort, optional Tmall-only, and inclusive price-range filters. Use it to discover products and narrow e… |
| Product Search (V2) | GET | Searches Taobao and Tmall products by keyword with page-based pagination and returns results sorted by sales. Use it to discover popular products for ecommerce… |
Removed APIs
The following endpoints have been removed from the regular catalog, but remain available for existing integrations. We recommend migrating to another version where possible.
| Endpoint | Method | Description |
|---|---|---|
| Product Details (V7) | GET | Retrieves Taobao or Tmall product details by item ID through the V7 endpoint. Use it to perform direct product lookup for catalog research, product monitoring,… |
| Product Sales (V1) | GET | Retrieves the 30-day sales count for a Taobao or Tmall product by item ID. Use it to compare recent product sales or support ecommerce monitoring and product r… |