×

淘宝 1688

淘宝全量商品详情 API 接口使用文档

admin admin 发表于2026-01-13 11:00:03 浏览25 评论0

抢沙发发表评论

淘宝商品详情 API 的抓取范围,核心取决于接口类型(开放平台 / 淘宝客)、账号权限(个人 / 企业)、字段指定(fields 参数),以下按 “可抓取范围 + 权限差异 + 不可抓取内容 + 实战要点” 四部分,给出清晰、可复用的总结。


淘宝开放平台的item_get接口是获取商品详情的核心工具,广泛应用于电商分析、比价系统、商品监控等场景。本文将从接口基础、对接流程、高级技巧到最佳实践,全面讲解如何高效对接该接口。

一、接口基础认知

  1. 接口功能:item_get用于获取淘宝商品的详细信息,包括标题、价格、库存、规格、图片、销量、卖家信息等。

  2. 接口地址:正式环境:https://eco.taobao.com/router/rest

  3. 沙箱环境:https://gw-api.tbsandbox.com/router/rest(测试用)

  4. 请求方式:HTTP POST/GET

  5. 核心参数:

  • app_key:应用唯一标识

  • method:接口名称,固定为taobao.item.get

  • format:返回格式,支持jsonxml

  • v:API 版本,当前为2.0

  • sign:签名

  • num_iid:商品 ID(必填)

  • fields:需要返回的字段列表,如title,price,pics

二、对接前置准备

  1. 注册开发者账号:访问淘宝开放平台注册账号,完成实名认证。

  2. 创建应用:在开放平台控制台创建应用,获取app_keyapp_secret(注意保密)。

  3. 权限申请:申请item_get接口的调用权限,个人开发者和企业开发者权限有所不同。

  4. 环境准备:

  • 开发语言:支持任何可发起 HTTP 请求的语言(Python/Java/PHP 等)

  • 工具:Postman(测试)、IDE(开发)

三、接口调用流程

  1. 参数组装:按接口要求组装参数,特别注意fields参数可指定返回字段,减少数据传输量。

  2. 签名生成:签名是接口安全的核心,生成规则:

  • 将所有参数(除 sign 外)按参数名 ASCII 排序

  • 拼接为key=value&key=value格式

  • 拼接app_secret后进行 MD5 加密

  • 加密结果转为大写即为sign

  • 发送请求:将参数通过 GET 或 POST 方式发送到接口地址。

  • 处理响应:解析返回的 JSON/XML 数据,处理可能的错误码。

  • 四、代码实现示例(Python)

    以下是使用 Python 调用item_get接口的示例代码:

    # coding:utf-8
    
    """ Compatible for python2.x and python3.x requirement: pip install requests """
    
    from __future__ import print_function
    
    import requests
    
    # 封装好API供应商demo url=o0b.cn/ibrad, wechat id:  TaoxiJd-api 复制链接获取测试
    
    # 请求示例 url 默认请求参数已经做URL编码 url = "tb/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=12345" headers = { "Accept-Encoding": "gzip",
     "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)

群贤毕至

访客