当前位置：首页 > article >正文

淘宝商品详情API返回值说明：Python爬虫代码示例

article 2025/1/7 4:28:49

在电商平台的数据分析和市场研究中，获取商品的详细信息是至关重要的一步。淘宝作为中国最大的电商平台之一，提供了丰富的API接口供开发者获取商品数据。本文将详细介绍如何使用Python爬虫通过API获取淘宝商品详情，并解析API返回值。

淘宝商品详情API接口介绍

淘宝商品详情API能够返回商品的详细信息，包括但不限于商品ID、名称、主图URL、详情描述、SKU属性列表、价格信息、销量信息、卖家信息等。以下是一些基本的API接口参数和返回值说明。

公共参数

key：调用key
secret：调用密钥
api_name：API接口名称
cache：是否使用缓存数据，默认yes
result_type：返回数据格式，默认为json
lang：翻译语言，默认cn简体中文
version：API版本

请求参数

num_iid：淘宝商品ID
is_promotion：是否获取促销价

响应参数

响应参数包含了商品的详细信息，以下是一些关键字段的说明：

item_id：商品ID
num_iid：商品数字ID
title：商品名称
pic_url：商品主图URL
desc：商品详情描述（HTML格式）
sku_props：商品SKU属性列表
sku_map：商品SKU信息映射表
price_info：商品价格信息
sales_info：商品销量信息
seller_info：卖家信息
shop_info：店铺信息
item_imgs：商品图片列表
item_props：商品属性列表
item_comment：商品评价信息

Python爬虫代码示例

以下是一个Python示例代码，用于发送HTTP请求并获取淘宝商品详情：

import requests
import json

def get_taobao_item_details(item_id, app_key, app_secret):
    # 获取Access Token
    url = f"https://oauth.taobao.com/token?grant_type=client_credential&app_key={app_key}&app_secret={app_secret}"
    response = requests.get(url)
    access_token = response.json().get('access_token')

    # 构造请求URL
    api_url = f"https://eco.taobao.com/router/rest?method=item.itemdetail.get&v=2.0&app_key={app_key}&q=&sign=&access_token={access_token}&item_id={item_id}"
    headers = {
        "User-Agent": "Mozilla/5.0"
    }
    response = requests.get(api_url, headers=headers)
    return response.json()

# 使用示例
item_id = "123456789"  # 替换为你想获取详情的商品ID
app_key = "your_app_key"  # 替换为你的AppKey
app_secret = "your_app_secret"  # 替换为你的AppSecret
item_details = get_taobao_item_details(item_id, app_key, app_secret)
print(json.dumps(item_details, indent=4, ensure_ascii=False))

API返回值解析

淘宝商品详情API的返回值通常采用JSON格式进行封装。一个典型的返回值结构如下：

{
  "request_id": "xxxxxxx",
  "code": 200,
  "message": "success",
  "result": {
    "item": {
      "item_id": "商品ID",
      "num_iid": "商品数字ID",
      "title": "商品名称",
      "pic_url": "商品主图URL",
      "desc": "商品详情描述（HTML格式）",
      "sku_props": "商品SKU属性列表",
      "sku_map": "商品SKU信息映射表",
      "price_info": "商品价格信息",
      "sales_info": "商品销量信息",
      "seller_info": "卖家信息",
      "shop_info": "店铺信息",
      "item_imgs": "商品图片列表",
      "item_props": "商品属性列表",
      "item_comment": "商品评价信息"
    }
  }
}