获得店铺的所有商品 API 返回值说明
item_search_shop-获得店铺的所有商品 注册开通
onebound.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=113102154&page=1&sort=
参数说明： shop_id:shop_id page:页码
sort:排序[new,bid,sale]
(new 新品,bid:价格,sale:销量,bid加_前缀为从大到小排序)
响应参数
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| num_iid | Bigint | 0 | 商品ID | |
| pic_url | String | 0 | 图片地址 | |
| title | String | 0 | 店铺标题 | |
| orginal_price | String | 0 | 优惠价 | |
| price | Float | 0 | 价格 | |
| sales | Int | 0 | 销量 | |
| detail_url | String | 0 | 宝贝链接 |
请求示例
- Curl
- PHP
- PHPsdk
- JAVA
- C#
- Python
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_search_shop/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&shop_id=113102154&page=1&sort="
响应示例
"items": {
"shop_id": "113102154",
"page": "1",
"real_total_results": "2724",
"total_results": "2724",
"page_size": 30,
"page_count": 91,
"_ddf": "ti",
"item": [
{
"num_iid": "627122930503",
"pic_url": "//img.alicdn.com/imgextra/i1/2213288309/O1CN01YbJN4S2BFZbdzXzej_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款秋冬装法式收腰长裙赫本风黑色长袖衬衫连衣裙子女秋冬",
"promotion_price": "79.90",
"price": "49.90",
"sales": 56464,
"quantity": "18085",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=627122930503"
},
{
"num_iid": "627050329328",
"pic_url": "//img.alicdn.com/imgextra/i4/2213288309/O1CN01pZufPI2BFZe7OkTyL_!!2213288309-0-lubanu-s.jpg",
"title": "早春装2023年新款法式赫本风设计感小众黑色衬衫连衣裙子女秋冬款",
"promotion_price": "79.90",
"price": "49.90",
"sales": 55407,
"quantity": "35992",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=627050329328"
},
{
"num_iid": "627678469511",
"pic_url": "//img.alicdn.com/imgextra/i4/2213288309/O1CN01SyoewV2BFZdpu4jDR_!!2213288309-0-lubanu-s.jpg",
"title": "2023新款高级感女装打底内搭小个子黑色针织毛衣连衣裙子女秋冬季",
"promotion_price": "109.90",
"price": "59.90",
"sales": 49815,
"quantity": "61657",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=627678469511"
},
{
"num_iid": "640845872627",
"pic_url": "//img.alicdn.com/imgextra/i1/2213288309/O1CN01uJaUMV2BFZeD5fE6O_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款法式纯欲风小黑裙轻熟风春装吊带长裙连衣裙子女装夏季",
"promotion_price": "72.90",
"price": "42.90",
"sales": 42400,
"quantity": "190",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=640845872627"
},
{
"num_iid": "665058614456",
"pic_url": "//img.alicdn.com/imgextra/i1/2213288309/O1CN01DsB3Bm2BFZdpnJqdV_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款冬装慵懒风日系复古高级感上衣软糯棋盘格毛衣女秋冬季",
"promotion_price": "99.90",
"price": "55.90",
"sales": 38323,
"quantity": "18776",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=665058614456"
},
{
"num_iid": "658153945556",
"pic_url": "//img.alicdn.com/imgextra/i3/2213288309/O1CN01zYf3hk2BFZcnhFbp1_!!2213288309-0-lubanu-s.jpg",
"title": "设计感小众早春装毛衣2023年新款秋冬高领打底衫内搭针织衫上衣女",
"promotion_price": "69.90",
"price": "39.90",
"sales": 37395,
"quantity": "643",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=658153945556"
},
{
"num_iid": "634341722937",
"pic_url": "//img.alicdn.com/imgextra/i1/2213288309/O1CN01PeWx8c2BFZYSEgOnR_!!2213288309-0-lubanu-s.jpg",
"title": "白色蕾丝衫网纱打底衫女装新款秋款内搭洋气法式上衣2023年秋冬季",
"promotion_price": "89.90",
"price": "49.90",
"sales": 36054,
"quantity": "29979",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=634341722937"
},
{
"num_iid": "656174978943",
"pic_url": "//img.alicdn.com/imgextra/i4/2213288309/O1CN01nzlyy72BFZe8gNpUR_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款春装中长款法式衬衣设计感小众上衣外套格子衬衫女秋冬",
"promotion_price": "75.90",
"price": "45.90",
"sales": 31373,
"quantity": "418",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=656174978943"
},
{
"num_iid": "650818926838",
"pic_url": "//img.alicdn.com/imgextra/i3/2213288309/O1CN01guDSBd2BFZeZyI4Dq_!!2213288309-0-lubanu-s.jpg",
"title": "设计感不规则正肩短袖t恤高级感辣妹2023年新款短款上衣女装夏季",
"promotion_price": "65.90",
"price": "35.90",
"sales": 31130,
"quantity": "187",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=650818926838"
},
{
"num_iid": "652121475830",
"pic_url": "//img.alicdn.com/imgextra/i2/2213288309/O1CN019qzKUy2BFZeGSfG72_!!2213288309-0-lubanu-s.jpg",
"title": "2023新款设计感小众独特体恤辣妹短款上衣白色短袖t恤女ins潮夏季",
"promotion_price": "79.90",
"price": "49.90",
"sales": 29861,
"quantity": "150",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=652121475830"
},
{
"num_iid": "680642832891",
"pic_url": "//img.alicdn.com/imgextra/i1/2213288309/O1CN01feKqXf2BFZieuvjKO_!!2213288309.jpg",
"title": "2023早初春季高级感温柔慵懒风中长款毛衣外套女秋冬针织开衫上衣",
"promotion_price": "119.90",
"price": "69.90",
"sales": 29276,
"quantity": "112382",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=680642832891"
},
{
"num_iid": "672618269188",
"pic_url": "//img.alicdn.com/imgextra/i1/2213288309/O1CN01yy7acc2BFZf241EiC_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款早春法式蝴蝶结黑色polo包臀连衣裙子女夏季设计感小众",
"promotion_price": "119.90",
"price": "62.90",
"sales": 26311,
"quantity": "60",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=672618269188"
},
{
"num_iid": "652724830762",
"pic_url": "//img.alicdn.com/imgextra/i2/2213288309/O1CN01owXKAR2BFZgXEvlxe_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款秋冬季慵懒风宽松韩系软糯毛衣外套针织开衫春秋款女装",
"promotion_price": "99.90",
"price": "59.90",
"sales": 25982,
"quantity": "17992",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=652724830762"
},
{
"num_iid": "671377395464",
"pic_url": "//img.alicdn.com/imgextra/i4/2213288309/O1CN01Lo3a2J2BFZelxHGnD_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款春装法式小众设计感短裙温柔风黑色碎花连衣裙子女装夏",
"promotion_price": "99.90",
"price": "59.90",
"sales": 24041,
"quantity": "71",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=671377395464"
},
{
"num_iid": "654198510741",
"pic_url": "//img.alicdn.com/imgextra/i4/2213288309/O1CN01HYlJwy2BFZeG2eoVF_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款秋冬装长袖女短款上衣针织开衫秋冬款黑色拉链毛衣外套",
"promotion_price": "99.90",
"price": "59.90",
"sales": 23796,
"quantity": "597",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=654198510741"
},
{
"num_iid": "643465798843",
"pic_url": "//img.alicdn.com/imgextra/i2/2213288309/O1CN01AsAAF72BFZecC9m6X_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款奶乖设计感小众法式长裙泡泡袖白色仙女连衣裙子女夏季",
"promotion_price": "99.90",
"price": "59.90",
"sales": 23679,
"quantity": "22",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=643465798843"
},
{
"num_iid": "663741525181",
"pic_url": "//img.alicdn.com/imgextra/i3/2213288309/O1CN01u85HbY2BFZi0JtlbW_!!2213288309-0-lubanu-s.jpg",
"title": "2023年秋季新款性感小黑裙辣妹包臀裙黑色长袖针织连衣裙子女秋冬",
"promotion_price": "99.90",
"price": "59.90",
"sales": 23679,
"quantity": "235",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=663741525181"
},
{
"num_iid": "646360153209",
"pic_url": "//img.alicdn.com/imgextra/i4/2213288309/O1CN01EAcf9D2BFZeAnwsIJ_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款法式气质设计感小众克莱因蓝仙女泡泡袖连衣裙子女夏季",
"promotion_price": "99.90",
"price": "49.90",
"sales": 23164,
"quantity": "285",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=646360153209"
},
{
"num_iid": "630437018102",
"pic_url": "//img.alicdn.com/imgextra/i1/2213288309/O1CN01Ons1pI2BFZe68qq0v_!!2213288309-0-lubanu-s.jpg",
"title": "2023新款配大衣长裙高级感赫本风金丝绒黑色长袖连衣裙子女秋冬季",
"promotion_price": "99.90",
"price": "59.90",
"sales": 22544,
"quantity": "41989",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=630437018102"
},
{
"num_iid": "680432372229",
"pic_url": "//img.alicdn.com/imgextra/i4/2213288309/O1CN01PH1Lf12BFZgWCBnWw_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款春装衬衣内搭设计感小众文艺森系格子衬衫外套女秋冬季",
"promotion_price": "99.90",
"price": "49.90",
"sales": 22488,
"quantity": "1214",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=680432372229"
},
{
"num_iid": "648319076009",
"pic_url": "//img.alicdn.com/imgextra/i2/2213288309/O1CN01whjxNS2BFZejALR6a_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款法式设计感小众学院风短裙春辣妹蓝色polo连衣裙子夏季",
"promotion_price": "79.90",
"price": "39.90",
"sales": 21291,
"quantity": "101",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=648319076009"
},
{
"num_iid": "694655573432",
"pic_url": "//img.alicdn.com/imgextra/i1/2213288309/O1CN01NqyUdu2BFZiewlzS7_!!2213288309.jpg",
"title": "早春装设计感毛衣内搭打底衫女秋冬高级感修身显瘦v领针织衫上衣",
"promotion_price": "99.90",
"price": "59.90",
"sales": 19544,
"quantity": "52269",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=694655573432"
},
{
"num_iid": "645800562038",
"pic_url": "//img.alicdn.com/imgextra/i1/2213288309/O1CN01BlkY692BFZas5cxHd_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款白色针织短袖t恤设计感小众打底衫内搭短款上衣女夏季",
"promotion_price": "69.90",
"price": "39.90",
"sales": 18723,
"quantity": "94",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=645800562038"
},
{
"num_iid": "645958464007",
"pic_url": "//img.alicdn.com/imgextra/i3/2213288309/O1CN01aZCINS2BFZeD6XKpz_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款女装法式小黑裙学院风设计感黑色西装polo连衣裙子夏季",
"promotion_price": "99.90",
"price": "59.90",
"sales": 18632,
"quantity": "131",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=645958464007"
},
{
"num_iid": "671728555457",
"pic_url": "//img.alicdn.com/imgextra/i2/2213288309/O1CN01Nb0bOE2BFZf0ehLMl_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款高级感polo裙绿色衬衫连衣裙子夏季短裙设计感春装女装",
"promotion_price": "119.90",
"price": "69.90",
"sales": 18597,
"quantity": "582",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=671728555457"
},
{
"num_iid": "636341301192",
"pic_url": "//img.alicdn.com/imgextra/i1/2213288309/O1CN01ohozer2BFZebiLlUD_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款早春装女装气质法式黑色背带碎花连衣裙子两件套装夏季",
"promotion_price": "59.90",
"price": "39.90",
"sales": 18072,
"quantity": "380",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=636341301192"
},
{
"num_iid": "636073118672",
"pic_url": "//img.alicdn.com/imgextra/i2/2213288309/O1CN01XrIrh32BFZZ1kJqsO_!!2213288309.jpg",
"title": "蕾丝打底衫女装新款内搭秋冬装小衫法式高端网纱长袖上衣洋气时尚",
"promotion_price": "69.90",
"price": "39.90",
"sales": 18013,
"quantity": "116",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=636073118672"
},
{
"num_iid": "645799930769",
"pic_url": "//img.alicdn.com/imgextra/i1/2213288309/O1CN01vv17gk2BFZapSpYhS_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款针织短袖t恤设计感辣妹条纹上衣polo衫内搭女甜辣夏季",
"promotion_price": "69.90",
"price": "39.90",
"sales": 17813,
"quantity": "672",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=645799930769"
},
{
"num_iid": "672281853689",
"pic_url": "//img.alicdn.com/imgextra/i2/2213288309/O1CN01TYPJF62BFZf6ONWPj_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款设计感小众蝴蝶结学院风辣妹秋季黑色西装连衣裙子女夏",
"promotion_price": "135.90",
"price": "75.90",
"sales": 16811,
"quantity": "47",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=672281853689"
},
{
"num_iid": "645679291466",
"pic_url": "//img.alicdn.com/imgextra/i3/2213288309/O1CN01JLHGZ12BFZeZqtbLw_!!2213288309-0-lubanu-s.jpg",
"title": "2023年新款夏季女装法式设计感小众纯欲性感辣妹polo包臀连衣裙子",
"promotion_price": "95.90",
"price": "55.90",
"sales": 16791,
"quantity": "161",
"seller_nick": "卡拉尔贝齐旗舰店",
"seller_id": null,
"shop_id": "113102154",
"shop_title": "卡拉尔贝齐旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=645679291466"
}
]
},
"error_code": "0000",
"reason": "ok",
"secache": "62bcaa1f73728e18d00cc7df01c81af5",
"secache_time": 1675064220,
"secache_date": "2023-01-30 15:37:00",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"cache": 0,
"api_info": "today:105 max:10100 all[199=105+60+34];expires:2030-12-31",
"execution_time": "0.827",
"server_time": "Beijing/2023-01-30 15:37:00",
"client_ip": "220.177.180.18",
"call_args": {
"seller_nick": "113102154",
"start_price": "1"
},
"api_type": "taobao",
"translate_language": "zh-CN",
"translate_engine": "baidu",
"server_memory": "1.01MB",
"request_id": "gw-4.63d7739bef74c",
"last_id": "1508309874"
}
异常示例相关资料错误码解释
| 状态代码(error_code) | 状态信息 | 详细描述 | 是否收费 |
|---|---|---|---|
| 0000 | success | 接口调用成功并返回相关数据 | 是 |
| 2000 | Search success but no result | 接口访问成功，但是搜索没有结果 | 是 |
| 4000 | Server internal error | 服务器内部错误 | 否 |
| 4001 | Network error | 网络错误 | 否 |
| 4002 | Target server error | 目标服务器错误 | 否 |
| 4003 | Param error | 用户输入参数错误 | 忽略 |
| 4004 | Account not found | 用户帐号不存在 | 忽略 |
| 4005 | Invalid authentication credentials | 授权失败 | 忽略 |
| 4006 | API stopped | 您的当前API已停用 | 忽略 |
| 4007 | Account stopped | 您的账户已停用 | 忽略 |
| 4008 | API rate limit exceeded | 并发已达上限 | 忽略 |
| 4009 | API maintenance | API维护中 | 忽略 |
| 4010 | API not found with these values | API不存在 | 忽略 |
| 4012 | Please add api first | 请先添加api | 忽略 |
| 4013 | Number of calls exceeded | 调用次数超限 | 忽略 |
| 4014 | Missing url param | 参数缺失 | 忽略 |
| 4015 | Wrong pageToken | 参数pageToken有误 | 忽略 |
| 4016 | Insufficient balance | 余额不足 | 忽略 |
| 4017 | timeout error | 请求超时 | 否 |
| 5000 | unknown error | 未知错误 | 否 |