淘宝商品采集|通过关键字搜索商品列表API调用演示
item_search-按关键字搜索淘宝商品
taobao.item_search
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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:搜索关键字
page:页数【最大翻页100页】
响应参数
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| items | items[] | 0 | 按关键字搜索淘宝商品 | |
| page | Int | 0 | 1 | 页码 |
| real_total_results | Int | 0 | 360000 | 商品数量 |
| total_results | Int | 0 | 360000 | 商品数量 |
| page_size | Int | 0 | 10 | 接口返回数量 |
| pagecount | Int | 0 | 200 | 总页数 |
| item | item[] | 0 | 商品详情数据 | |
| title | String | 0 | 高腰百搭羊羔绒阔腿裤冬季保暖 | 商品标题 |
| pic_url | String | 0 | https://img.alicdn.com/img/bao/uploaded/i4/O1CN01TpegE82EAUGWQD2JI_!!0-item_pic.jpg | 商品图片 |
| orginal_price | Float | 0 | 50.00 | 原价 |
| price | Float | 0 | 50.00 | 价格 |
| num_iid | Bigint | 0 | 756775095301 | 商品ID |
| detail_url | String | 0 | https://item.taobao.com/item.htm?id=756775095301 | 商品链接 |
请求示例
请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter="
响应示例
"items": {
"page": "1",
"real_total_results": 20000,
"total_results": 20000,
"page_size": 20,
"pagecount": 1000,
"_ddf": "zzz",
"item": [
{
"title": "灰色毛呢辣妹短裤女冬季2025新款小个子加厚高腰a字外穿打底靴裤",
"pic_url": "https://img.alicdn.com/imgextra/i3/2132122429/O1CN01SOVZkw1ToX9Wbk8Ye_!!4611686018427386685-0-item_pic.jpg",
"promotion_price": 51,
"orginal_price": 51,
"price": 51,
"num_iid": 1003090302743,
"detail_url": "https://item.taobao.com/item.htm?id=1003090302743"
},
{
"title": "德绒打底衫女内搭带胸垫秋冬季2025新款长袖T恤高级感修身u领上衣",
"pic_url": "https://img.alicdn.com/imgextra/i2/2132122429/O1CN01Z4UqIe1ToX8r9YQcx_!!4611686018427386685-0-item_pic.jpg",
"promotion_price": 50.48,
"orginal_price": 50.48,
"price": 50.48,
"num_iid": 996458732569,
"detail_url": "https://item.taobao.com/item.htm?id=996458732569"
},
{
"title": "清仓捡漏~高档特价女装2025春季新款减龄长袖圆领T恤女上衣潮",
"pic_url": "https://img.alicdn.com/imgextra/i4/2214801260681/O1CN017xIy8a1Gtwkxa9Gfc_!!2214801260681.jpg",
"promotion_price": 20.14,
"orginal_price": 20.14,
"price": 20.14,
"num_iid": 891318151086,
"detail_url": "https://item.taobao.com/item.htm?id=891318151086"
},
{
"title": "2025新款假两件微喇叭瑜伽裤女外穿大码胖mm高腰运动健身阔腿裤子",
"pic_url": "https://img.alicdn.com/imgextra/i1/2212460140680/O1CN01GwN13M1GtUPt5IUyU_!!4611686018427385992-0-item_pic.jpg",
"promotion_price": 36.7,
"orginal_price": 36.7,
"price": 36.7,
"num_iid": 888051887858,
"detail_url": "https://item.taobao.com/item.htm?id=888051887858"
},
{
"title": "鲨鱼打底裤女外穿春秋夏高腰2025新款提臀瑜伽冬季加绒紧身收腹裤",
"pic_url": "https://img.alicdn.com/imgextra/i1/3250699660/O1CN01YXRiie2LEKvXIhxFn_!!2-item_pic.png",
"promotion_price": 20.59,
"orginal_price": 20.59,
"price": 20.59,
"num_iid": 704681795040,
"detail_url": "https://item.taobao.com/item.htm?id=704681795040"
},
{
"title": "保暖内衣加肥加大码200斤胖mm加绒加厚打底衫女秋冬装长袖t恤上衣",
"pic_url": "https://img.alicdn.com/imgextra/i3/1037060798/O1CN01W26AGV1HlWqJSUX4y_!!1037060798.jpg",
"promotion_price": 9.27,
"orginal_price": 9.27,
"price": 9.27,
"num_iid": 685805253978,
"detail_url": "https://item.taobao.com/item.htm?id=685805253978"
},
{
"title": "小个子慵懒风秋冬季德绒百搭圆领法式长袖双面保暖T恤内搭上衣女",
"pic_url": "https://img.alicdn.com/imgextra/i3/2209765792113/O1CN01AVlyuG1RTnyQuiaQh_!!4611686018427386225-0-item_pic.jpg",
"promotion_price": 22.17,
"orginal_price": 22.17,
"price": 22.17,
"num_iid": 971694920659,
"detail_url": "https://item.taobao.com/item.htm?id=971694920659"
},
{
"title": "半高领打底衫女秋冬新款洋气高级感德绒内搭小众显瘦百搭上衣ins",
"pic_url": "https://img.alicdn.com/imgextra/i2/2206427357525/O1CN012mn7iK25SVUFjzBXW_!!4611686018427380053-0-item_pic.jpg",
"promotion_price": 11.09,
"orginal_price": 11.09,
"price": 11.09,
"num_iid": 979416426141,
"detail_url": "https://item.taobao.com/item.htm?id=979416426141"
},
{
"title": "2025新款夏季大码t恤女短袖大码女装显瘦中长款宽松韩版印花上衣",
"pic_url": "https://img.alicdn.com/imgextra/i2/4008314555/O1CN014237lw1jWEmSOdHvw_!!0-item_pic.jpg",
"promotion_price": 10.04,
"orginal_price": 10.04,
"price": 10.04,
"num_iid": 653756974542,
"detail_url": "https://item.taobao.com/item.htm?id=653756974542"
},
{
"title": "长袖t恤女胖MM打底衫女春秋新款百搭上衣韩版宽松大码圆领体恤潮",
"pic_url": "https://img.alicdn.com/imgextra/i3/2152102923/O1CN01dzUM9Z1XSmTQI0pgc_!!2152102923.jpg",
"promotion_price": 20.52,
"orginal_price": 20.52,
"price": 20.52,
"num_iid": 681210435214,
"detail_url": "https://item.taobao.com/item.htm?id=681210435214"
},
{
"title": "秋冬季圆领卫衣女士加绒加厚长袖洋气保暖打底衫大码宽松显瘦上衣",
"pic_url": "https://img.alicdn.com/imgextra/i1/2211437257311/O1CN01nZ8wOE23sUVbr4yrx_!!0-item_pic.jpg",
"promotion_price": 35.53,
"orginal_price": 35.53,
"price": 35.53,
"num_iid": 737604915477,
"detail_url": "https://item.taobao.com/item.htm?id=737604915477"
},
{
"title": "运动短裙女遮臀防走光大码胖mm一片式网球裙休闲跑步健身瑜伽屁帘",
"pic_url": "https://img.alicdn.com/imgextra/i3/2212460140680/O1CN01Gf7rEw1GtUM3ji3I0_!!4611686018427385992-0-item_pic.jpg",
"promotion_price": 20.69,
"orginal_price": 20.69,
"price": 20.69,
"num_iid": 884832460136,
"detail_url": "https://item.taobao.com/item.htm?id=884832460136"
},
{
"title": "尾货捡漏品牌折扣撤柜长袖t恤女秋冬保暖内衣韩版修身内搭打底衫",
"pic_url": "https://img.alicdn.com/imgextra/i1/2209085805227/O1CN01dvDV9r1oU1ED2Pypn_!!2209085805227.jpg",
"promotion_price": 5.67,
"orginal_price": 5.67,
"price": 5.67,
"num_iid": 836999945732,
"detail_url": "https://item.taobao.com/item.htm?id=836999945732"
},
{
"title": "搭配卫衣女小白色遮胯半身裙叠穿内搭打底神器屁帘下摆春秋遮屁股",
"pic_url": "https://img.alicdn.com/imgextra/i3/765416588/O1CN01jVHxd61yXMNRTHJSU_!!4611686018427384972-0-item_pic.jpg",
"promotion_price": 9.81,
"orginal_price": 9.81,
"price": 9.81,
"num_iid": 984188029857,
"detail_url": "https://item.taobao.com/item.htm?id=984188029857"
},
{
"title": "双面德绒圆领打底衫女内搭秋冬2025新款加绒加厚大码外穿长袖上衣",
"pic_url": "https://img.alicdn.com/imgextra/i4/2207502479311/O1CN01N52YP42IeUlOctrV3_!!0-item_pic.jpg",
"promotion_price": 20.32,
"orginal_price": 20.32,
"price": 20.32,
"num_iid": 840620300617,
"detail_url": "https://item.taobao.com/item.htm?id=840620300617"
},
{
"title": "雪尼尔加绒裤子秋冬新款休闲裤女松紧腰保暖哈伦裤纯色灯芯绒女裤",
"pic_url": "https://img.alicdn.com/imgextra/i3/1595357345/O1CN01asdyas24845zgwk5c_!!1595357345.jpg",
"promotion_price": 24.49,
"orginal_price": 24.49,
"price": 24.49,
"num_iid": 986128686020,
"detail_url": "https://item.taobao.com/item.htm?id=986128686020"
},
{
"title": "单/两件装 莫代尔圆领内搭打底衫女秋冬季修身长袖t恤女士上衣服",
"pic_url": "https://img.alicdn.com/imgextra/i1/3166214572/O1CN01661XFw1je1psjVswr_!!3166214572.jpg",
"promotion_price": 7.12,
"orginal_price": 7.12,
"price": 7.12,
"num_iid": 867646989878,
"detail_url": "https://item.taobao.com/item.htm?id=867646989878"
},
{
"title": "单/两件装 大码女装200斤胖mm宽松t恤女秋冬洋气德绒保暖打底衫女",
"pic_url": "https://img.alicdn.com/imgextra/i4/2231620737/O1CN01ibJFkl1HJauEgUwqq_!!2231620737.jpg",
"promotion_price": 26.48,
"orginal_price": 26.48,
"price": 26.48,
"num_iid": 848942161230,
"detail_url": "https://item.taobao.com/item.htm?id=848942161230"
},
{
"title": "半高领一体绒打底衫女内搭秋冬新款加绒加厚毛衣洋气木耳边针织衫",
"pic_url": "https://img.alicdn.com/imgextra/i2/2819176993/O1CN01MXrmVR21WqYEdS8WH_!!2819176993.jpg",
"promotion_price": 37.94,
"orginal_price": 37.94,
"price": 37.94,
"num_iid": 731556371612,
"detail_url": "https://item.taobao.com/item.htm?id=731556371612"
},
{
"title": "韩系套装女秋冬季加绒2025新款条纹上衣宽松显瘦阔腿裤小个子女装",
"pic_url": "https://img.alicdn.com/imgextra/i4/1822900680/O1CN01KSuXZ71GtUQMxgXML_!!1822900680.jpg",
"promotion_price": 40.93,
"orginal_price": 40.93,
"price": 40.93,
"num_iid": 988616154479,
"detail_url": "https://item.taobao.com/item.htm?id=988616154479"
}
],
"item_weight_update": 0
},
