item_search接口是淘宝开放平台提供的一种高级搜索功能,它允许开发者通过一系列参数来定制搜索条件,从而获取到符合用户需求的商品列表。相比于普通的搜索功能,item_search接口具有更加灵活和精细化的特点,能够更好地满足用户的个性化需求。
-
关键词(keyword):这是搜索的核心,你需要提供想要搜索的商品名称或相关描述。
-
页码(page):用于分页显示搜索结果,指定你想要获取哪一页的商品列表。
-
每页数量(pageSize):每页返回的商品数量,这可以帮助你控制每次请求返回的数据量。
-
排序(sort):可以按照商品的某些属性进行排序,如价格、销量、评价等。
-
价格范围(minPrice, maxPrice):你可以设置最低和最高价格,以过滤出价格在一定范围内的商品。
-
商家ID(sellerId):如果你只对某个特定商家的商品感兴趣,你可以通过商家ID来过滤结果。
-
商品分类ID(categoryId):你可以指定搜索某个特定分类下的商品。
-
过滤条件(filter):一些额外的过滤条件,比如只显示有货的商品、只显示包邮的商品等。
-
商品属性(props):根据商品的特定属性进行搜索,例如品牌、颜色、尺寸等。
调用 item_search_pro
接口时,通常还需要提供一些公共参数,比如你的API调用凭证(通常是App Key和App Secret,或者是Token),以及其他可能的认证信息。
公共参数
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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版本 |
请求参数
请求参数:q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=
参数说明:q:搜索关键字
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,bid2,_bid2,_sale,_credit]
(bid:总价,bid2:商品价格,sale:销量,credit信用,加_前缀为从大到小排序)
page:页数
loc=广州 发货地
filter:额外的过滤参数,
如:filter=mall,myf
【qqg 全球购,myf 包邮,tjb 淘金币抵钱,mall 天猫, xfzbz 消费者保障, jsfh 极速发货,hdfk 货到付款,qtth 7+天内退货,zsyfx 赠送运费险,tmwyg 天猫无忧购,gongyibb 公益宝贝,tmzs 天猫直送,taogongchang 淘工厂】
item_search_pro-高级关键字搜索淘宝商品 返回数据示例
{
"items": {
"page": "1",
"real_total_results": 2000,
"total_results": 2000,
"page_size": 30,
"pagecount": 30,
"_ddf": "ti",
"item": [
{
"title": "九年老店 超20种颜色女装打底裤女裤外穿加肥加大码200斤胖mm春秋冬",
"pic_url": "http://g.search.alicdn.com/img/i4/94896367/O1CN01mMHBnu1wu8NBHKJzH_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 99,
"promotion_price": "49.00",
"price": "49.00",
"sales": 3000,
"num_iid": "579693041808",
"seller_nick": "绒汇旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=579693041808"
},
{
"title": "出租赁晋制汉服女装2023新款爆款女古风流仙裙魏晋风古装女款",
"pic_url": "http://g.search2.alicdn.com/img/i2/957040004/O1CN01i0wBze1BtsOUZYOuH_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 59,
"promotion_price": "59.00",
"price": "59.00",
"sales": 0,
"num_iid": "690218282847",
"seller_nick": "仙泉服装租赁馆",
"detail_url": "https://item.taobao.com/item.htm?id=690218282847"
},
{
"title": "藏青色职业西装裤女秋季高腰显瘦直筒裤垂坠感质感上班通勤工装裤",
"pic_url": "http://g.search2.alicdn.com/img/i2/35100832/O1CN018ZIf571I16OIZ1msu_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 238,
"promotion_price": "118.00",
"price": "118.00",
"sales": 7,
"num_iid": "732426707052",
"seller_nick": "莱伦斯布正装店",
"detail_url": "https://item.taobao.com/item.htm?id=732426707052"
},
{
"title": "新中式小香风外套吊带连衣裙套装女2024春新款今年流行国风两件套",
"pic_url": "http://g.search1.alicdn.com/img/i1/646620178/O1CN01bK9boJ1DBZRH8Ur6H_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 249,
"promotion_price": 249,
"price": 249,
"sales": 0,
"num_iid": "775691071961",
"seller_nick": "茉诗恋服饰店",
"detail_url": "https://item.taobao.com/item.htm?id=775691071961"
},
{
"title": "法式通勤弹力修身短袖T恤女2024年夏季新款美式短打底上衣",
"pic_url": "http://g.search1.alicdn.com/img/i1/130974249/O1CN01ZiaWCv1hG5ovrNk64_!!130974249-0-alimamacc.jpg_sum.jpg",
"orginal_price": 139,
"promotion_price": "139.00",
"price": "139.00",
"sales": 33,
"num_iid": "768859515800",
"seller_nick": "茵曼旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=768859515800"
},
{
"title": "上海啄木鸟品牌店 新中式国风",
"pic_url": "http://g.search.alicdn.com/img/i4/56080931/O1CN012l4oIW1IkRfyksLHl_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 299,
"promotion_price": "128.00",
"price": "128.00",
"sales": 0,
"num_iid": "772865288165",
"seller_nick": "啄木鸟中老年女装直营店",
"detail_url": "https://item.taobao.com/item.htm?id=772865288165"
},
{
"title": "ohsunny防晒衣女护手宽松防紫外线透气连帽披肩衫开车云朵防晒服",
"pic_url": "http://g.search.alicdn.com/img/i4/125350421/O1CN01JtnX4G1EyrfitJDJR_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 358,
"promotion_price": "169.00",
"price": "169.00",
"sales": 5000,
"num_iid": "585047936982",
"seller_nick": "ohsunny官方旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=585047936982"
},
{
"title": "黑色裤子女垂感微喇裤2023年春季高腰喇叭裤",
"pic_url": "http://g.search2.alicdn.com/img/i2/12002291/O1CN01oZeycQ1SnKCZBQ3gM_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 268,
"promotion_price": "145.00",
"price": "145.00",
"sales": 36,
"num_iid": "698890410923",
"seller_nick": "思涵语女装馆",
"detail_url": "https://item.taobao.com/item.htm?id=698890410923"
},
{
"title": "半身裙a字裙夏季女裙职业短袖衬衫夏工作服",
"pic_url": "http://g.search.alicdn.com/img/i4/43595965/O1CN01B263sf1tw1MihJ3DZ_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 368,
"promotion_price": "188.00",
"price": "188.00",
"sales": 0,
"num_iid": "707927298259",
"seller_nick": "凤凰色旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=707927298259"
},
{
"title": "九年老店 2019秋新款真皮皮衣女装中长风衣大衣外",
"pic_url": "http://g.search1.alicdn.com/img/i1/96567868/O1CN010kNMgK27zb7LrPdgg_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 2980,
"promotion_price": "1570.00",
"price": "1570.00",
"sales": 7,
"num_iid": "606089349368",
"seller_nick": "雪领旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=606089349368"
},
{
"title": "少女连衣裙中学生牛仔裙大童夏装新款初中生裙子高中生学院风女装",
"pic_url": "http://g.search3.alicdn.com/img/i3/54368609/O1CN012BG9jB2DSyU99S42c_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 162,
"promotion_price": "138.00",
"price": "138.00",
"sales": 0,
"num_iid": "673298914168",
"seller_nick": "色彩旋律旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=673298914168"
},
{
"title": "七年老店 超20种颜色女装黑色打底裤女外穿春秋款魔术高腰长裤秋冬加绒",
"pic_url": "http://g.search2.alicdn.com/img/i2/116995032/O1CN01YNcbbO1n2hhbN11qA_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 199,
"promotion_price": "118.00",
"price": "118.00",
"sales": 400,
"num_iid": "630331778875",
"seller_nick": "衣而美服饰旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=630331778875"
},
{
"title": "AGOLDE女高腰直筒牛仔裤NAP/NET-A-PORTER颇特",
"pic_url": "http://g.search1.alicdn.com/img/i1/466810086/O1CN01nNHdXv1CVQzxiuV0b_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 1910,
"promotion_price": 1910,
"price": 1910,
"sales": 19,
"num_iid": "679896557900",
"seller_nick": "NET-A-PORTER官方旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=679896557900"
},
{
"title": "中学生连衣裙海军风初中生少女裙子2022年夏季新款夏装海军领白裙",
"pic_url": "http://g.search3.alicdn.com/img/i3/54368609/O1CN01qQSGVq2DSyU3hkc3f_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 186,
"promotion_price": "158.00",
"price": "158.00",
"sales": 0,
"num_iid": "672226468325",
"seller_nick": "色彩旋律旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=672226468325"
},
{
"title": "妈妈春装桑蚕丝T恤女洋气翻领打底小衫春秋新款中老年长袖上衣服",
"pic_url": "http://g.search2.alicdn.com/img/i2/117385612/O1CN01G5MQ4W1rKLe2MijXB_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 598,
"promotion_price": "398.00",
"price": "398.00",
"sales": 0,
"num_iid": "766651645953",
"seller_nick": "薇妃旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=766651645953"
},
{
"title": "2024春秋新款雪纺白衬衫女长袖洋气木耳边立领内搭加绒打底衬衣冬",
"pic_url": "http://g.search.alicdn.com/img/i4/30794123/O1CN01JjYXoQ1gKNuacwfWJ_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 688,
"promotion_price": "288.00",
"price": "288.00",
"sales": 9,
"num_iid": "770529299654",
"seller_nick": "lisa snidel轻奢女装",
"detail_url": "https://item.taobao.com/item.htm?id=770529299654"
},
{
"title": "紫色丝光棉新款修身OL衬衫女装长袖职业装通勤工作服酒店上班服装",
"pic_url": "http://g.search1.alicdn.com/img/i1/17395005/O1CN014HqKuL1mqKuPtqjFJ_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 103,
"promotion_price": "89.00",
"price": "89.00",
"sales": 0,
"num_iid": "565551946956",
"seller_nick": "中国制服研究院AmorJolie",
"detail_url": "https://item.taobao.com/item.htm?id=565551946956"
},
{
"title": "职业装白衬衫女V领中袖蓝色衬衣酒店服务员美容师银行工作服秋装",
"pic_url": "http://g.search3.alicdn.com/img/i3/17395005/O1CN01a5oZbm1mqL4TxAITH_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 108,
"promotion_price": 108,
"price": 108,
"sales": 1,
"num_iid": "552760677850",
"seller_nick": "中国制服研究院AmorJolie",
"detail_url": "https://item.taobao.com/item.htm?id=552760677850"
},
{
"title": "三彩小樱花独醒2024春夏季新款网纱T恤正肩长袖上衣修身女",
"pic_url": "http://g.search.alicdn.com/img/i4/28697709/O1CN01hiwYPR26omCvJeX6p_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 139,
"promotion_price": "138.00",
"price": "138.00",
"sales": 30000,
"num_iid": "763270476537",
"seller_nick": "三彩官方旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=763270476537"
},
{
"title": "12年老店 七种颜色中老年女装秋装针织开衫妈妈毛衣外套",
"pic_url": "http://g.search.alicdn.com/img/i4/30011042/O1CN01o6IMNc1JZHP2Bk72D_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 390,
"promotion_price": "105.00",
"price": "105.00",
"sales": 200,
"num_iid": "647180776182",
"seller_nick": "欧尹美服饰",
"detail_url": "https://item.taobao.com/item.htm?id=647180776182"
},
{
"title": "九年老店 女装春夏新款卡其色裤子女修身显瘦高腰九分西装裤薄款职业小脚休闲裤",
"pic_url": "http://g.search3.alicdn.com/img/i3/53443650/TB2fMwuiBmWBuNkSndVXXcsApXa_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 388,
"promotion_price": "128.00",
"price": "128.00",
"sales": 2,
"num_iid": "568214505595",
"seller_nick": "ZANA原创定制",
"detail_url": "https://item.taobao.com/item.htm?id=568214505595"
},
{
"title": "法式小香风短袖针织衫女2024年夏季新款通勤圆领薄款短款上衣",
"pic_url": "http://g.search3.alicdn.com/img/i3/130974249/O1CN01wzOIsq1hG5oni5UqN_!!130974249-0-alimamacc.jpg_sum.jpg",
"orginal_price": 269,
"promotion_price": "269.00",
"price": "269.00",
"sales": 39,
"num_iid": "768942997825",
"seller_nick": "茵曼旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=768942997825"
},
{
"title": "女装长裙大裙摆藏族服装女藏族舞蹈服演出服装长款套装半身裙藏式裙子",
"pic_url": "http://g.search1.alicdn.com/img/i1/31985586/O1CN01rYrEuI1r8RCBVn8z1_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 75,
"promotion_price": 75,
"price": 75,
"sales": 1,
"num_iid": "637794858863",
"seller_nick": "衣嘉衣商城",
"detail_url": "https://item.taobao.com/item.htm?id=637794858863"
},
{
"title": "浪莎无痕安全裤女夏天薄款防走光不卷边大码保险高腰冰丝打底短裤",
"pic_url": "http://g.search.alicdn.com/img/i4/14442770/O1CN01VyvcLW1WKhpzqX5ke_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 39,
"promotion_price": "19.90",
"price": "19.90",
"sales": 500,
"num_iid": "644447297146",
"seller_nick": "浪莎官方旗舰店",
"detail_url": "https://item.taobao.com/item.htm?id=644447297146"
},
{
"title": "寺山文也 穆远/30姆米真丝重绉V领七分袖2024春西装裙套装外套女",
"pic_url": "http://g.search3.alicdn.com/img/i3/11770941/O1CN01fOOe151Ip1d0dtjcj_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 1499,
"promotion_price": 1499,
"price": 1499,
"sales": 0,
"num_iid": "764662395717",
"seller_nick": "寺山文也",
"detail_url": "https://item.taobao.com/item.htm?id=764662395717"
},
{
"title": "高级感红色真丝雪纺衬衫女长袖衬衣春秋新款时尚洋气打底职业装",
"pic_url": "http://g.search.alicdn.com/img/i4/30794123/O1CN01E8DQdx1gKNublIjaM_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 688,
"promotion_price": "328.00",
"price": "328.00",
"sales": 6,
"num_iid": "770457228922",
"seller_nick": "lisa snidel轻奢女装",
"detail_url": "https://item.taobao.com/item.htm?id=770457228922"
},
{
"title": "新中式套装女春秋2024新款爆款高级感复古刺绣轻奢洋气唐装两件套",
"pic_url": "http://g.search3.alicdn.com/img/i3/646620178/O1CN01ol8UvI1DBZRAXKGzW_!!0-saturn_solar.jpg_sum.jpg",
"orginal_price": 218,
"promotion_price": 218,
"price": 218,
"sales": 0,
"num_iid": "774811446892",
"seller_nick": "茉诗恋服饰店",
"detail_url": "https://item.taobao.com/item.htm?id=774811446892"
},
{
"title": "2024春装新款黑色蝴蝶结雪纺垂感衬衫女气质灯笼袖通勤OL长袖上衣",
"pic_url": "http://g.search1.alicdn.com/img/i1/700756447/O1CN01Q5colN1xUmMrPZT97_!!700756447-0-alimamacc.jpg_sum.jpg",
"orginal_price": 148,
"promotion_price": "148.00",
"price": "148.00",
"sales": 0,
"num_iid": "771766253687",
"seller_nick": "MCA SUAL品质实穿",
"detail_url": "https://item.taobao.com/item.htm?id=771766253687"
},