taobao.item_search_shop详解：淘宝/天猫店铺商品API返回值全解析

taobao.item_search_shop 是淘宝/天猫提供的一个API接口，用于获取指定店铺的所有商品数据。以下是对这个API返回值的详细解析，包括请求参数、响应参数和返回值示例。

请求参数

• shop_id (暂时失效): 店铺ID，但请注意，这个参数在当前的API版本中可能已经失效。
• seller_id: 卖家ID，即店铺的卖家ID，用于指定查询的店铺。
• page: 页码，用于分页查询。
• sort: 排序方式，可以设置为new（新品）、bid（价格）、sale（销量）。如果需要在价格排序时从大到小排序，可以在bid前加_（即_bid）。

响应参数

返回值通常是一个JSON格式的对象，包含以下主要部分：

• Version: API的版本信息。
• Date: 请求的时间戳或日期。
• items: 商品信息的数组，每个元素代表一个商品。

在items中，每个商品通常包含以下字段：

• num_iid: 商品的唯一标识符。
• pic_url: 商品主图的URL。
• title: 商品的标题。
• orginal_price (或 price): 商品的原价或当前售价。
• sales: 商品的销量。
• seller_id: 卖家ID，与请求参数中的seller_id相对应。
• shop_title: 店铺的标题或名称。
• detail_url: 商品的详情页URL。

taobao.item_search_shop

公共参数

请求地址:

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：shop_id=440688975&seller_id=4273827547&page=1&sort=

参数说明： shop_id:shop_id
seller_id:seller_id
sort:排序[new,bid,sale]
  (new 新品,bid:价格,sale:销量,bid加_前缀为从大到小排序)

响应参数

Version: Date:

名称	类型	必须	示例值	描述
num_iid	Bigint	0	579813460997	商品ID
pic_url	String	0	//img.alicdn.com/bao/uploaded/i3/478952498/O1CN011UK7q9WzgFGKQw8_!!478952498.jpg	图片地址
title	String	0	英伦小皮鞋女复古2020秋冬新款网红毛毛鞋女百搭外穿粗跟中跟单鞋	店铺标题
orginal_price	String	0	398.00	优惠价
price	Float	0	148	价格
sales	Int	0	7	销量
detail_url	String	0	//item.taobao.com/item.htm?id=579813460997	宝贝链接

此外，还可能包含其他字段，如商品的价格区间、属性、描述等，具体取决于API的版本和设置。

返回值示例

以下是一个简化的返回值示例：

{  
    "Version": "x.x.x",  
    "Date": "2024-05-28",  
    "items": {  
        "seller_id": "898146183",  
        "page": "1",  
        "real_total_results": "116",  
        "total_results": "116",  
        "page_size": 10,  
        "page_count": 11,  
        "item": [  
            {  
                "num_iid": "592020103246",  
                "pic_url": "//img.alicdn.com/bao/uploaded/O1CN01naTRO81UulqDd41W6_!!6000000002578-0-yinhe.jpg",  
                "title": "多功能激光翻页笔充电款ppt遥控器笔...",  
                "original_price": "18.9",  
                "price": "18.9",  
                "sales": 10000,  
                "seller_id": "898146183",  
                "shop_title": "carkoci旗舰店",  
                "detail_url": "https://item.taobao.com/item.htm?id=592020103246"  
            },  
            // ... 更多商品信息  
        ]  
    }  
}