taobao.item_search_shop是淘宝/天猫开放平台的一个API,它允许开发者通过店铺ID搜索该店铺的所有商品。以下是关于这个API返回值的详细攻略:
-
接口说明:
- 名称:taobao.item_search_shop
- 请求地址:具体的API请求地址(由于此信息可能会随时间变化,建议直接查阅淘宝/天猫开放平台的官方文档)
- 功能:通过传入shop_id或者seller_id可以获取到该店铺的所有商品,支持翻页展示。每页默认返回60个商品,可以通过设置page参数来进行翻页。
-
淘宝/天猫获得店铺的所有商品 API 返回值说明
taobao.item_search_shop
公共参数
请求地址: https://api-gw.onebound.cn/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 | 宝贝链接 |
-
返回值详解:
- 返回值通常以JSON格式呈现,包含了所请求的商品数据。
- 每个商品数据通常包含以下字段(具体字段可能会根据淘宝/天猫的更新而有所变化):
- num_iid:商品的唯一ID。
- pic_url:商品的图片URL。
- title:商品的标题。
- 其他可能的字段,如价格、库存、销量等,具体取决于你的请求参数和淘宝/天猫的返回策略。
-
如何使用:
- 首先,你需要前往淘宝/天猫开放平台注册成为开发者,并创建应用以获取API的访问权限。
- 确定你需要获取的店铺ID(shop_id)或卖家ID(seller_id)。
- 查阅淘宝/天猫开放平台的官方文档,了解taobao.item_search_shop接口的具体使用方法,包括请求参数、返回参数等。
- 使用编程语言(如Java、Python等)构建请求URL,并发送请求到淘宝/天猫的服务器。请求URL中需要包含接口名称、店铺ID或卖家ID、访问令牌(app_key和app_secret)以及其他必要的参数。
- 解析服务器返回的JSON数据,提取你需要的商品信息。
- 根据需要对提取的数据进行进一步的处理或展示。
- 返回数据示例
items": { "seller_id": "898146183", "page": "1", "real_total_results": "113", "total_results": "113", "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": "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": "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": "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": "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": "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": "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": 1715505637, "secache_date": "2024-05-12 17:20:37", "translate_status": "", "translate_time": 0, "language": { "default_lang": "cn", "current_lang": "cn"