淘宝开放平台API实战：商品详情获取接口(item_get)开发指南

技术袁-商品详情API接口

于 2025-04-22 16:46:50 发布

阅读量979

点赞数 23

文章标签：淘宝详情淘宝详情抓取淘宝爬虫淘宝详情接口淘宝详情页抓取抖音商品详情接口拼多多商品详情接口

本文链接：https://blog.csdn.net/m0_56020426/article/details/147424993

版权

一、前言：淘宝开放平台API概述

淘宝开放平台为开发者提供了丰富的API接口，其中商品详情接口(item_get)是最基础也是最常用的接口之一。通过该接口，开发者可以获取淘宝商品的详细信息，包括标题、价格、销量、描述、图片等关键数据。

本文将详细介绍如何使用淘宝开放平台的item_get接口，包含接口申请、参数说明、请求示例以及返回数据处理等内容，帮助开发者快速集成淘宝商品数据到自己的应用中。

欢迎工作室来对接,获取一次低至2-3厘

二、准备工作

1. 申请淘宝开放平台开发者账号

在开始之前，您需要：

注册淘宝开放平台账号(https://open.taobao.com)
创建应用，获取App Key和App Secret
申请相应的API权限

2. 了解接口权限

item_get接口属于淘宝客API，需要申请"淘宝客-商品"相关权限才能调用。普通开发者每日有调用次数限制，企业开发者可根据需求申请更高配额。

三、接口详解

1. 接口基本信息

接口名称：taobao.item.get
请求方式：HTTP GET/POST
返回格式：JSON/XML
接口文档：官方文档地址(需登录开放平台查看)

2. 请求参数说明

参数名	类型	是否必须	描述
method	String	是	API接口名称，固定值：taobao.item.get
app_key	String	是	应用Key
session	String	可选	用户授权后的session
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss
format	String	否	返回格式，默认JSON
v	String	是	API协议版本，当前为2.0
sign_method	String	是	签名方式，支持md5,hmac
sign	String	是	API输入参数签名结果
num_iid	Long	是	商品数字ID
fields	String	是	需返回的字段列表

3. 常用返回字段

{
    "item": {
        "num_iid": "商品数字ID",
        "title": "商品标题",
        "price": "商品价格",
        "pic_url": "商品主图",
        "desc": "商品描述",
        "sales": "销量",
        "sku": "SKU信息",
        "props": "商品属性",
        "item_imgs": "商品图片列表",
        "shop_info": "店铺信息"
    }
}

四、代码实现示例

1. Python调用示例

```python
import requests
import hashlib
import time
import urllib.parse

class TaobaoAPI:
    def __init__(self, app_key, app_secret):
        self.app_key = app_key
        self.app_secret = app_secret
        self.gateway = 'https://eco.taobao.com/router/rest'
    
    def _generate_sign(self, params):
        # 参数按key排序
        sorted_params = sorted(params.items(), key=lambda x: x[0])
        # 拼接字符串
        query_string = self.app_secret
        for k, v in sorted_params:
            query_string += k + str(v)
        query_string += self.app_secret
        # MD5加密
        return hashlib.md5(query_string.encode('utf-8')).hexdigest().upper()
    
    def get_item(self, num_iid, fields='num_iid,title,price,pic_url,desc,sales'):
        params = {
            'method': 'taobao.item.get',
            'app_key': self.app_key,
            'timestamp': time.strftime('%Y-%m-%d %H:%M:%S'),
            'format': 'json',
            'v': '2.0',
            'sign_method': 'md5',
            'num_iid': num_iid,
            'fields': fields
        }
        
        # 生成签名
        params['sign'] = self._generate_sign(params)
        
        # 发送请求
        response = requests.get(self.gateway, params=params)
        return response.json()

# 使用示例
if __name__ == '__main__':
    app_key = '您的AppKey'
    app_secret = '您的AppSecret'
    taobao = TaobaoAPI(app_key, app_secret)
    
    # 获取商品详情，示例商品ID
    result = taobao.get_item('602344678912')
    print(result)
```

使用示例

if name == '__main__':

app_key = '您的AppKey'

app_secret = '您的AppSecret'

taobao = TaobaoAPI(app_key, app_secret)

# 获取商品详情，示例商品ID

result = taobao.get_item('602344678912')

print(result)

2. Java调用示例

```java
import org.apache.commons.codec.digest.DigestUtils;
import org.apache.http.HttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

import java.io.IOException;
import java.util.*;

public class TaobaoItemApi {
    
    private String appKey;
    private String appSecret;
    private String gateway = "https://eco.taobao.com/router/rest";
    
    public TaobaoItemApi(String appKey, String appSecret) {
        this.appKey = appKey;
        this.appSecret = appSecret;
    }
    
    private String generateSign(Map<String, String> params) {
        // 参数按key排序
        List<String> keys = new ArrayList<>(params.keySet());
        Collections.sort(keys);
        
        // 拼接字符串
        StringBuilder queryString = new StringBuilder(appSecret);
        for (String key : keys) {
            queryString.append(key).append(params.get(key));
        }
        queryString.append(appSecret);
        
        // MD5加密
        return DigestUtils.md5Hex(queryString.toString()).toUpperCase();
    }
    
    public String getItem(String numIid, String fields) throws IOException {
        Map<String, String> params = new HashMap<>();
        params.put("method", "taobao.item.get");
        params.put("app_key", appKey);
        params.put("timestamp", new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()));
        params.put("format", "json");
        params.put("v", "2.0");
        params.put("sign_method", "md5");
        params.put("num_iid", numIid);
        params.put("fields", fields);
        
        // 生成签名
        params.put("sign", generateSign(params));
        
        // 构建请求URL
        StringBuilder url = new StringBuilder(gateway + "?");
        for (Map.Entry<String, String> entry : params.entrySet()) {
            url.append(entry.getKey()).append("=").append(entry.getValue()).append("&");
        }
        
        // 发送请求
        CloseableHttpClient httpClient = HttpClients.createDefault();
        HttpGet httpGet = new HttpGet(url.toString());
        HttpResponse response = httpClient.execute(httpGet);
        
        return EntityUtils.toString(response.getEntity());
    }
    
    public static void main(String[] args) throws IOException {
        String appKey = "您的AppKey";
        String appSecret = "您的AppSecret";
        TaobaoItemApi api = new TaobaoItemApi(appKey, appSecret);
        
        // 获取商品详情
        String result = api.getItem("602344678912", "num_iid,title,price,pic_url,desc,sales");
        System.out.println(result);
    }
}
```