淘宝整店商品列表查询V2
标识:MSearchApiGetShopItemList
- 接口地址:
https://way.jd.com/TONGLI/MSearchApiGetShopItemList
- 请求方式:
HTTPS GET POST
- 请求示例:
https://way.jd.com/TONGLI/MSearchApiGetShopItemList?shop_id=67095450&page_num=1&page_size=20&recent_days=0&appkey=您申请的APPKEY
QUERY请求参数
- 公共请求参数
-
名称 类型 必填 示例值 描述 appkey String 是 1 您申请的appkey - 业务请求参数
-
名称 类型 必填 示例值 描述 shop_id String 是 67095450 淘宝店铺id,需要调用店铺接口获取此id。这里用“绿联数码旗舰店”的shopid:67095450作为示例值。 sort String 否 排序方式,1 - 综合排序,2 - 新品排序,3 - 销量排序,4 - 价格由高到低,5 - 价格由低到高 page_num String 否 1 页码 page_size String 否 20 每页数据条数,最大值20 cat_id String 否 店铺前台类目ID,可通过【淘宝店铺前台展示类目】接口查询 keyword String 否 关键词 recent_days String 否 0 增量查询,最近几天内新增商品,请填写数字,默认为0,即查询全部商品。
返回参数
- 公共返回参数
-
名称 类型 示例值 描述 code string 10000 更多返回参数示例值请参看“错误参照码” charge boolean false 或 true false:不扣费 true:扣费 remain long 1305 数据剩余次数 msg string 查询成功 更多返回参数示例值请参看“错误参照码” result object {...} 数据查询结果 - 业务返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
ret_id | number | 131976659942533661 | 请求ID |
ret_body | string | {"tabName":"新品","mainCategory":"50008090","totalResults":"397","totalPage":"10","pageSize":"40","page":"1","abtest":"22","RN":"b1f2c4487843d59e84b078cbe731c76b","parameter":"q","paramValue":"","order_by":"oldstarts","style":"1002","pageName":"InShopSrp","isJiaGou":true,"pos":0,"itemsArray":[{"type":"fixed","tItemType":"nt_auction","quantity":"36","sold":"0","item_id":"559176831824","shipping":"0.00","fastPostFee":"0.00","ordinaryPostFee":"0.00","auctionUrl":"http://a.m.taobao.com/i559176831824.htm?&sid=5f2d209e6680dc78fa1b9dd7ba26708f","userId":"713464357","userType":"1","isB2c":"1","nick":"绿联数码旗舰店","pic_path":"http://g.search2.alicdn.com/img/bao/uploaded/i4/i6/TB1Wsncjm7PL1JjSZFHYXIciXXa_M2.SS2_60x60.jpg","rateSum":"19","isCod":"0","isprepay":"1","title":"绿联车载充电器快充QC3.0一拖二双USB汽车24V通用型点烟器插头","promotedService":"1","auctionTag":"843 907 1163 1478 1483 2049 2059 3974 4166 4491 4939 5895 6603 7883 8326 11083 11339 13953 17739 20481 21505 25282 26561 28353 28802 30337 30401 30849 30977 31489 33217 34369 35713 36161 37569 37633 39233 39809 40897 47297 51841 51969 64129 65281 66241 67521 74369 74561 82306 101762 107842 112386 116546 140418 151362 166658 202434 57026 2507 51329 70401 7371 2635 4619 24385 15554 4811 18433 29889 1675 35137 2443 39681 8843 22145 30273 7947 1803 36417 4678 4614","clickUrl":"","zkType":"","zkTime":"0","promotions":"6629","isInLimitPromotion":"false","price":"89.00","priceColor":"#000000","priceWithRate":"59.00","priceWap":"59.00","priceShow":{"preText":"","unit":"¥","price":"59.00"},"isP4p":"false","sameCount":"0","similarCount":"0"},{"type":"fixed","tItemType":"nt_auction","quantity":"2023","sold":"0","item_id":"551393820610","shipping":"0.00","fastPostFee":"0.00","ordinaryPostFee":"0.00","auctionUrl":"http://a.m.taobao.com/i551393820610.htm?&sid=5f2d209e6680dc78fa1b9dd7ba26708f","userId":"713464357","userType":"1","isB2c":"1","nick":"绿联数码旗舰店","pic_path":"http://g.search2.alicdn.com/img/bao/uploaded/i4/i4/TB1ppZYRXXXXXX4apXXXXXXXXXX_!!1-item_pic.gif_60x60.jpg","rateSum":"19","isCod":"0","isprepay":"1","title":"绿联cd口手机架多功能夹子卡扣式磁铁吸性汽车通用型导航车载支架","promotedService":"1","auctionTag":"587 843 907 1163 1478 1483 2049 2059 3974 4166 4491 4550 4939 5895 6603 7883 8326 11083 11339 13953 17739 20481 21505 25282 26561 28353 28802 30337 30401 30849 30977 31489 33217 34369 35713 36161 37569 37633 39233 39809 40897 47297 51841 51969 64129 65281 66241 67521 74369 74561 82306 101762 107842 112386 116546 119234 119298 140418 151362 166658 178754 57026 2507 51329 70401 139778 7371 2635 4619 24385 15554 4811 18433 29889 1675 35137 2443 39681 8843 22145 30273 7947 1803 36417 4678 4614","clickUrl":"","zkType":"","zkTime":"0","promotions":"7538","isInLimitPromotion":"false","price":"65.00","priceColor":"#000000","priceWithRate":"49.00","priceWap":"49.00","priceShow":{"preText":"","unit":"¥","price":"49.00"},"isP4p":"false","sameCount":"0","similarCount":"0"}]} | 返回内容 |
ret_message | string | 错误信息 | |
ret_code | number | 0 | 错误代码 |
返回示例值
{"code":"10000","charge":false,"remain":1305,"msg":"查询成功","result":{
"ret_body": "{\"tabName\":\"新品\",\"mainCategory\":\"50008090\",\"totalResults\":\"397\",\"totalPage\":\"10\",\"pageSize\":\"40\",\"page\":\"1\",\"abtest\":\"22\",\"RN\":\"b1f2c4487843d59e84b078cbe731c76b\",\"parameter\":\"q\",\"paramValue\":\"\",\"order_by\":\"oldstarts\",\"style\":\"1002\",\"pageName\":\"InShopSrp\",\"isJiaGou\":true,\"pos\":0,\"itemsArray\":[{\"type\":\"fixed\",\"tItemType\":\"nt_auction\",\"quantity\":\"36\",\"sold\":\"0\",\"item_id\":\"559176831824\",\"shipping\":\"0.00\",\"fastPostFee\":\"0.00\",\"ordinaryPostFee\":\"0.00\",\"auctionUrl\":\"http://a.m.taobao.com/i559176831824.htm?&sid=5f2d209e6680dc78fa1b9dd7ba26708f\",\"userId\":\"713464357\",\"userType\":\"1\",\"isB2c\":\"1\",\"nick\":\"绿联数码旗舰店\",\"pic_path\":\"http://g.search2.alicdn.com/img/bao/uploaded/i4/i6/TB1Wsncjm7PL1JjSZFHYXIciXXa_M2.SS2_60x60.jpg\",\"rateSum\":\"19\",\"isCod\":\"0\",\"isprepay\":\"1\",\"title\":\"绿联车载充电器快充QC3.0一拖二双USB汽车24V通用型点烟器插头\",\"promotedService\":\"1\",\"auctionTag\":\"843 907 1163 1478 1483 2049 2059 3974 4166 4491 4939 5895 6603 7883 8326 11083 11339 13953 17739 20481 21505 25282 26561 28353 28802 30337 30401 30849 30977 31489 33217 34369 35713 36161 37569 37633 39233 39809 40897 47297 51841 51969 64129 65281 66241 67521 74369 74561 82306 101762 107842 112386 116546 140418 151362 166658 202434 57026 2507 51329 70401 7371 2635 4619 24385 15554 4811 18433 29889 1675 35137 2443 39681 8843 22145 30273 7947 1803 36417 4678 4614\",\"clickUrl\":\"\",\"zkType\":\"\",\"zkTime\":\"0\",\"promotions\":\"6629\",\"isInLimitPromotion\":\"false\",\"price\":\"89.00\",\"priceColor\":\"#000000\",\"priceWithRate\":\"59.00\",\"priceWap\":\"59.00\",\"priceShow\":{\"preText\":\"\",\"unit\":\"¥\",\"price\":\"59.00\"},\"isP4p\":\"false\",\"sameCount\":\"0\",\"similarCount\":\"0\"},{\"type\":\"fixed\",\"tItemType\":\"nt_auction\",\"quantity\":\"2023\",\"sold\":\"0\",\"item_id\":\"551393820610\",\"shipping\":\"0.00\",\"fastPostFee\":\"0.00\",\"ordinaryPostFee\":\"0.00\",\"auctionUrl\":\"http://a.m.taobao.com/i551393820610.htm?&sid=5f2d209e6680dc78fa1b9dd7ba26708f\",\"userId\":\"713464357\",\"userType\":\"1\",\"isB2c\":\"1\",\"nick\":\"绿联数码旗舰店\",\"pic_path\":\"http://g.search2.alicdn.com/img/bao/uploaded/i4/i4/TB1ppZYRXXXXXX4apXXXXXXXXXX_!!1-item_pic.gif_60x60.jpg\",\"rateSum\":\"19\",\"isCod\":\"0\",\"isprepay\":\"1\",\"title\":\"绿联cd口手机架多功能夹子卡扣式磁铁吸性汽车通用型导航车载支架\",\"promotedService\":\"1\",\"auctionTag\":\"587 843 907 1163 1478 1483 2049 2059 3974 4166 4491 4550 4939 5895 6603 7883 8326 11083 11339 13953 17739 20481 21505 25282 26561 28353 28802 30337 30401 30849 30977 31489 33217 34369 35713 36161 37569 37633 39233 39809 40897 47297 51841 51969 64129 65281 66241 67521 74369 74561 82306 101762 107842 112386 116546 119234 119298 140418 151362 166658 178754 57026 2507 51329 70401 139778 7371 2635 4619 24385 15554 4811 18433 29889 1675 35137 2443 39681 8843 22145 30273 7947 1803 36417 4678 4614\",\"clickUrl\":\"\",\"zkType\":\"\",\"zkTime\":\"0\",\"promotions\":\"7538\",\"isInLimitPromotion\":\"false\",\"price\":\"65.00\",\"priceColor\":\"#000000\",\"priceWithRate\":\"49.00\",\"priceWap\":\"49.00\",\"priceShow\":{\"preText\":\"\",\"unit\":\"¥\",\"price\":\"49.00\"},\"isP4p\":\"false\",\"sameCount\":\"0\",\"similarCount\":\"0\"}]}",
"ret_message": "",
"ret_code": 0,
"ret_id":131976659942533661
}}