获取淘宝商品列表的接口有哪些？请求参数和响应参数说明

淘宝平台提供多种接口用于获取商品列表，不同接口适用于不同场景。以下是常见接口及其请求参数和响应参数说明：

---

1. taobao.item.search（商品搜索接口）

• 接口功能：根据关键词、类目等条件搜索商品列表。
• 请求参数：
  • q：搜索关键词（必填）。
  • cid：类目ID（可选）。
  • page：页码（可选，默认1）。
  • page_size：每页数量（可选，默认40）。
  • sort：排序方式（可选，如sale-desc按销量降序）。
  • start_price 和 end_price：价格区间（可选）。
• 响应参数：
  • items：商品列表数组。
    • num_iid：商品ID。
    • title：商品标题。
    • price：商品价格。
    • nick：卖家昵称。
    • pic_url：商品图片URL。
    • detail_url：商品详情页URL。
    • volume（部分接口）：销量。

---

2. taobao.items.onsale.get（获取店铺在售商品接口）

• 接口功能：获取指定店铺的在售商品列表。
• 请求参数：
  • nick：卖家昵称（必填）。
  • fields：返回字段（可选，如num_iid,title,price）。
  • page_no 和 page_size：分页参数（可选）。
• 响应参数：
  • items：商品列表数组。
    • num_iid：商品ID。
    • title：商品标题。
    • price：商品价格。
    • pic_url：商品图片URL。
    • detail_url：商品详情页URL。

---

3. taobao.itemcats.get（获取商品类目接口）

• 接口功能：获取淘宝商品类目树，用于辅助搜索或筛选。
• 请求参数：
  • parent_cid：父类目ID（可选，默认0表示根类目）。
  • cids：类目ID数组（可选）。
• 响应参数：
  • item_cats：类目列表数组。
    • cid：类目ID。
    • name：类目名称。
    • parent_cid：父类目ID。

---

4. taobao.item.recommend.get（商品推荐接口）

• 接口功能：根据商品ID或用户行为推荐相关商品。
• 请求参数：
  • num_iid：商品ID（必填）。
  • count：推荐数量（可选，默认10）。
• 响应参数：
  • item_recommend_list：推荐商品列表数组。
    • num_iid：商品ID。
    • title：商品标题。
    • price：商品价格。
    • pic_url：商品图片URL。

---

5. taobao.item.search.img（以图搜图接口）

• 接口功能：根据图片搜索相似商品。
• 请求参数：
  • image：图片URL或Base64编码（必填）。
  • page_no 和 page_size：分页参数（可选）。
• 响应参数：
  • items：商品列表数组。
    • num_iid：商品ID。
    • title：商品标题。
    • price：商品价格。
    • pic_url：商品图片URL。

---

注意事项

1. 权限要求：部分接口需要申请权限或使用淘宝开放平台（Taobao Open Platform, TOP）的App Key和App Secret。
2. 频率限制：淘宝API对调用频率有限制，需注意避免超限。
3. 数据准确性：接口返回的数据可能存在延迟，需结合实际业务场景处理。
4. 文档更新：淘宝API可能会更新，建议参考淘宝开放平台/万邦开放平台获取最新信息。

---

示例请求

以taobao.item.search为例，使用Python调用接口的示例代码：

python

	import requests
	url = "https://eco.taobao.com/router/rest"
	params = {
	"method": "taobao.item.search",
	"app_key": "your_app_key",
	"session": "your_session_key", # 需通过OAuth获取
	"q": "手机",
	"page": "1",
	"page_size": "10",
	"format": "json",
	"v": "2.0",
	"sign_method": "md5",
	"timestamp": "2025-01-01 12:00:00",
	}
	# 需根据淘宝开放平台文档生成签名并添加到params中
	response = requests.get(url, params=params)
	print(response.json())

---

总结

• 根据需求选择合适的接口，如搜索商品用taobao.item.search，获取店铺商品用taobao.items.onsale.get。
• 确保接口权限和调用频率合规。
• 参考官方文档获取最新参数和返回字段说明。