深入解析 item_search_shop 接口：获取淘宝/天猫店铺所有商品数据

本文链接：https://blog.csdn.net/2501_90907859/article/details/146183962

在电商领域，获取店铺商品数据是实现商品管理、竞品分析、市场调研等功能的关键步骤。淘宝开放平台提供的 Taobao.item_search_shop 接口允许开发者通过店铺 ID 或卖家 ID 获取店铺的所有商品信息。本文将详细介绍该接口的使用方法、返回数据结构以及实际应用示例。

一、接口概述

Taobao.item_search_shop 接口用于通过店铺 ID 或卖家 ID 搜索指定店铺的所有商品。该接口支持分页查询，每页默认返回 60 个商品，开发者可以通过设置 page 参数进行翻页。

主要功能：

获取店铺所有商品的基本信息，包括商品 ID、标题、价格、图片 URL、销量等。
支持按新品、价格、销量等维度排序。

二、接口调用流程

注册账号并创建应用
在淘宝开放平台注册开发者账号，创建应用以获取 App Key 和 App Secret，这是调用接口的必要凭证。
申请接口权限
在应用管理页面申请 taobao.item_search_shop 或 taobao.items.onsale.get 接口的使用权限。
构建请求
构造请求 URL 和参数，包括店铺 ID（seller_id 或 shop_id）、分页参数（page 和 page_size）以及其他可选参数。
生成签名
使用 App Secret 对请求参数进行签名，确保请求的安全性。
发送请求并解析响应
使用 HTTP 客户端（如 Python 的 requests 库）发送请求，并解析返回的 JSON 数据。

三、接口参数说明

参数名称	类型	是否必选	说明
`app_key`	String	是	应用的 App Key
`method`	String	是	接口名称，固定为 `taobao.item_search_shop`
`seller_id`	Long	是	卖家 ID，用于指定店铺
`page`	Integer	否	页码，默认为 1
`page_size`	Integer	否	每页返回的商品数量，默认为 60
`sort`	String	否	排序方式，如 `new`（新品）、`bid`（价格）、`sale`（销量）
`timestamp`	String	是	请求时间戳，格式为 `YYYY-MM-DD HH:MM:SS`
`sign`	String	是	请求签名，用于验证请求的合法性

四、返回数据结构

返回数据以 JSON 格式呈现，包含以下字段：

字段名称	类型	说明
`num_iid`	Long	商品的唯一标识符
`title`	String	商品标题
`pic_url`	String	商品主图的 URL
`price`	String	商品价格
`sales`	Long	商品销量
`detail_url`	String	商品详情页 URL
`shop_title`	String	店铺名称

五、Python 示例代码

以下是一个使用 Python 调用 Taobao.item_search_shop 接口的示例：

Python

import requests
import hashlib
import time

def generate_sign(params, app_secret):
    """生成签名"""
    sorted_params = sorted(params.items())
    sign_str = app_secret + ''.join(f"{k}{v}" for k, v in sorted_params) + app_secret
    return hashlib.md5(sign_str.encode()).hexdigest().upper()

def get_shop_items(app_key, app_secret, seller_id, page=1, page_size=60):
    """获取店铺所有商品"""
    url = "https://gw.api.taobao.com/router/rest"
    timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
    params = {
        "app_key": app_key,
        "method": "taobao.item_search_shop",
        "seller_id": seller_id,
        "page": page,
        "page_size": page_size,
        "timestamp": timestamp,
        "v": "2.0",
        "format": "json"
    }
    sign = generate_sign(params, app_secret)
    params["sign"] = sign

    response = requests.get(url, params=params)
    return response.json()

# 示例调用
app_key = "your_app_key"
app_secret = "your_app_secret"
seller_id = "your_seller_id"

items = get_shop_items(app_key, app_secret, seller_id)
print(items)