taobao.item_search_shop 是淘宝/天猫开放平台的一个API，用于根据店铺ID搜索该店铺的所有商品。下面是一个简化的返回值详解，帮助你更好地理解API返回的数据结构：
淘宝/天猫获得店铺的所有商品 API
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版本 |
请求参数
请求参数：seller_id=898146183&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 | 宝贝链接 |
返回数据示例
"items": {
"seller_id": "898146183",
"page": "1",
"real_total_results": "116",
"total_results": "116",
"page_size": 10,
"page_count": 11,
"_ddf": "ti",
"item": [
{
"num_iid": "592020103246",
"pic_url": "//img.alicdn.com/bao/uploaded/O1CN01naTRO81UulqDd41W6_!!6000000002578-0-yinhe.jpg",
"title": "多功能激光翻页笔充电款ppt遥控器笔教师用演讲投影仪笔多媒体遥控笔幻灯片翻页器讲课红外线笔教学电子希沃",
"orginal_price": "18.9",
"price": "18.9",
"sales": 10000,
"seller_id": "898146183",
"shop_title": "carkoci旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=592020103246"
},
{
"num_iid": "709182446951",
"pic_url": "//img.alicdn.com/bao/uploaded/O1CN013Zf9dN1IvR4DqjGZO_!!6000000000955-0-yinhe.jpg",
"title": "触屏电容笔ipad平板手机通用触控笔适用于苹果华为小米apple pencil磁吸手写笔学习机学生绘画剪辑安卓点触",
"orginal_price": "6.8",
"price": "6.8",
"sales": 5000,
"seller_id": "898146183",
"shop_title": "carkoci旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=709182446951"
},
{
"num_iid": "644153644706",
"pic_url": "//img.alicdn.com/bao/uploaded/O1CN01Td9hxN1u7TEaGh1Xx_!!6000000005990-0-yinhe.jpg",
"title": "笔记本电脑支架托架桌面增高散热器折叠便携式支撑悬空立式调节铝合金架子平板手提升降散热架底座办公专用",
"orginal_price": "9.9",
"price": "9.9",
"sales": 1000,
"seller_id": "898146183",
"shop_title": "carkoci旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=644153644706"
},
{
"num_iid": "652275837895",
"pic_url": "//img.alicdn.com/bao/uploaded/O1CN01A6bvvC1DrhfoCnaUP_!!6000000000270-0-yinhe.jpg",
"title": "【100W超级快充】数据线三合一拖三充电器一拖3车载通用手机usb多头二用多功能适用华为苹果typec安卓万能6A",
"orginal_price": "19.9",
"price": "19.9",
"sales": 1000,
"seller_id": "898146183",
"shop_title": "carkoci旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=652275837895"
},
{
"num_iid": "654172843621",
"pic_url": "//img.alicdn.com/bao/uploaded/O1CN01QmuCTz1iLsIBsdObp_!!6000000004397-0-yinhe.jpg",
"title": "适用于苹果13钢化膜iPhone14/15pro手机12全屏覆盖plus防指纹11防窥膜x抗摔xs护眼xr贴pro高清max包边ip保护",
"orginal_price": "18.8",
"price": "18.8",
"sales": 1000,
"seller_id": "898146183",
"shop_title": "carkoci旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=654172843621"
},
{
"num_iid": "623715839119",
"pic_url": "//img.alicdn.com/bao/uploaded/O1CN014BUO4028yVkGiArQh_!!6000000008001-0-yinhe.jpg",
"title": "适用于苹果14/15防窥钢化膜iPhone11/x防偷窥膜13pro全屏12/11promax覆盖xr/xs隐私xsmax防窥膜8plus手机新款",
"orginal_price": "14.8",
"price": "14.8",
"sales": 1000,
"seller_id": "898146183",
"shop_title": "carkoci旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=623715839119"
},
{
"num_iid": "696789468868",
"pic_url": "//img.alicdn.com/bao/uploaded/O1CN016rzsL51YIzf8WyRSR_!!6000000003037-0-yinhe.jpg",
"title": "【全铝合金】手机支架桌面支架金属手机夹子万能通用平板支撑架便携可折叠可调节直播支架子懒人床头",
"orginal_price": "13.8",
"price": "13.8",
"sales": 1000,
"seller_id": "898146183",
"shop_title": "carkoci旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=696789468868"
},
{
"num_iid": "777111254534",
"pic_url": "//img.alicdn.com/bao/uploaded/i1/898146183/O1CN01FVnZC91vXroyDuDrF_!!0-item_pic.jpg",
"title": "【进口防窥AR护眼】适用苹果15promax钢化膜iphone15/14pro手机膜13新款抗12防蓝光11防窥Plus贴膜高清xr护眼",
"orginal_price": "11.8",
"price": "11.8",
"sales": 1000,
"seller_id": "898146183",
"shop_title": "carkoci旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=777111254534"
},
{
"num_iid": "589352247630",
"pic_url": "//img.alicdn.com/bao/uploaded/O1CN01k8hlIV21l2iUVB1uy_!!6000000007024-0-yinhe.jpg",
"title": "【电竞专用】防汗指套吃鸡手指套手游触屏手套打游戏防手汗职业拇指套指头套防滑神器适用于王者荣耀防出汗",
"orginal_price": "5.3",
"price": "5.3",
"sales": 1000,
"seller_id": "898146183",
"shop_title": "carkoci旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=589352247630"
},
{
"num_iid": "743591055960",
"pic_url": "//img.alicdn.com/bao/uploaded/O1CN012unvWk1mz2iq9N9oJ_!!6000000005024-0-yinhe.jpg",
"title": "【特级碳素钢】笔记本电脑支架铝合金增高架立式散热办公折叠可升降悬空支撑架手提平板架子抬高升高桌面底座",
"orginal_price": "29.9",
"price": "29.9",
"sales": 1000,
"seller_id": "898146183",
"shop_title": "carkoci旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=743591055960"
}
]
},
"error_code": "0000",
"reason": "ok",
"secache": "b76135caead1847dfb78c3d70d7c0c1f",
"secache_time": 1715224821,
"secache_date": "2024-05-09 11:20:21",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"cache": 0,
"api_info": "today:30 max:10000 all[97=30+26+41];expires:2030-10-30",
"execution_time": "1.846",
"server_time": "Beijing/2024-05-09 11:20:21",
"client_ip": "61.131.237.193",
"call_args": {
"seller_nick": "898146183",
- 总结果数（total_results）：
- 表示搜索到的商品总数。
- 当前页码（current_page）：
- 表示当前返回的是第几页的数据。
- 总页数（total_pages）：
- 表示搜索结果的总页数。
- 商品列表（items）：
-
这是一个数组，包含了搜索到的所有商品的信息。每个商品通常包含以下字段：
- 商品ID（item_id）：
- 唯一标识一个商品的ID。
- 商品标题（title）：
- 商品的名称或标题。
- 价格（price）：
- 商品的销售价格，可能包括市场价和促销价。
- 商品主图链接（pic_url）：
- 商品主图的URL链接。
- 商品详情页链接（detail_url）：
- 指向商品详情页面的链接。
- 店铺名称（shop_name）：
- 提供该商品的店铺的名称。
- 店铺ID（shop_id）：
- 店铺的唯一标识ID。
- 销量（sales）：
- 商品的销量或销售数量。
- 收藏数（favorites）：
- 商品的收藏数量。
- 所在地区（location）：
- 商品发货的地区。
- 商品评分（score）：
- 商品的评价分数或平均评分。
- SKU信息（item_sku）：
- 如果API支持，可能包含商品的SKU信息，如尺码、颜色、库存量等。
- 其他属性：
- 可能还包括商品的分类、属性、促销信息等其他与商品相关的信息。
- 商品ID（item_id）：
-
- 请求参数（request_params）（可选）：
- 如果API返回了请求参数的信息，这将包括你发送的原始请求参数，如店铺ID、页码、排序方式等。
- 状态码（status_code） 和 错误信息（error_message）：
- 表示API调用的成功或失败，以及失败时的具体错误信息。
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
