---
title: "Taobao and Tmall API Docs &amp; Endpoint Directory"
description: "Taobao and Tmall marketplace product, review, search, and shop catalog data for commerce intelligence workflows."
---

# Taobao and Tmall API Docs & Endpoint Directory

Taobao and Tmall marketplace product, review, search, and shop catalog data for commerce intelligence workflows\.

## Available APIs

<div class="api-doc-table api-doc-table--platform">

| Endpoint | Method | Description |
| --- | --- | --- |
| [Product Details \(V1\)](./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\)](./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\)](./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\)](./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\)](./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\)](./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 \(V7\)](./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 Details \(V8\)](./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\)](./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\)](./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\)](./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\)](./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\)](./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\)](./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\)](./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\)](./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… |
| [Shop Product List \(V5\)](./shop-product-list-v5) | `GET` | Retrieves products from a Taobao shop by seller ID and shop ID, with optional shop-category filtering, keyword search, sorting, and page-based pagination. Use… |
| [Shop Detail \(V1\)](./shop-detail-v1) | `GET` | Retrieves a Taobao shop's homepage information, shop categories, and default product listing by seller ID and shop ID. Use it to inspect a shop and discover it… |
| [Product Search \(V1\)](./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\)](./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… |

</div>

## 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.

<div class="api-doc-table api-doc-table--platform">

| Endpoint | Method | Description |
| --- | --- | --- |
| [Product Sales \(V1\)](./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… |

</div>

