万邦淘宝/天猫按关键字搜索淘宝商品 API 返回值说明
item_search-按关键字搜索淘宝商品
onebound.taobao.item_search
请求地址: console.open.onebound.cn/console/?i=…
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,bid2,_bid2,_sale,_credit]
(bid:总价,bid2:商品价格,sale:销量,credit信用,加_前缀为从大到小排序)
page:页数\
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| title | String | 0 | 法式复古山本超仙chic仙女赫本网红初春很仙法国小众裙子两件套装 | 商品标题 |
| pic_url | String | 0 | //img.alicdn.com/bao/uploaded/i3/3083218865/O1CN012FMDaiwxkenJGaM_!!0-item_pic.jpg | 宝贝图片 |
| promotion_price | Float | 0 | 178.00 | 优惠价 |
| price | Float | 0 | 178.00 | 价格 |
| sales | Int | 0 | 890 | 销量 |
| num_iid | Bigint | 0 | 577437133060 | 宝贝ID |
| sample_id | String | 0 | 商品风格标识ID | |
| seller_nick | String | 0 | 初穆旗舰店 | 掌柜昵称 |
| post_fee | Float | 0 | 10.00 | 物流费用 |
| area | String | 0 | 山东 | 店铺所在地 |
| detail_url | String | 0 | //detail.tmall.com/item.htm?id=586794298909&ns=1&abbucket=0 | 宝贝链接 |
| seller_info | Mix | 0 | {"level": 99, "shop_type": "B", "user_num_id": "2217148345", "cid": 0, "delivery_score": "", "item_score": "", "score_p": ""} | 卖家信息 |
- [Curl]
- [PHP]
- [PHPsdk]
- [JAVA]
- [C#]
- [Python]
-- 请求示例 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="
获取key和secret
Result Object:
{ "items": { "page": "1", "real_total_results": 1000, "total_results": 1000, "page_size": 40, "pagecount": 50, "data_from": "hid", "item": [ { "title": "优衣库 女装 棉质T恤(长袖) 430273 UNIQLO", "pic_url": "img.alicdn.com/imgextra/i1…", "promotion_price": "79.00", "price": "79.00", "sales": 0, "num_iid": "627543382638", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 04:05:29" }, { "title": "Data Zara新款 女装 垂褶直筒裙 08000878800", "pic_url": "//img.alicdn.com/imgextra/i1/2209090117041/O1CN01psHm3u21spO3HTo4R_!!2209090117041.jpg", "promotion_price": "179.00", "price": "299.00", "sales": 22, "num_iid": "649663627852", "seller_nick": "雨雨宝代购", "seller_id": "2209090117041", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-16 12:45:43" }, { "title": "Data Zara早秋新款 女装 黑色纹理西装外套 08542182800", "pic_url": "//img.alicdn.com/imgextra/i3/2209090117041/O1CN01lEcwMt21spP1byqA5_!!2209090117041.jpg", "promotion_price": "199.00", "price": "499.00", "sales": 5, "num_iid": "654806505193", "seller_nick": "雨雨宝代购", "seller_id": "2209090117041", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-16 12:49:30" }, { "title": "Data Zara早秋新款 TRF 女装 阔腿牛仔裤 06688224800", "pic_url": "//img.alicdn.com/imgextra/i3/2209090117041/O1CN01IAqDBX21spOmbq1p6_!!2209090117041.jpg", "promotion_price": "189.00", "price": "299.00", "sales": 13, "num_iid": "653090373325", "seller_nick": "雨雨宝代购", "seller_id": "2209090117041", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-16 12:56:19" }, { "title": "Data Zara早秋新款 女装 带垫肩修身西装外套 08526707706", "pic_url": "//img.alicdn.com/imgextra/i4/2209090117041/O1CN01B7oCY521spP2QRdwS_!!2209090117041.jpg", "promotion_price": "189.00", "price": "699.00", "sales": 2, "num_iid": "655250722892", "seller_nick": "雨雨宝代购", "seller_id": "2209090117041", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-16 12:58:46" }, { "title": "【返场可用券】女装 乔其纱荷叶边领衬衫(优衣库云朵衫)429418", "pic_url": "img.alicdn.com/imgextra/i1…", "promotion_price": "99.00", "price": "99.00", "sales": 0, "num_iid": "630637243596", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "ez", "data_update": "2021-10-26 01:29:59" }, { "title": "女装 法兰绒松紧长裤 419869 优衣库UNIQLO", "pic_url": "img.alicdn.com/imgextra/i1…", "promotion_price": "79.00", "price": "79.00", "sales": 0, "num_iid": "603915062201", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-17 03:34:41" }, { "title": "优衣库 女装/情侣装 便携式防紫外线连帽外套(防晒衣) 419912", "pic_url": "img.alicdn.com/imgextra/i1…", "promotion_price": "99.00", "price": "99.00", "sales": 0, "num_iid": "594452029554", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-17 06:55:43" }, { "title": "KASLEAD 新款 女装 欧美风圆领拼接长袖针织衫上衣 04331116330", "pic_url": "gw.alicdn.com/imgextra/O1…", "promotion_price": "59.00", "price": "59.00", "sales": 0, "num_iid": "652238928321", "seller_nick": "mdxiaozhi", "seller_id": "704346103", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-25 20:59:16" }, { "title": "优衣库 男装/女装 折叠伞 420562 UNIQLO", "pic_url": "img.alicdn.com/imgextra/i3…", "promotion_price": "79.00", "price": "79.00", "sales": 200, "num_iid": "595863242238", "seller_nick": null, "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-19 19:14:20" }, { "title": "KASLEAD 新款 女装 欧美风叠层装饰质感格子衬衫上衣 05216051712", "pic_url": "img.alicdn.com/imgextra/i2…", "promotion_price": "49.00", "price": "49.00", "sales": 0, "num_iid": "640754369310", "seller_nick": "mdxiaozhi", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-17 14:20:24" }, { "title": "优衣库 女装 法国麻衬衫(长袖) 424658 UNIQLO", "pic_url": "img.alicdn.com/imgextra/i1…", "promotion_price": "99.00", "price": "99.00", "sales": 0, "num_iid": "622660418741", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-17 16:48:44" }, { "title": "ZARA 新款 女装 提花修身通勤西装外套 08474464733", "pic_url": "img.alicdn.com/imgextra/i3…", "promotion_price": "499.00", "price": "499.00", "sales": 0, "num_iid": "653812517886", "seller_nick": "zara官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "ez", "data_update": "2021-12-02 23:35:01" }, { "title": "【漫囧】鬼灭之刃 灶门祢豆子 圣诞 睡衣 女装 cos服装 现货", "pic_url": "gw.alicdn.com/imgextra/O1…", "promotion_price": "88.00", "price": "176.00", "sales": 0, "num_iid": "607612962557", "seller_nick": "漫囧旗舰店", "seller_id": "2940718379", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-25 19:04:29" }, { "title": "ZARA 新款 TRF 女装 丝缎质感印花连衣裙 08342310800", "pic_url": "img.alicdn.com/imgextra/i4…", "promotion_price": "259.00", "price": "259.00", "sales": 0, "num_iid": "652476230338", "seller_nick": "zara官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "ez", "data_update": "2021-11-16 21:18:07" }, { "title": "优衣库 女装 法兰绒格子半开领上衣(长袖) 421610 UNIQLO", "pic_url": "img.alicdn.com/imgextra/i4…", "promotion_price": "59.00", "price": "59.00", "sales": 0, "num_iid": "608838018646", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-17 19:41:06" }, { "title": "优衣库 女装 罗纹圆领T恤(短袖) 430872 UNIQLO", "pic_url": "img.alicdn.com/imgextra/i1…", "promotion_price": "79.00", "price": "79.00", "sales": 0, "num_iid": "624874625258", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "ez", "data_update": "2021-11-02 02:41:32" }, { "title": "KASLEAD 新款 女装 欧美风刺绣性感露背吊带连体裤 07200221406", "pic_url": "//img.alicdn.com/imgextra/i2/704346103/O1CN01XThtdf1uxDsR7e283_!!704346103.jpg", "promotion_price": "59.00", "price": "59.00", "sales": 0, "num_iid": "648195301543", "seller_nick": "凯诗兰迪欧美女装", "seller_id": "704346103", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-01-06 22:59:32" }, { "title": "KASLEAD 新款 女装 欧美风宽松条纹府绸衬衫休闲短裤 03510023060", "pic_url": "//img.alicdn.com/imgextra/i3/704346103/O1CN01lUKJAp1uxDshfacGw_!!704346103.jpg", "promotion_price": "39.00", "price": "39.00", "sales": 140000, "num_iid": "651088595653", "seller_nick": "mdxiaozhi", "seller_id": "704346103", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "xdl", "data_update": "2022-08-01 14:49:00" }, { "title": "KASLEAD 新款 女装 欧美风扎染短上衣印花休闲短裤 03564077046", "pic_url": "//img.alicdn.com/imgextra/i4/704346103/O1CN01a6aJfJ1uxDrXP3bvb_!!704346103.jpg", "promotion_price": "34.00", "price": "34.00", "sales": 180000, "num_iid": "641748672221", "seller_nick": "mdxiaozhi", "seller_id": "704346103", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "xdl", "data_update": "2022-07-02 20:01:01" }, { "title": "优衣库 女装 高腰宽腿长裤 425341 UNIQLO", "pic_url": "img.alicdn.com/imgextra/i3…", "promotion_price": "79.00", "price": "79.00", "sales": 0, "num_iid": "616591228867", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-17 22:57:39" }, { "title": "KASLEAD 新款 女装 欧美风洋气v领镂空花边针织马甲背心马夹外套", "pic_url": "//img.alicdn.com/imgextra/i4/704346103/O1CN01G5elHv1uxDqkYWBGJ_!!704346103.jpg", "promotion_price": "32.00", "price": "32.00", "sales": 1, "num_iid": "638301796004", "seller_nick": "mdxiaozhi", "seller_id": "704346103", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "jcs", "data_update": "2021-12-03 23:38:39" }, { "title": "犬夜叉 桔梗 巫女服 和服 cosplay服装 全套 动漫 衣服 女装 假发", "pic_url": "gw.alicdn.com/imgextra/TB…", "promotion_price": "83.00", "price": "98.00", "sales": 0, "num_iid": "522756317480", "seller_nick": "筷子闯马头", "seller_id": "2644559082", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-31 18:38:34" }, { "title": "优衣库聪明裤 女装 弹力九分裤 (通勤 西装裤) 445296/439247", "pic_url": "//img.alicdn.com/imgextra/i1/196993935/O1CN01zWL4131ewHHaZZ3M2_!!0-item_pic.jpg", "promotion_price": "249.00", "price": "249.00", "sales": 120280000, "num_iid": "632021377346", "seller_nick": "优衣库官方旗舰店", "seller_id": "196993935", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "xdl", "data_update": "2022-08-01 17:28:17" }, { "title": "优衣库 女装 EZY弹力九分裤 425344 UNIQLO", "pic_url": "img.alicdn.com/imgextra/i4…", "promotion_price": "79.00", "price": "79.00", "sales": 0, "num_iid": "610194012059", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-19 18:12:26" }, { "title": "ZARA 冬季新款 女装 仿皮短连衣裙 02969313717", "pic_url": "//img.alicdn.com/imgextra/i3/2228361831/O1CN0180zndx1POdv2c39Ka_!!2228361831.jpg", "promotion_price": "399.00", "price": "399.00", "sales": 2, "num_iid": "658170840643", "seller_nick": "zara官方旗舰店", "seller_id": "2228361831", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "jcs", "data_update": "2021-11-27 18:55:09" }, { "title": "ZARA新款 TRF 女装 中腰及踝喇叭牛仔裤 03643012800", "pic_url": "img.alicdn.com/imgextra/i1…", "promotion_price": "199.00", "price": "199.00", "sales": 0, "num_iid": "586777007872", "seller_nick": "zara官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "ez", "data_update": "2021-11-04 03:09:58" }, { "title": "优衣库 女装 弹力裙(半身裙通勤职业) 439263 UNIQLO", "pic_url": "gw.alicdn.com/imgextra/O1…", "promotion_price": "199.00", "price": "199.00", "sales": 850000, "num_iid": "644929660920", "seller_nick": "优衣库官方旗舰店", "seller_id": "196993935", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-29 23:07:13" }, { "title": "【SEN】BJD/SD/DD娃娃/娃衣/女装/COS/SABER/日常服/睡衣/泳装", "pic_url": "gw.alicdn.com/imgextra/T1…", "promotion_price": "48.00", "price": "48.00", "sales": 0, "num_iid": "35148932222", "seller_nick": "月下西桥", "seller_id": "69023553", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-08-01 00:19:50" }, { "title": "【设计师合作款】女装 牛仔休闲短裤(水洗产品) 425864 优衣库", "pic_url": "img.alicdn.com/imgextra/i2…", "promotion_price": "199.00", "price": "199.00", "sales": 0, "num_iid": "611042720840", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "ez", "data_update": "2021-10-29 13:02:12" }, { "title": "ZARA 新款 TRF 女装 仿皮短裤 07901291706", "pic_url": "img.alicdn.com/imgextra/i4…", "promotion_price": "199.00", "price": "199.00", "sales": 0, "num_iid": "630202744993", "seller_nick": "zara官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 14:33:45" }, { "title": "ZARA 秋季新款 女装 不对称披肩针织衫 06873108712", "pic_url": "img.alicdn.com/imgextra/i4…", "promotion_price": "399.00", "price": "399.00", "sales": 0, "num_iid": "655218679409", "seller_nick": "zara官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 14:41:44" }, { "title": "女装 全棉休闲T恤(法式袖) 424867 优衣库UNIQLO", "pic_url": "img.alicdn.com/imgextra/i3…", "promotion_price": "79.00", "price": "79.00", "sales": 0, "num_iid": "616426236737", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 15:19:47" }, { "title": "优衣库 男装/女装/情侣装 可机洗宽松V领背心 443918/439928", "pic_url": "img.alicdn.com/bao/uploade…", "promotion_price": "149.00", "price": "149.00", "sales": 2000, "num_iid": "655292337972", "seller_nick": "", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 20:57:15" }, { "title": "ZARA 秋季新款 女装 条纹针织衫 06254106104", "pic_url": "img.alicdn.com/imgextra/i3…", "promotion_price": "299.00", "price": "299.00", "sales": 0, "num_iid": "655991127748", "seller_nick": null, "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 15:29:01" }, { "title": "优衣库 女装 羊毛混纺双面呢大衣 432068 UNIQLO", "pic_url": "img.alicdn.com/imgextra/i1…", "promotion_price": "899.00", "price": "899.00", "sales": 0, "num_iid": "624226446897", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 15:57:03" }, { "title": "ZARA 新款 女装 粗横棱纹织物裙子 04886458800", "pic_url": "img.alicdn.com/imgextra/i3…", "promotion_price": "159.00", "price": "159.00", "sales": 0, "num_iid": "628539236611", "seller_nick": "zara官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 15:58:15" }, { "title": "1G4K201高端冬装 女装 双面穿 豹纹羽绒服吊牌5390", "pic_url": "gw.alicdn.com/imgextra/O1…", "promotion_price": "1900.00", "price": "1900.00", "sales": 0, "num_iid": "602752455766", "seller_nick": "杨家儒帅", "seller_id": "36778421", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "Ha", "data_update": "2022-07-25 18:57:14" }, { "title": "KASLEAD 新款 女装 欧美风腰带配饰高腰裤多色 08412691300", "pic_url": "//img.alicdn.com/imgextra/i1/704346103/O1CN0173Ye691uxDhh4pang_!!704346103.jpg", "promotion_price": "59.00", "price": "59.00", "sales": 1560000, "num_iid": "591566263894", "seller_nick": "mdxiaozhi", "seller_id": "704346103", "detail_url": "item.taobao.com/item.htm?id…", "data_f": "xdl", "data_update": "2022-08-01 17:29:36" }, { "title": "优衣库 女装 高弹力运动短裤 422814 UNIQLO", "pic_url": "img.alicdn.com/imgextra/i2…", "promotion_price": "59.00", "price": "59.00", "sales": 0, "num_iid": "611580730319", "seller_nick": "优衣库官方旗舰店", "seller_id": "0", "detail_url": "item.taobao.com/item.htm?id…", "data_f": null, "data_update": "2021-10-18 17:53:11" } ], "item_weight_update": 0 }, "error_code": "0000", "reason": "ok", "secache": "a8881ed5637e3c7e84f03acdc86be64f", "secache_time": 1659408588, "secache_date": "2022-08-02 10:49:48", "translate_status": "", "translate_time": 0, "language": { "default_lang": "cn", "current_lang": "cn" }, "error": "", "cache": 0, "api_info": "today:65 max:10100 all[113=65+30+18];expires:2030-12-31", "execution_time": "0.308", "server_time": "Beijing/2022-08-02 10:49:48", "client_ip": "106.6.35.126", "call_args": { "q": "女装", "start_price": "0", "end_price": "0", "page": "1", "cat": "0" }, "api_type": "taobao", "translate_language": "zh-CN", "translate_engine": "google_new", "server_memory": "5.93MB", "request_id": "gw-1.62e890cbf33b7", "last_id": "1122450389" }
