Skip to main content
Taobao and Tmall together are China’s largest marketplace, and for an agent outside Alibaba’s ecosystem they are nearly sealed: the open platform wants a registered Chinese business and app approval, and the storefront demands a login before it shows a search result. Through AgentKey your agent reads public Taobao and Tmall data the same way it reads everything else — find_tools, describe_tool, execute_tool — across both storefronts in one place.

​
What you can ask

  • “淘宝搜 ‘无线降噪耳机’，价格 200 到 500，只看天猫，按销量排序。”
  • “这个淘宝商品的评价怎么样？差评主要集中在哪些问题？”
  • “Pull the details for this Tmall item and tell me the price and the seller.”
  • “What are buyers asking about this product, and what does the discussion say?”
  • “List everything this Taobao seller is selling, sorted by sales.”
  • “Find the cheapest Tmall listings for this phone model and compare them side by side.”

​
What’s covered

Search
  • Keyword search across Taobao and Tmall with page and sort controls
  • A Tmall-only switch and an inclusive price range
Product details
  • Details for a Taobao or Tmall item by item ID — several versions of the lookup are listed and act as siblings, so one unhealthy route is not the end
Reviews & Q&A
  • Product reviews by item ID, paginated and sortable
  • The product’s social feed — buyer questions and related discussion — for customer-concern research
Shops
  • A seller’s products by seller or user ID, paginated, in default or sales order

​
How to use it

Pass the request in plain language and let the router pick the tool:
Prices come back in yuan, as the listing shows them, not converted. Aliases resolve (淘宝, 天猫, Taobao and Tmall all land here). Always describe_tool before executing: it shows which identifier each operation expects (item ID, seller ID or user ID), the sort and filter options, and the per-call cost.
Building with code? The same capability is available as fixed-contract Scenario Methods with automatic provider failover: ecommerce.taobao.product.search, ecommerce.taobao.product.get, ecommerce.taobao.product.reviews, ecommerce.taobao.shop.products.

​
FAQ

No. AgentKey holds the upstream access; your agent only needs your AgentKey subscription.
Yes. Search spans both and has a Tmall-only switch; details, reviews, buyer questions and shop listings work with an item, seller or user ID from either storefront.
Every call goes to the platform at request time; nothing is served from a stale archive. A price is what the listing shows at that moment, in yuan.